feat!: Require Node `>=20.19.0` as minimum supported version by andreiborza · Pull Request #22558 · getsentry/sentry-javascript

andreiborza · 2026-07-23T14:08:06Z

What

Raise the minimum supported Node.js version to 20.19.0 for v11.

Bump engines.node to >=20.19.0 across all packages and dev-packages.
Remove now-dead runtime branches that guarded pre-20 Node: the ESM loader-hooks version warning, the ANR 16.17 throw, both node-fetch diagnostics_channel refcount fallbacks, and the redis !dc.tracingChannel fallback.
Drop the Node-18 skip logic in ci-unit-tests.ts and refresh stale Node-18 references (issue template, workflow comment, docs, pino/spotlight docstrings).

Why

v11 targets Node 20.19.0 so the SDK can rely on require(esm) and stable tracingChannel without polyfills or legacy code paths. CI matrices, the migration guide, and the volta pin were already moved to Node 20; this aligns the published engines fields and removes the dead code the old floor required.

Kept the >=22.12 gates and the cross-runtime !dc.tracingChannel guards in @sentry/server-utils, which are still reachable on Deno/Bun/Cloudflare. The react-router server-OTel path and its node-20-18 e2e apps are left to #22290, which removes them.

Ref #22056

Bumps the minimum supported Node.js version to 20.19.0 for v11 and removes now-dead runtime branches that guarded pre-20 Node versions. Ref #22056 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

linear-code · 2026-07-23T14:08:10Z

JS-920

github-actions · 2026-07-23T14:16:19Z

size-limit report 📦

Path	Size	% Change	Change
@sentry/browser	27.94 kB	-	-
@sentry/browser - with treeshaking flags	26.39 kB	-	-
@sentry/browser (incl. Tracing)	46.41 kB	-	-
@sentry/browser (incl. Tracing + Span Streaming)	48.18 kB	-	-
@sentry/browser (incl. Tracing, Profiling)	51.21 kB	-	-
@sentry/browser (incl. Tracing, Replay)	85.68 kB	-	-
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags	75.33 kB	-	-
@sentry/browser (incl. Tracing, Replay with Canvas)	90.4 kB	-	-
@sentry/browser (incl. Tracing, Replay, Feedback)	103.06 kB	-	-
@sentry/browser (incl. Feedback)	45.12 kB	-	-
@sentry/browser (incl. sendFeedback)	32.74 kB	-	-
@sentry/browser (incl. FeedbackAsync)	37.8 kB	-	-
@sentry/browser (incl. Metrics)	29.04 kB	-	-
@sentry/browser (incl. Logs)	29.26 kB	-	-
@sentry/browser (incl. Metrics & Logs)	29.96 kB	-	-
@sentry/react	29.74 kB	-	-
@sentry/react (incl. Tracing)	48.71 kB	-	-
@sentry/vue	33.38 kB	-	-
@sentry/vue (incl. Tracing)	48.39 kB	-	-
@sentry/svelte	27.96 kB	-	-
CDN Bundle	30.27 kB	-	-
CDN Bundle (incl. Tracing)	48.24 kB	-	-
CDN Bundle (incl. Logs, Metrics)	31.84 kB	-	-
CDN Bundle (incl. Tracing, Logs, Metrics)	49.56 kB	-	-
CDN Bundle (incl. Replay, Logs, Metrics)	71.12 kB	-	-
CDN Bundle (incl. Tracing, Replay)	85.81 kB	-	-
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)	87.13 kB	-	-
CDN Bundle (incl. Tracing, Replay, Feedback)	91.59 kB	-	-
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)	92.87 kB	-	-
CDN Bundle - uncompressed	90.09 kB	-	-
CDN Bundle (incl. Tracing) - uncompressed	145.16 kB	-	-
CDN Bundle (incl. Logs, Metrics) - uncompressed	94.8 kB	-	-
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed	149.14 kB	-	-
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed	219.57 kB	-	-
CDN Bundle (incl. Tracing, Replay) - uncompressed	264.4 kB	-	-
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed	268.37 kB	-	-
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed	278.1 kB	-	-
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed	282.06 kB	-	-
@sentry/nextjs (client)	51.23 kB	-	-
@sentry/sveltekit (client)	46.84 kB	-	-
@sentry/core/server	80.04 kB	-	-
@sentry/core/browser	52 kB	-	-
@sentry/node	122.99 kB	-1.2%	-1.49 kB 🔽
@sentry/node (incl. diagnostics channel injection)	167 kB	-0.89%	-1.49 kB 🔽
@sentry/node/import (ESM hook with diagnostics-channel injection)	166 B	-	-
@sentry/node - without tracing	73.15 kB	-2.13%	-1.59 kB 🔽
@sentry/aws-serverless	82.63 kB	-1.87%	-1.57 kB 🔽
@sentry/cloudflare (withSentry) - minified	197.03 kB	-	-
@sentry/cloudflare (withSentry)	484.7 kB	-	-

View base workflow run

chargome

nice

nicohrubec

nice

nicohrubec · 2026-07-24T07:30:10Z

 * - Dropped the `@opentelemetry/instrumentation` base (undici reports via `diagnostics_channel`,
 *   so no module patching was needed) — exposed as a plain `instrumentUndici()` function that the
 *   integration wires up directly
+ * - Dropped the pre-18.19.0 `diagnostics_channel` ref-counting workaround, since the SDK


l: don't think this adds anything?

Removed in 77caf0d

… channel support

andreiborza · 2026-07-24T08:26:37Z

I updated the range to >=20.19.0 <22.0.0 || >=22.12.0 <23.0.0 || >=23.2.0 and dropped some guardrails, please check again @chargome @nicohrubec 🙏

nicohrubec

we also have checks in our orchestrion integration to see if tracing channels are available, which seems to be only relevant for node 18 afaict? e.g. here

Shouldn't hurt to be safe but we could also think about removing these?

nicohrubec · 2026-07-24T08:29:39Z

    });
  });

-  describe('createCallbackList', () => {


q: why is this no longer relevant?

createCallbackList was sync only and the code always chooses async by default given the node version so this is no longer needed.

Lms24

nice!

q: Should this be feat(node)!: ... ?

andreiborza · 2026-07-24T08:41:15Z

@nicohrubec that comment is kinda misleading because server-utils can also be used by bun, cf and deno where it's not as clear which versions need it. I opted to keep it for now, we can clean that up later if we are confident it doesn't break.

andreiborza · 2026-07-24T08:41:51Z

@Lms24 it kinda touches every sdk package which is why it doesn't have a scope

…e app (#22593) Removes the `react-router-7-framework-spa-node-20-18` e2e app. It existed only to test on Node 20.18, which is now below the `>=20.19.0` minimum supported version (#22558). It is otherwise a duplicate of `react-router-7-framework-spa`, so it is removed rather than kept on an unsupported Node version. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

## pnpm-workspace.yaml (default) ## Dependency Updates | Package | From | To | Type | | --- | --- | --- | --- | | `@sentry/cloudflare` | 10.75.0 | 11.0.0 | major | | `@sentry/react` | 10.75.0 | 11.0.0 | major | ## Release Notes <details> <summary>@sentry/cloudflare (10.75.0 → 11.0.0) — 4 releases</summary> <details> <summary>11.0.0</summary> Version `11.0.0` marks a major release of the Sentry JavaScript SDKs containing breaking changes. The goal of this release is to be better compatible with OpenTelemetry, make our integrations work across Node.js, Cloudflare, Bun and Deno through run-time and build-time instrumentation, and make span streaming and more permissive data collection the default. ### How To Upgrade Please carefully read through the migration guide in the Sentry docs on how to upgrade from version 10 to version 11. Make sure to select your specific platform/framework in the top left corner: https://docs.sentry.io/platforms/javascript/migration/v10-to-v11/ A comprehensive migration guide outlining all changes can be found within the Sentry JavaScript SDK Repository: https://github.com/getsentry/sentry-javascript/blob/develop/MIGRATION.md ### Breaking Changes #### All SDKs - feat: Remove support for initialising via `--require` ([#22513](getsentry/sentry-javascript#22513)) - feat!: Rename deprecated `http.*` span attributes ([#23574](getsentry/sentry-javascript#23574)) - feat!: Rename deprecated `net.` span attributes ([#23301](getsentry/sentry-javascript#23301)) - feat!: Replace `skipOpenTelemetrySetup` with `enableOpenTelemetrySetup` ([#23199](getsentry/sentry-javascript#23199)) - feat!: Replace the deprecated `http.target` span attribute ([#23575](getsentry/sentry-javascript#23575)) - feat!: Require Node `>=20.19.0` as minimum supported version ([#22558](getsentry/sentry-javascript#22558)) - feat!: Use `handler` span op for terminal request handlers ([#22871](getsentry/sentry-javascript#22871)) - feat!: Use `middleware` span op for web-server middleware ([#22852](getsentry/sentry-javascript#22852)) - feat(frameworks)!: Use `function` op for framework functions ([#23047](https://github.com/getse …[full notes](https://github.com/getsentry/sentry-javascript/releases/tag/11.0.0) </details> <details> <summary>10.75.3</summary> - fix(v10/tanstackstart-react): Reject non-POST requests to the managed tunnel route ([#24617](getsentry/sentry-javascript#24617)) <details> <summary>Internal Changes</summary> - chore(v10/bundler-plugins): move traces sample rate from 1.0 to 0.3 ([#24646](getsentry/sentry-javascript#24646)) - chore(v10/publish): Tag all packages as v10 ([#24619](getsentry/sentry-javascript#24619)) </details> ## Bundle size 📦 | Path | Size | | -------------------------------------------------------------------------- | ----------------- | | @sentry/browser | 27.56 KB | | @sentry/browser - with treeshaking flags | 26.04 KB | | @sentry/browser (incl. Tracing) | 46.02 KB | | @sentry/browser (incl. Tracing + Span Streaming) | 47.77 KB | | @sentry/browser (incl. Tracing, Profiling) | 50.67 KB | | @sentry/browser (incl. Tracing, Replay) | 84.38 KB | | @sentry/browser (incl. Tracing, Replay) - with treeshaking flags | 74.28 KB | | @sentry/browser (incl. Tracing, Replay with Canvas) | 89 KB | | @sentry/browser (incl. Tracing, Replay, Feedback) | 101.33 KB | | @sentry/browser (incl. Feedback) | 44.33 KB | | @sentry/browser (incl. sendFeedback) | 32.25 KB | | @sentry/browser (incl. FeedbackAsync) | 37.27 KB | | @sentry/browser (incl. Metrics) | 28.63 KB | | @sentry/browser (incl. Logs) | 28.84 KB | | @sentry/bro …[full notes](https://github.com/getsentry/sentry-javascript/releases/tag/10.75.3) </details> …and 2 more release(s) not shown </details> <details> <summary>@sentry/react (10.75.0 → 11.0.0) — 4 releases</summary> <details> <summary>11.0.0</summary> Version `11.0.0` marks a major release of the Sentry JavaScript SDKs containing breaking changes. The goal of this release is to be better compatible with OpenTelemetry, make our integrations work across Node.js, Cloudflare, Bun and Deno through run-time and build-time instrumentation, and make span streaming and more permissive data collection the default. ### How To Upgrade Please carefully read through the migration guide in the Sentry docs on how to upgrade from version 10 to version 11. Make sure to select your specific platform/framework in the top left corner: https://docs.sentry.io/platforms/javascript/migration/v10-to-v11/ A comprehensive migration guide outlining all changes can be found within the Sentry JavaScript SDK Repository: https://github.com/getsentry/sentry-javascript/blob/develop/MIGRATION.md ### Breaking Changes #### All SDKs - feat: Remove support for initialising via `--require` ([#22513](getsentry/sentry-javascript#22513)) - feat!: Rename deprecated `http.*` span attributes ([#23574](getsentry/sentry-javascript#23574)) - feat!: Rename deprecated `net.` span attributes ([#23301](getsentry/sentry-javascript#23301)) - feat!: Replace `skipOpenTelemetrySetup` with `enableOpenTelemetrySetup` ([#23199](getsentry/sentry-javascript#23199)) - feat!: Replace the deprecated `http.target` span attribute ([#23575](getsentry/sentry-javascript#23575)) - feat!: Require Node `>=20.19.0` as minimum supported version ([#22558](getsentry/sentry-javascript#22558)) - feat!: Use `handler` span op for terminal request handlers ([#22871](getsentry/sentry-javascript#22871)) - feat!: Use `middleware` span op for web-server middleware ([#22852](getsentry/sentry-javascript#22852)) - feat(frameworks)!: Use `function` op for framework functions ([#23047](https://github.com/getse …[full notes](https://github.com/getsentry/sentry-javascript/releases/tag/11.0.0) </details> <details> <summary>10.75.3</summary> - fix(v10/tanstackstart-react): Reject non-POST requests to the managed tunnel route ([#24617](getsentry/sentry-javascript#24617)) <details> <summary>Internal Changes</summary> - chore(v10/bundler-plugins): move traces sample rate from 1.0 to 0.3 ([#24646](getsentry/sentry-javascript#24646)) - chore(v10/publish): Tag all packages as v10 ([#24619](getsentry/sentry-javascript#24619)) </details> ## Bundle size 📦 | Path | Size | | -------------------------------------------------------------------------- | ----------------- | | @sentry/browser | 27.56 KB | | @sentry/browser - with treeshaking flags | 26.04 KB | | @sentry/browser (incl. Tracing) | 46.02 KB | | @sentry/browser (incl. Tracing + Span Streaming) | 47.77 KB | | @sentry/browser (incl. Tracing, Profiling) | 50.67 KB | | @sentry/browser (incl. Tracing, Replay) | 84.38 KB | | @sentry/browser (incl. Tracing, Replay) - with treeshaking flags | 74.28 KB | | @sentry/browser (incl. Tracing, Replay with Canvas) | 89 KB | | @sentry/browser (incl. Tracing, Replay, Feedback) | 101.33 KB | | @sentry/browser (incl. Feedback) | 44.33 KB | | @sentry/browser (incl. sendFeedback) | 32.25 KB | | @sentry/browser (incl. FeedbackAsync) | 37.27 KB | | @sentry/browser (incl. Metrics) | 28.63 KB | | @sentry/browser (incl. Logs) | 28.84 KB | | @sentry/bro …[full notes](https://github.com/getsentry/sentry-javascript/releases/tag/10.75.3) </details> …and 2 more release(s) not shown </details> --- *This PR was auto-generated by [catalog-update-action](https://github.com/brandhaug/catalog-update-action).* Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

feat!: Require Node >=20.19.0 as minimum supported version

4abf530

Bumps the minimum supported Node.js version to 20.19.0 for v11 and removes now-dead runtime branches that guarded pre-20 Node versions. Ref #22056 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

andreiborza marked this pull request as ready for review July 24, 2026 07:22

andreiborza requested review from a team as code owners July 24, 2026 07:22

andreiborza requested review from JPeer264, chargome, isaacs, logaretm, msonnb, nicohrubec and timfish and removed request for a team July 24, 2026 07:22

chargome approved these changes Jul 24, 2026

View reviewed changes

nicohrubec reviewed Jul 24, 2026

View reviewed changes

nicohrubec approved these changes Jul 24, 2026

View reviewed changes

andreiborza added 3 commits July 24, 2026 09:38

Remove redundant vendoring NOTICE comment

77caf0d

Narrow engines.node to exclude Node versions without HTTP diagnostics…

9217771

… channel support

Remove sync LocalVariables integration

9ba7e02

andreiborza requested review from chargome and nicohrubec July 24, 2026 08:25

nicohrubec approved these changes Jul 24, 2026

View reviewed changes

Lms24 approved these changes Jul 24, 2026

View reviewed changes

andreiborza merged commit 4f03438 into develop Jul 24, 2026
549 of 551 checks passed

andreiborza deleted the ab/js-920-require-node-20 branch July 24, 2026 08:51

chargome mentioned this pull request Jul 24, 2026

test(react-router): Remove react-router-7-framework-spa-node-20-18 e2e app #22593

Merged

This was referenced Sep 16, 2026

publish: getsentry/sentry-javascript@11.0.0-rc.0 getsentry/publish#9545

Closed

publish: getsentry/sentry-javascript@11.0.0 getsentry/publish#9615

Closed

brandhaug mentioned this pull request Sep 27, 2026

chore(deps): bump sentry dependencies brandhaug/b2b-saas-starter#506

Merged

Uh oh!

Conversation

andreiborza commented Jul 23, 2026 • edited by chargome Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

Why

Uh oh!

linear-code Bot commented Jul 23, 2026

Uh oh!

github-actions Bot commented Jul 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

size-limit report 📦

Uh oh!

chargome left a comment

Choose a reason for hiding this comment

Uh oh!

nicohrubec left a comment

Choose a reason for hiding this comment

Uh oh!

nicohrubec Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

andreiborza Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

andreiborza commented Jul 24, 2026

Uh oh!

nicohrubec left a comment

Choose a reason for hiding this comment

Uh oh!

nicohrubec Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

andreiborza Jul 24, 2026

Choose a reason for hiding this comment

Uh oh!

Lms24 left a comment

Choose a reason for hiding this comment

Uh oh!

andreiborza commented Jul 24, 2026

Uh oh!

andreiborza commented Jul 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

andreiborza commented Jul 23, 2026 •

edited by chargome

Loading

github-actions Bot commented Jul 23, 2026 •

edited

Loading