Skip to content

Commit 419416a

Browse files
authored
docs(migration): Add TLDR to v7 migration docs (#5041)
1 parent 9782d69 commit 419416a

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

MIGRATION.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,13 @@
33
The main goal of version 7 is to reduce bundle size. This version is breaking because we removed deprecated APIs, upgraded our build tooling, and restructured npm package contents.
44
Below we will outline all the breaking changes you should consider when upgrading.
55

6+
**TL;DR** If you only use basic features of Sentry, or you simply copy & pasted the setup examples from our docs, here's what changed for you:
7+
- Our CDN bundles are now ES6 - you will need to [reconfigure your script tags](#renaming-of-cdn-bundles) if you want to keep supporting ES5 and IE11 on the new SDK version.
8+
- Distributed CommonJS files will be ES6. Use a transpiler if you need to support old node versions.
9+
- We bumped the TypeScript version we generate our types with to 3.8.3. Please check if your TypeScript projects using TypeScript version 3.7 or lower still compile. Otherwise, upgrade your TypeScript version.
10+
- `whitelistUrls` and `blacklistUrls` have been renamed to `allowUrls` and `denyUrls` in the `Sentry.init()` options.
11+
- The `UserAgent` integration is now called `HttpContext`.
12+
613
## Dropping Support for Node.js v6
714

815
Node.js version 6 has reached end of life in April 2019. For Sentry JavaScript SDK version 7, we will no longer be supporting version 6 of Node.js.
@@ -252,7 +259,6 @@ favor of string literals.
252259

253260
### Removed Enums
254261
* The previously deprecated enum `Status` was removed (see [#4891](https://github.com/getsentry/sentry-javascript/pull/4891)).
255-
[This example](#status) explains how to migrate.
256262
* The previously deprecated internal-only enum `RequestSessionStatus` was removed (see
257263
[#4889](https://github.com/getsentry/sentry-javascript/pull/4889)) in favor of string literals.
258264
* The previously deprecated internal-only enum `SessionStatus` was removed (see
@@ -284,6 +290,7 @@ For our efforts to reduce bundle size of the SDK we had to remove and refactor p
284290
- Remove support for Opera browser pre v15.
285291
- Rename `UserAgent` integration to `HttpContext`. (see [#5027](https://github.com/getsentry/sentry-javascript/pull/5027))
286292
- Remove `SDK_NAME` export from `@sentry/browser`, `@sentry/node`, `@sentry/tracing` and `@sentry/vue` packages.
293+
- Removed `eventStatusFromHttpCode` to save on bundle size.
287294

288295
## Sentry Angular SDK Changes
289296

0 commit comments

Comments
 (0)