Notable Changes
Experimental Network Inspection Support in Node.js
This update introduces the initial support for network inspection in Node.js.
Currently, this is an experimental feature, so you need to enable it using the --experimental-network-inspection
flag.
With this feature enabled, you can inspect network activities occurring within a JavaScript application.
To use network inspection, start your Node.js application with the following command:
$ node --inspect-wait --experimental-network-inspection index.js
Please note that the network inspection capabilities are in active development. We are actively working on enhancing this feature and will continue to expand its functionality in future updates.
- Network inspection is limited to the
http
andhttps
modules only. - The Network tab in Chrome DevTools will not be available until the feature request on the Chrome DevTools side...
New API to retrieve execution Stack Trace
A new API getCallSite
has been introduced to the util
module. This API allows users
to retrieve the stacktrace of the current execution. Example:
const util = require('node:util');
function exampleFunction() {
const callSites = util.getCallSite();
console.log('Call Sites:');
callSites.forEach((callSite, index) => {
console.log(`CallSite ${index + 1}:`);
console.log(`Function Name: ${callSite.functionName}`);
console.log(`Script Name: ${callSite.scriptName}`);
console.log(`Line Number: ${callSite.lineNumber}`);
console.log(`Column Number: ${callSite.column}`);
});
// CallSite 1:
// Function Name: exampleFunction
// Script Name: /home/example.js
// Line Number: 5
// Column Number: 26
// CallSite 2:
// Function Name: anotherFunction
// Script Name: /home/example.js
// Line Number: 22
// Column Number: 3
// ...
}
// A function to simulate another stack layer
function anotherF...
New JS API for compile cache
This release adds a new API module.enableCompileCache()
that can be used to enable on-disk code caching of all modules loaded after this API is called.
Previously this could only be enabled by the NODE_COMPILE_CACHE
environment variable, so it could only set by end-users.
This API allows tooling and library authors to enable caching of their own code.
This is a built-in alternative to the v8-compile-cache/v8-compile-cache-lib packages,
but have better performance and supports ESM.
Thanks to Joyee Cheung for working on this.
New option for vm.createContext() to create a context with a freezable globalThis
Node.js implements a flavor of vm.createContext()
and friends that creates a context without contextifying its global
object when vm.constants.DONT_CONTEXTIFY is...
Experimental transform types support
With the new flag --experimental-transform-types
it is possible to enable the
transformation of TypeScript-only syntax into JavaScript code.
This feature allows Node.js to support TypeScript syntax such as Enum
and namespace
.
Thanks to Marco Ippolito for making this work on #54283.
Module syntax detection is now enabled by default.
Module syntax detection (the --experimental-detect-module
flag) is now
enabled by default. Use --no-experimental-detect-module
to disable it if
needed.
Syntax detection attempts to run ambiguous files as CommonJS, and if the module
fails to parse as CommonJS due to ES module syntax, Node.js tries again and runs
the file as an ES module.
Ambiguous files are those with a .js
or no extension, where the nearest parent
package.json
has no "type"
field (either "type": "module"
or
"type": "commonjs"
).
Syntax detection should have no performance imp...
module: support require()ing synchronous ESM graphs
This release adds require()
support for synchronous ESM graphs under
the flag --experimental-require-module
.
If --experimental-require-module
is enabled, and the ECMAScript
module being loaded by require()
meets the following requirements:
- Explicitly marked as an ES module with a "type": "module" field in the closest package.json or a .mjs extension.
- Fully synchronous (contains no top-level await).
require()
will load the requested module as an ES Module, and return
the module name space object. In this case it is similar to dynamic
import()
but is run synchronously and returns the name space object
directly.
Contributed by Joyee Cheung in #51977
path: add matchesGlob
method
Glob patterns can now be tested against individual paths via the path.matchesGlob(path, pattern)
method.
Contributed by Aviv Keller in [#52881](https://github.co...
Experimental TypeScript support via strip types
Node.js introduces the --experimental-strip-types
flag for initial TypeScript support.
This feature strips type annotations from .ts files, allowing them to run
without transforming TypeScript-specific syntax. Current limitations include:
- Supports only inline type annotations, not features like
enums
ornamespaces
. - Requires explicit file extensions in import and require statements.
- Enforces the use of the type keyword for type imports to avoid runtime errors.
- Disabled for TypeScript in node_modules by default.
Thanks Marco Ippolito for working on this.
Experimental Network Inspection Support in Node.js
This update introduces the initial support for network inspection in Node.js.
Currently, this is an experimental feature, so you need to enable it using the --experimental-network-inspection
flag.
With this feature enabled, you can inspect network activiti...