{
"nodejsCommit": "ab476eccd03",
"sources": [
"doc/api/typescript.md",
"doc/api/module.md",
"doc/api/modules.md",
"doc/api/esm.md",
"doc/api/packages.md",
"doc/api/cli.md",
"doc/api/errors.md",
"doc/api/globals.md",
"doc/api/deprecations.md"
],
"floor": "v24.0.0",
"stability": "2 - Stable (type stripping, require(esm), compile cache, --config-file); 1.2 - Release candidate (module.registerHooks, Wasm source phase); 1 - Experimental (package maps, --experimental-strip-private-modules, \"worker\" condition); 1.0 - Early development (text imports, import.meta.main)",
"verifiedWith": [
"v28.0.0-pre (ab476eccd03)",
"v26.13.0",
"v24.19.0"
],
"discrepancies": [
{
"doc": "doc/api/module.md:1000-1006",
"claim": "load hook example returns { source: source.replace(/foo/g, 'bar'), ...result } to modify the loaded source.",
"behavior": "The trailing spread overwrites `source` with the original, so the replacement is silently lost (verified on v24.19.0, v26.13.0, main). Correct form: { ...result, source: ... }.",
"example": "examples/register-hooks.mjs"
},
{
"doc": "doc/api/module.md:202 (registerHooks Returns)",
"claim": "The returned object has [Symbol.dispose] (no version history).",
"behavior": "Present on v26.13.0 and main; absent on v24.19.0 (deregister() exists on all three)."
},
{
"doc": "doc/api/packages.md:1045-1047 and 1108-1158 ('Multiple packages for the same URL')",
"claim": "Multiple package-map entries may share the same url.",
"behavior": "v26.13.0 and main reject such a map with ERR_PACKAGE_MAP_INVALID ('packages \"a\" and \"b\" have the same url'), matching errors.md:2642 instead.",
"example": "examples/package-map.mjs"
},
{
"doc": "doc/api/module.md:546-550",
"claim": "The compile cache directory can be obtained either from the `directory` field returned by enableCompileCache() or with module.getCompileCacheDir() (implies the same value).",
"behavior": "getCompileCacheDir() returns a per-version subdirectory of `directory`, e.g. <dir>/v28.0.0-pre-x64-<hash>[-<uid>].",
"example": "examples/compile-cache.mjs"
},
{
"doc": "doc/api/module.md:365-370 (Portability of the compile cache)",
"claim": "A portable cache is not split by uid (no version history).",
"behavior": "True on v26.13.0 and main; on v24.19.0 the portable cache subdirectory still carries the -<uid> suffix. The change (nodejs/node adad4d650d0) has no YAML changes entry."
},
{
"doc": "doc/api/module.md:256-262 (stripTypeScriptTypes sourceUrl example)",
"claim": "Prints: const a = 1\\n\\n//# sourceURL=source.ts;",
"behavior": "Actual output is 'const a = 1;\\n\\n//# sourceURL=source.ts' (semicolon stays on the statement, none after the comment).",
"example": "examples/ts-removed-options.mjs"
},
{
"doc": "doc/api/packages.md:713-717 (\"worker\" condition)",
"claim": "Documented without version.",
"behavior": "Matches inside a Web Worker on main only; on v26.13.0 with --experimental-web-worker the global Worker exists but the condition does not match.",
"example": "examples/worker-condition.mjs"
},
{
"doc": "doc/api/cli.md:883-918 (--config-file nodeVersion/configs)",
"claim": "Documented without version history.",
"behavior": "Works on v26.13.0 and main; on v24.19.0 nodeVersion is accepted but a configs array silently applies nothing."
},
{
"doc": "doc/api/cli.md:970-978 (--config-file priority)",
"claim": "NODE_OPTIONS and CLI options take priority over the configuration file; values in the file will not override values in the environment variables (implies per-key precedence).",
"behavior": "If the NODE_OPTIONS environment variable is present at all (even empty, or containing an unrelated flag such as --no-deprecation), all nodeOptions from the config file are ignored. Verified on v24.19.0 (--experimental-config-file), v26.13.0 and main.",
"example": "examples/config-file.mjs"
}
]
}