You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: MIGRATION.md
+15-15
Original file line number
Diff line number
Diff line change
@@ -9,10 +9,10 @@ These docs walk through how to migrate our JavaScript SDKs through different maj
9
9
10
10
# Upgrading from 8.x to 9.x
11
11
12
-
Version 9 of the Sentry JavaScript SDK concerns API cleanup and version support changes.
13
-
This update contains behavioral changes that will not be caught by type checkers, linters or tests, so we recommend carefully reading through the entire migration guide instead of purely relying on automatic tooling.
12
+
Version 9 of the Sentry JavaScript SDK primarily introduces API cleanup and version support changes.
13
+
This update contains behavioral changes that will not be caught by type checkers, linters, or tests, so we recommend carefully reading through the entire migration guide instead of relying on automatic tooling.
14
14
15
-
`v9` of the SDK is compatible with Sentry self-hosted versions 24.4.2 or higher (unchanged from v8).
15
+
Version 9 of the SDK is compatible with Sentry self-hosted versions 24.4.2 or higher (unchanged from v8).
16
16
Lower versions may continue to work, but may not support all features.
17
17
18
18
## 1. Version Support Changes:
@@ -27,16 +27,16 @@ This includes features like Nullish Coalescing (`??`), Optional Chaining (`?.`),
27
27
If you observe failures due to syntax or features listed above, it may indicate that your current runtime does not support ES2020.
28
28
If your runtime does not support ES2020, we recommend transpiling the SDK using Babel or similar tooling.
29
29
30
-
**Node.js:** The minimum supported Node.js version is **18.0.0**, except for ESM-only SDKs (`@sentry/astro`, `@sentry/nuxt`, `@sentry/sveltekit`) which require Node.js version **18.19.1** or higher.
30
+
**Node.js:** The minimum supported Node.js version is **18.0.0** (Released Apr 19, 2022), except for ESM-only SDKs (`@sentry/astro`, `@sentry/nuxt`, `@sentry/sveltekit`) which require Node.js version **18.19.1** (Released Feb 14, 2024) or higher.
31
31
32
32
**Browsers:** Due to SDK code now including ES2020 features, the minimum supported browser list now looks as follows:
If you need to support older browsers, we recommend transpiling your code using SWC, Babel or similar tooling.
42
42
@@ -54,11 +54,11 @@ Support for the following frameworks and library versions are dropped:
54
54
55
55
### TypeScript Version Policy
56
56
57
-
In preparation for v2 of the OpenTelemetry SDK, which will raise the minimum required TypeScript version, the minimum required TypeScript version is increased to version `5.0.4`.
57
+
In preparation for v2 of the OpenTelemetry SDK, the minimum required TypeScript version is increased to version `5.0.4`.
58
58
59
59
Additionally, like the OpenTelemetry SDK, the Sentry JavaScript SDK will follow [DefinitelyType's version support policy](https://github.com/DefinitelyTyped/DefinitelyTyped#support-window) which has a support time frame of 2 years for any released version of TypeScript.
60
60
61
-
Older Typescript versions _may_ continue to be compatible, but no guarantees apply.
61
+
Older TypeScript versions _may_ continue to be compatible, but no guarantees apply.
62
62
63
63
### AWS Lambda Layer Changes
64
64
@@ -90,7 +90,7 @@ The ARN will be published in the [Sentry docs](https://docs.sentry.io/platforms/
90
90
While in v8, the passed scope was set active directly on the passed scope, in v9, the scope is cloned. This behavior change does not apply to `@sentry/node` where the scope was already cloned.
91
91
This change was made to ensure that the span only remains active within the callback and to align behavior between `@sentry/node` and all other SDKs.
92
92
As a result of the change, span hierarchy should be more accurate.
93
-
However, modifying the scope (e.g. set tags) within the `startSpan` callback behaves a bit differently now.
93
+
However, modifying the scope (for example, setting tags) within the `startSpan` callback behaves a bit differently now.
@@ -101,12 +101,12 @@ The ARN will be published in the [Sentry docs](https://docs.sentry.io/platforms/
101
101
```
102
102
103
103
- Passing `undefined` as a `tracesSampleRate` option value will now be treated the same as if the attribute was not defined at all.
104
-
In previous versions, it was checked whether the `tracesSampleRate` property existed in the SDK options to determine whether to propagate trace data for distributed tracing.
104
+
In previous versions, it was checked whether the `tracesSampleRate` property existed in the SDK options to decide if trace data should be propagated for tracing.
105
105
Consequentially, this sometimes caused the SDK to propagate negative sampling decisions when `tracesSampleRate: undefined` was passed.
106
106
This is no longer the case and sampling decisions will be deferred to downstream SDKs for distributed tracing.
107
107
This is more of a bugfix rather than a breaking change, however, depending on the setup of your SDKs, an increase in sampled traces may be observed.
108
108
109
-
- If you use the optional `captureConsoleIntegration` and set `attachStackTrace: true` in your `Sentry.init` call, console messages will no longer be marked as unhandled (i.e. `handled: false`) but as handled (i.e. `handled: true`).
109
+
- If you use the optional `captureConsoleIntegration` and set `attachStackTrace: true` in your `Sentry.init` call, console messages will no longer be marked as unhandled (`handled: false`) but as handled (`handled: true`).
110
110
If you want to keep sending them as unhandled, configure the `handled` option when adding the integration:
0 commit comments