Node.js v22 to v24

Node.js v22 to v24

With the release of Node.js 24.11.0, the Node.js 24 release line has entered Long-Term Support (LTS) and will continue to receive updates through to the end of April 2028.

If you are migrating from Node.js 22 LTS, the following summarizes the breaking changes that came in Node.js 23.0.0 and Node.js 24.0.0.

Platform support

Node.js no longer provides pre-built binaries for:

• 32-bit Windows (x86) as of Node.js 23.0.0.
• 32-bit Linux on armv7 as of Node.js 24.0.0.

Pre-built binaries for macOS now require a minimum of macOS 13.5.

Pre-built binaries for Linux on arm64, ppc64le, s390x and x64 continue to be compatible with glibc 2.28 and above (no change from Node.js 22).

Please refer to additional notes if you are building Node.js from source.

Breaking changes

OpenSSL 3.5

Pre-built binaries of Node.js 24 LTS, or builds using the default build configuration options, include OpenSSL 3.5. Node.js 24 LTS uses the default security level from OpenSSL 3.5 of 2, which means that:

• RSA, DSA and DH keys shorter than 2048 bits and ECC keys shorter than 224 bits are prohibited.
• Any cipher suite using RC4 is also prohibited.

If you rely on older keys or weak ciphers, test your workloads against Node.js 24 builds (or adjust key/cipher choices) before upgrading.

Other behavioral changes and argument validation

The release includes a number of behavior and validation changes (stricter fetch() compliance, AbortSignal validation, stream/pipe errors now throwing, changes to Buffer behavior, path handling fixes on Windows, test runner defaults, and more).

C/C++ addons

Addons linking against V8 APIs may need updates for V8 13.6; C++20 support may be required where previously C++17 was used. Where possible, prefer NODE-API to reduce rebuild churn.

Building Node.js from source

If you are building Node.js from source, you may need to update your compiler toolchain:

• For AIX and Linux platforms, the minimum supported version of gcc is 12.2.
• For macOS the minimum supported version of Xcode is 16.1.

Node.js' configure script will warn if you attempt to build Node.js with a compiler toolchain that does not meet the minimum supported version but will not actively prevent you from trying.

Available Codemods

Some breaking changes or End of Life deprecations in Node.js 23 and 24 have associated codemods to help you update your codebase. Below is a list of the available codemods for this migration:

fs-access-mode-constants

In Node.js 24, the fs module introduced a runtime deprecation for F_OK, R_OK, W_OK, and X_OK getters exposed directly on node:fs. Get them from fs.constants or fs.promises.constants instead.

This codemod handles DEP0176.

The source code for this codemod can be found in the fs-access-mode-constants directory.

You can find this codemod in the Codemod Registry.

npx codemod run @nodejs/fs-access-mode-constants

Example:

const fs = require('node:fs');

fs.access('/path/to/file', fs.F_OK, callback);
fs.access('/path/to/file', fs.R_OK | fs.W_OK, callback);

util-log-to-console-log

In Node.js v23, the util.log function was deprecated in favor of using console.log directly. Because it's an unmaintained legacy API that was exposed to user land by accident

So this codemod handle DEP0059.

npx codemod run @nodejs/util-log-to-console-log

Example:

const util = require('node:util');

util.log('Hello world');

zlib-bytesRead-to-bytesWritten

The zlib.bytesRead property was deprecated (DEP0108) in favor of zlib.bytesWritten. This codemod replaces zlib.bytesRead with zlib.bytesWritten for consistent stream property naming. It handles both CommonJS and ESM imports.

The source code for this codemod can be found in the zlib-bytesRead-to-bytesWritten directory.

You can find this codemod in the Codemod Registry.

npx codemod run @nodejs/zlib-bytesread-to-byteswritten

Example:

const zlib = require('node:zlib');
const gzip = zlib.createGzip();
gzip.on('end', () => {
  console.log('Bytes processed:', gzip.bytesRead);
});

fs-truncate-to-ftruncate

The fs.truncate function was deprecated (DEP0081) when used with a file descriptor. Use fs.ftruncate instead.

The source code for this codemod can be found in the fs-truncate-fd-deprecation directory.

You can find this codemod in the Codemod Registry.

npx codemod run @nodejs/fs-truncate-to-ftruncate

Example:

const { truncate, open, close } = require('node:fs');

open('file.txt', 'w', (err, fd) => {
  if (err) throw err;
  truncate(fd, 10, err => {
    if (err) throw err;
    close(fd, () => {});
  });
});

crypto-rsa-pss-update

Codemod to handle Node.js crypto deprecation DEP0154 by transforming deprecated RSA-PSS key generation options.

The source code for this codemod can be found in the crypto-rsa-pss-update directory.

You can find this codemod in the Codemod Registry.

npx codemod run @nodejs/crypto-rsa-pss-update

Example:

const crypto = require('node:crypto');

crypto.generateKeyPair(
  'rsa-pss',
  {
    modulusLength: 2048,
    hash: 'sha256',
    mgf1Hash: 'sha1',
    saltLength: 32,
  },
  (err, publicKey, privateKey) => {
    // callback
  }
);