Node.js v25.2.1 (Current) Release: Key localStorage API Revert

Node.js

Node.js v25.2.1, the current release, reverts a breaking change to localStorage access behavior, deferring it to Node.js 26.0.0. This update also includes crypto fixes and V8 backports.

Node.js v25.2.1 (Current) has been released, primarily featuring a significant revert to the localStorage API behavior.

This release addresses feedback regarding a previous change that sometimes caused localStorage access to throw errors, aligning with spec-compliant behavior. This alteration was deemed too breaking for a semver-minor release and has therefore been reverted in v25.2.1, with its reintroduction planned for Node.js 26.0.0.

Key updates in this release include:

  • Crypto: Ensured the documented RSA-PSS saltLength default is consistently applied.
  • Dependencies: Backported a critical V8 update (2e4c5cf9b112).
  • Documentation & Library: Clarified the experimental status of Web Storage support within Node.js.
  • Core Revert: The "throw from localStorage getter on missing storage path" change has been fully reverted.

For developers and users, Node.js v25.2.1 provides a more stable experience by rolling back this localStorage behavior change.


Download and Documentation

Pre-built installers and binaries for various platforms are available:

The Source Code and comprehensive Documentation for this release are also available.