●Change8

Migrating to Node.js v25.2.0

Version v25.2.0 introduces 1 breaking change. This guide details how to update your code.

Released: 11/11/2025

1
Breaking Changes
2
Migration Steps
8
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

util.deprecatelocalStoragenetnapi_create_object_with_propertiesv8.getHeapStatisticscrypto.timingSafeEqualBuffer.concatconsole

Breaking Changes

●Issue #1

The localStorage getter now throws an error if the storage path is missing.

Migration Steps

  1. 1
    Ensure a storage path is configured when using localStorage to avoid new throw behavior.
  2. 2
    If using type stripping, you can now rely on it as a stable feature rather than experimental.

Release Summary

This release stabilizes type stripping, introduces new Node-API and V8 statistics methods, and improves performance for Buffer and console operations. It also includes a breaking change where localStorage throws on missing storage paths.

Need More Details?

View the full release notes and all changes for Node.js v25.2.0.

View Full Changelog