@whatwg-node/promise-helpers
2.0.2 · 10 Nov 2026MIT34.4M / weekRepositoryHomepagenpmAtom feed
2.0.2 is the newest release of 2.x.
In short
2 breaking8 changed
- Breaking
Drop support for Node.js 18 and 20. The minimum supported Node.js version is now 22.15.
- Breaking
Remove deprecated
mapMaybePromisein favor ofhandleMaybePromise.
Release note
The section about @whatwg-node/promise-helpers of a note shared by several packages.
Major Changes
- Breaking
#3561
52a5bf6
Thanks @ardatan! - Drop support for Node.js 18
and 20. The minimum supported Node.js version is now 22.15.
Why
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 ontls.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.
SemVer
0.x packages: minor bump (breaking changes are allowed in minors while
major is 0).1.x packages (
@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.
What changed
engines.node: all published packages now declare>=22.15.0
(including@whatwg-node/promise-helpers, which was still on>=16).@whatwg-node/events: removed. NativeCustomEvent/Event/EventTargetare available on Node.js 22+, so the ponyfill is no longer
maintained; use the platform globals.@whatwg-node/fetch: dropped therequire("crypto").webcrypto
fallback;cryptois alwaysglobalThis.cryptoon supported runtimes.@whatwg-node/server: removed the Node 18setHeadersworkaround
(isNode1x);ServerResponse#setHeadersis used whenever it exists.@whatwg-node/node-fetch: Runtime guards forzlib.createZstdCompress
/createZstdDecompressare removed;zstdis always included inAccept-Encoding.CI / e2e: unit matrix is
[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
deprecatedmapMaybePromisein favor ofhandleMaybePromise.mapMaybePromise(input, onSuccess, onError?)is gone. UsehandleMaybePromise, 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), );handleMaybePromisealso accepts an optional fourthfinallyFactoryargument
if you need cleanup.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.