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 (EOL) 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:

crypto-rsa-pss-update

In DEP0154, the generateKeyPair and generateKeyPairSync methods in the crypto module deprecated the hash, mgf1Hash, and saltLength options for the 'rsa-pss' key type in favor of hashAlgorithm, mgf1HashAlgorithm, and saltLength respectively.

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  = ('node:crypto');

.(
  'rsa-pss',
  {
    : 2048,
    : 'sha256',
    : 'sha1',
    : 32,
  },
  (, , ) => {
    // callback
  }
);

dirent-path-to-parent-path

This codemod transforms the usage of dirent.path to use dirent.parentPath.

See DEP0178.

You can find this codemod in the Codemod Registry.

npx codemod run @nodejs/dirent-path-to-parent-path

Examples

readdir

const {  } = ('node:fs/promises');
const  = await ('/some/path', { : true });
for (const  of ) {
  .(.path);
}

opendir

import {  } from 'node:fs/promises';
const  = await ('./');
for await (const  of ) {
  .(`Found ${.} in ${.path}`);
}

fs-access-mode-constants

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  = ('node:fs');

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

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-fd-deprecation

Example

const { , ,  } = ('node:fs');

('file.txt', 'w', (, ) => {
  if () throw ;
  (, 10,  => {
    if () throw ;
    (, () => {});
  });
});

process-assert-to-node-assert

This recipe transforms the usage of process.assert to use node:assert module.

See DEP0100.

You can find this codemod in the Codemod Registry.

npx codemod run @nodejs/process-assert-to-node-assert

Example

.assert(condition, 'Assertion failed');

Additional Notes

This codemod use fs capability to read the package.json file and determine if the project is using ES modules or CommonJS. Based on this information, it adds the appropriate import statement for the assert module.