NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #3490 most downloaded on npm
Promise helpers
Latest stable
2.0.2
Last release 11 days ago
10 Nov 2026
Ships unpredictably
gaps range from 8 days to 10 months
Nearly every release is documented
notes for 14 of 14 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
321 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Resolved and rejected fake promises (and foreign-thenable wrappers) are no longer allocated as object literals with own then/catch/finally methods. A
#3793
f778c82
Thanks @ardatan! - Use shared prototype classes
for fakePromise / fakeRejectPromise instances.
Resolved and rejected fake promises (and foreign-thenable wrappers) are no
longer allocated as object literals with own then/catch/finally methods.
A shared constructor keeps a stable V8 hidden class while preserving the same
brand (Symbol.for) and unwrapping behavior.
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
@whatwg-node/server-plugin-cookies@2.0.1
@whatwg-node/server-plugin-cookies@2.0.1
#3733
75603bd
Thanks @ardatan! - Make handleMaybePromise
avoid temporary fake-promise wrappers on the synchronous path.
When no finally callback is provided and the input factory returns a
non-thenable value, success/error factories run directly. Promise,
fake-promise, and custom thenable inputs still go through the existing
normalization path.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
@whatwg-node/server-plugin-cookies@2.0.0
@whatwg-node/server-plugin-cookies@2.0.0
#3561
52a5bf6
Thanks @ardatan! - Drop support for Node.js 18
and 20. The minimum supported Node.js version is now 22.15.
Node.js 18 and 20 are end-of-life and no longer receive security updates. Keeping them in our support matrix forced version-specific workarounds and slowed adoption of newer Node TLS APIs.
The floor is set to 22.15 (not just 22.0) so we can rely on
tls.getCACertificates() (Node.js 22.15 / 23.10) and always-on zlib zstd
helpers (createZstdCompress / createZstdDecompress, Node.js 22.15 / 23.8).
That matches the oldest currently supported LTS line (22 Maintenance) while
dropping only EOL majors.
@whatwg-node/promise-helpers,
@whatwg-node/server-plugin-cookies): major bump, since dropping
supported Node versions is a breaking engines change for SemVer >=1.0.0
consumers.engines.node: all published packages now declare >=22.15.0
(including @whatwg-node/promise-helpers, which was still on >=16).@whatwg-node/events: removed. Native CustomEvent / Event /
EventTarget are available on Node.js 22+, so the ponyfill is no longer
maintained; use the platform globals.@whatwg-node/fetch: dropped the require("crypto").webcrypto
fallback; crypto is always globalThis.crypto on supported runtimes.@whatwg-node/server: removed the Node 18 setHeaders workaround
(isNode1x); ServerResponse#setHeaders is used whenever it exists.@whatwg-node/node-fetch: Runtime guards for zlib.createZstdCompress
/ createZstdDecompress are removed; zstd is always included in
Accept-Encoding.[22, 24, 26]; AWS Lambda runtime and Azure
Function target moved from Node 20 to Node 22.If you are still on Node 18 or 20, upgrade to Node.js 22.15+ (or 24 / 26) before installing this release.
#3565
ba977d4
Thanks @ardatan! - Breaking Change: Remove
deprecated mapMaybePromise in favor of handleMaybePromise.
mapMaybePromise(input, onSuccess, onError?) is gone. Use
handleMaybePromise, which takes an input factory (thunk) instead of a
bare value so sync throws are handled the same way as promise rejections.
Before:
import { mapMaybePromise } from "@whatwg-node/promise-helpers";
const result = mapMaybePromise(
maybeValue,
(value) => transform(value),
(err) => fallback(err),
);
After:
import { handleMaybePromise } from "@whatwg-node/promise-helpers";
const result = handleMaybePromise(
() => maybeValue,
(value) => transform(value),
(err) => fallback(err),
);
handleMaybePromise also accepts an optional fourth finallyFactory argument
if you need cleanup.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.