From 46b6a33210cf4d0ab8dc1acefbf01e48b7a6797f Mon Sep 17 00:00:00 2001 From: Nicolas Hrubec Date: Thu, 10 Sep 2026 15:29:25 +0200 Subject: [PATCH] docs(node): update minimum Node.js version to 20.19.0 Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/platforms/javascript/common/install/esm.mdx | 3 --- .../javascript/common/install/late-initialization.mdx | 1 - docs/platforms/javascript/guides/elysia/index.mdx | 2 +- .../javascript/guides/nestjs/install/esm.mdx | 3 --- docs/platforms/javascript/guides/nitro/index.mdx | 2 +- platform-includes/getting-started-node/javascript.mdx | 1 - .../getting-started-prerequisites/javascript.node.mdx | 11 +---------- platform-includes/getting-started-run/javascript.mdx | 1 - 8 files changed, 3 insertions(+), 21 deletions(-) diff --git a/docs/platforms/javascript/common/install/esm.mdx b/docs/platforms/javascript/common/install/esm.mdx index d222a843810b8..6021e6174d5a9 100644 --- a/docs/platforms/javascript/common/install/esm.mdx +++ b/docs/platforms/javascript/common/install/esm.mdx @@ -37,7 +37,6 @@ Sentry.init({ Adjust the Node.js call for your application to use the [--import](https://nodejs.org/api/cli.html#--importmodule) parameter and point it at `instrument.js`, which contains your `Sentry.init()` code: ```bash -# Note: This is only available for Node v18.19.0 onwards. node --import ./instrument.mjs app.mjs ``` @@ -51,8 +50,6 @@ If you're building a Node.js Single Executable Application (SEA) and can't rely on `--import` or `NODE_OPTIONS`, use the SEA bootstrap setup instead. -We do not support ESM in Node versions before 18.19.0. - ## Troubleshooting instrumentation By default, all packages are wrapped under the hood by diff --git a/docs/platforms/javascript/common/install/late-initialization.mdx b/docs/platforms/javascript/common/install/late-initialization.mdx index 1362f0af7741a..b9b12d1a02ede 100644 --- a/docs/platforms/javascript/common/install/late-initialization.mdx +++ b/docs/platforms/javascript/common/install/late-initialization.mdx @@ -64,7 +64,6 @@ Sentry.init({ In your ESM application, use the `@sentry/node/preload` hook with `--import` to ensure modules are wrapped early: ```bash -# Note: This is only available for Node v18.19.0 onwards. node --import @sentry/node/preload app.js ``` diff --git a/docs/platforms/javascript/guides/elysia/index.mdx b/docs/platforms/javascript/guides/elysia/index.mdx index 87f719fde0098..073f9bb19f646 100644 --- a/docs/platforms/javascript/guides/elysia/index.mdx +++ b/docs/platforms/javascript/guides/elysia/index.mdx @@ -22,7 +22,7 @@ You need: - A Sentry [account](https://sentry.io/signup/) and [project](/product/projects/) - An Elysia application (`v1.4.0+`) -- Bun or Node.js 18+ (with [@elysiajs/node](https://elysiajs.com/integrations/node) adapter) +- Bun or Node.js 20.19.0+ (with [@elysiajs/node](https://elysiajs.com/integrations/node) adapter) diff --git a/docs/platforms/javascript/guides/nestjs/install/esm.mdx b/docs/platforms/javascript/guides/nestjs/install/esm.mdx index 9ba9ba454e9a0..adf7ffa74cf05 100644 --- a/docs/platforms/javascript/guides/nestjs/install/esm.mdx +++ b/docs/platforms/javascript/guides/nestjs/install/esm.mdx @@ -31,7 +31,6 @@ Sentry.init({ **Step 2:** Adjust your application's start command to use the [--import](https://nodejs.org/api/cli.html#--importmodule) parameter: ```bash -# Note: This is only available for Node v18.19.0 onwards. "start": "--import ./instrument.mjs nest start" ``` @@ -41,8 +40,6 @@ If you can't pass the `--import` flag to the Node.js binary, you can alternative NODE_OPTIONS="--import ./instrument.mjs" npm run start ``` -We do not support ESM in Node versions before 18.19.0. - ## Troubleshooting ESM Instrumentation By default, all packages are automatically wrapped by diff --git a/docs/platforms/javascript/guides/nitro/index.mdx b/docs/platforms/javascript/guides/nitro/index.mdx index 9aa43cae5d4bd..7f7e9efdbb223 100644 --- a/docs/platforms/javascript/guides/nitro/index.mdx +++ b/docs/platforms/javascript/guides/nitro/index.mdx @@ -21,7 +21,7 @@ You need: - A Sentry [account](https://sentry.io/signup/) and [project](/product/projects/) - A Nitro application (`3.0.260415-beta` or newer) -- Node.js 18.19.0+ +- Node.js 20.19.0+ diff --git a/platform-includes/getting-started-node/javascript.mdx b/platform-includes/getting-started-node/javascript.mdx index f3feb0922de7d..8b543151099ca 100644 --- a/platform-includes/getting-started-node/javascript.mdx +++ b/platform-includes/getting-started-node/javascript.mdx @@ -91,7 +91,6 @@ When running your application in ESM mode, use the [--import](https://nodejs.org ```bash -# Note: This is only available for Node v18.19.0 onwards. node --import ./instrument.mjs app.mjs ``` diff --git a/platform-includes/getting-started-prerequisites/javascript.node.mdx b/platform-includes/getting-started-prerequisites/javascript.node.mdx index 76c8644590648..921938957f024 100644 --- a/platform-includes/getting-started-prerequisites/javascript.node.mdx +++ b/platform-includes/getting-started-prerequisites/javascript.node.mdx @@ -4,13 +4,4 @@ You need: - A Sentry [account](https://sentry.io/signup/) and [project](/product/projects/) - Your application up and running -- Node version `18.0.0` or above (>= `19.9.0` or `18.19.0` recommended) - - - The required Node version will increase in the next major release of the SDK (v11) to support features that rely on [`TracingChannel`](https://nodejs.org/api/diagnostics_channel.html#class-tracingchannel). - - - We strongly recommend upgrading to at least Node `18.19.0` or `19.9.0` to get the best support. - - While we may add features relying on `TracingChannel` in v10.x releases, they will have backwards compatibility for older Node versions. - - See the following [issue on GitHub](https://github.com/getsentry/sentry-javascript/issues/17585) for more details. - +- Node version `20.19.0` or above. Node.js 22 needs `22.12` or higher, while Node.js 23 needs `23.2` or higher (`>=20.19.0 <22.0.0 || >=22.12.0 <23.0.0 || >=23.2.0`). diff --git a/platform-includes/getting-started-run/javascript.mdx b/platform-includes/getting-started-run/javascript.mdx index 3b891ce87d7a1..8af4d73cb6092 100644 --- a/platform-includes/getting-started-run/javascript.mdx +++ b/platform-includes/getting-started-run/javascript.mdx @@ -3,7 +3,6 @@ node --require ./instrument.js app.js # If you are using ECMAScript Modules (ESM) -# Note: This is only available for Node v18.19.0 onwards. node --import ./instrument.mjs app.mjs ```