Packages

@whatwg-node/promise-helpers

2.0.2 · 10 Nov 2026MIT34.4M / weekRepositoryHomepagenpmAtom feed

Your version

2.0.0

major21 Sep 2026Where it was published

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 mapMaybePromise in favor of handleMaybePromise.

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 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.

SemVer

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. 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.

  • 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
    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.

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.