npx skills add jasnell/node-skills --skill node-modern-migrationSKILL.md
Removed APIs and changed defaults (v24 → main)
| Feature | Versions | Stability | Flag |
|---|---|---|---|
| EOL removals below | v25.0.0, v26.0.0, v27.0.0-alpha.0.0.0, main | removed | — |
| Changed defaults below | per row | — | — |
localStorage on by default |
v25.0.0 | 1.2 RC | --localstorage-file |
Experimental API. Before relying on these details, run the
node-experimental-checkskill's probe (ornode --versionplus a feature-detect one-liner) and check the docs for the installed version:https://nodejs.org/docs/<version>/api/<module>.html. If the installed version disagrees with this skill, the installed version wins.
v27.0.0-alpha.0.0.0 is an alpha line: no stable v27 exists yet. On v26
those rows still work but print a runtime DeprecationWarning.
Stale pattern → write instead
Each replacement already works on v24, so migrate without a version gate.
| Stale | Write | Gone in |
|---|---|---|
SlowBuffer(n) |
Buffer.allocUnsafeSlow(n) |
v25.0.0 |
fs.F_OK, fs.R_OK… |
fs.constants.F_OK |
v25.0.0 |
fs.rmdir(p, { recursive }) |
fs.rm(p, { recursive: true, force: true }) |
v25.0.0 |
assert.CallTracker |
mock.fn() from node:test |
v25.0.0 |
assert.fail(a, b) |
assert.strictEqual(a, b) |
v25.0.0 |
repl.REPLServer() |
new repl.REPLServer() |
v25.0.0 |
leaked FileHandle |
await using fh = await open() |
v25.0.0 (throws) |
require('node:_stream_readable') |
require('node:stream') |
v26.0.0 |
res.writeHeader() |
res.writeHead() |
v26.0.0 |
crypto.fips |
crypto.getFips() / setFips() |
v27 alpha |
zlib.Gzip() |
new zlib.Gzip() or zlib.createGzip() |
v27 alpha |
createHash('shake256') |
createHash('shake256', { outputLength }) |
v27 alpha |
CryptoKey into node:crypto |
KeyObject.from(key) |
v27 alpha |
crypto.setEngine, clientCertEngine |
none (OpenSSL providers) | v27 alpha |
module.register(), --loader |
module.registerHooks(): see node-modules-loading |
main |
--experimental-transform-types |
erasable TS only, no flag: see node-modules-loading |
v26.0.0 |
Changed defaults
server.keepAliveTimeoutis 65000 ms, was 5000 (v27 alpha). Set it explicitly if a proxy needs it shorter.Buffer.poolSizeis 65536, was 8192 (v26.3.0, v24.18.0).readable.read()with no size returns one chunk (v26.0.0). Loopwhile ((c = r.read()) !== null).localStoragewithout--localstorage-fileisundefinedplus a warning (v26.0.0, verified; the docs say it throws).new DatabaseSync(path)hasdefensive: trueby default (v25.5.0, v24.14.0).fs.mkdtemp(Buffer)returns a Buffer, even withencoding: 'utf8'(v27 alpha). Pass a string prefix to get a string.
Pitfalls
- On v26, run tests with
--throw-deprecationto surface the v27/main removals. httpclasses withoutnewonly warn (DEP0195). Addnewanyway.sqlite.Database(the new name forDatabaseSync) is not on v24.19. Keep usingDatabaseSyncwhile v24 is supported.
Don't
- Don't use the
util.isDate/isString/… helpers,util.log(EOL v23.0.0),crypto.createCipher(v22.0.0) ordirent.path(v24.0.0). - Don't load
node:domain(runtime-deprecated in v27 alpha) ornode:_http_*.
Reference
- rules/removals.md: every End-of-Life since v23, with what throws and how. Read it for any API missing from the table above.
- rules/deprecations.md: runtime and documentation-only deprecations that still work but warn.
- rules/changed-defaults.md: every changed default with details (upgrade event, dns.reverse, REPL await, execve, largepages).