@@ -24,18 +24,18 @@ stable release of `8.x` comes out).
2424to ` @sentry/node ` and all of our node-based server-side sdks (` @sentry/nextjs ` , ` @sentry/serverless ` , etc.). We no
2525longer test against Node 8, 10, or 12 and cannot guarantee that the SDK will work as expected on these versions.
2626
27- ** Browser** : Our browser SDKs (` @sentry/browser ` , ` @sentry/react ` , ` @sentry/vue ` , etc.) now require ES2017 + compatible
27+ ** Browser** : Our browser SDKs (` @sentry/browser ` , ` @sentry/react ` , ` @sentry/vue ` , etc.) now require ES2018 + compatible
2828browsers. This means that we no longer support IE11 (end of an era). This also means that the Browser SDK requires the
2929fetch API to be available in the environment.
3030
3131New minimum supported browsers:
3232
33- - Chrome 58
34- - Edge 15
35- - Safari/iOS Safari 11
36- - Firefox 54
37- - Opera 45
38- - Samsung Internet 7 .2
33+ - Chrome 63
34+ - Edge 79
35+ - Safari/iOS Safari 12
36+ - Firefox 58
37+ - Opera 50
38+ - Samsung Internet 8 .2
3939
4040For IE11 support please transpile your code to ES5 using babel or similar and add required polyfills.
4141
@@ -49,6 +49,7 @@ We've removed the following packages:
4949- [ @sentry/tracing ] ( ./MIGRATION.md#sentrytracing )
5050- [ @sentry/integrations ] ( ./MIGRATION.md#sentryintegrations )
5151- [ @sentry/serverless ] ( ./MIGRATION.md#sentryserverless )
52+ - [ @sentry/replay ] ( ./MIGRATION.md#sentryreplay )
5253
5354#### @sentry/hub
5455
@@ -217,6 +218,20 @@ Sentry.init({
217218});
218219```
219220
221+ #### @sentry/replay
222+
223+ ` @sentry/replay ` has been removed and will no longer be published. You can import replay functionality and the replay
224+ integration directly from the Browser SDK or browser framework-specific packages like ` @sentry/react ` .
225+
226+ ``` js
227+ // v7
228+ import { Replay } from ' @sentry/replay' ;
229+ ```
230+
231+ ``` js
232+ import { replayIntegration } from ' @sentry/browser' ;
233+ ```
234+
220235## 3. Performance Monitoring Changes
221236
222237- [ Initializing the SDK in v8] ( ./MIGRATION.md/#initializing-the-node-sdk )
@@ -350,12 +365,13 @@ To make sure these integrations work properly you'll have to change how you
350365- [ Astro SDK] ( ./MIGRATION.md#astro-sdk )
351366- [ AWS Serverless SDK] ( ./MIGRATION.md#aws-serverless-sdk )
352367- [ Ember SDK] ( ./MIGRATION.md#ember-sdk )
368+ - [ Svelte SDK] ( ./MIGRATION.md#svelte-sdk )
353369
354370### General
355371
356372Removed top-level exports: ` tracingOrigins ` , ` MetricsAggregator ` , ` metricsAggregatorIntegration ` , ` Severity ` ,
357373` Sentry.configureScope ` , ` Span ` , ` spanStatusfromHttpCode ` , ` makeMain ` , ` lastEventId ` , ` pushScope ` , ` popScope ` ,
358- ` addGlobalEventProcessor ` , ` timestampWithMs ` , ` addExtensionMethods `
374+ ` addGlobalEventProcessor ` , ` timestampWithMs ` , ` addExtensionMethods ` , ` addGlobalEventProcessor ` , ` getActiveTransaction `
359375
360376Removed ` @sentry/utils ` exports: ` timestampWithMs ` , ` addOrUpdateIntegration ` , ` tracingContextFromHeaders ` , ` walk `
361377
@@ -370,6 +386,7 @@ Removed `@sentry/utils` exports: `timestampWithMs`, `addOrUpdateIntegration`, `t
370386- [ Removal of ` addGlobalEventProcessor ` in favour of ` addEventProcessor ` ] ( ./MIGRATION.md#removal-of-addglobaleventprocessor-in-favour-of-addeventprocessor )
371387- [ Removal of ` lastEventId() ` method] ( ./MIGRATION.md#deprecate-lasteventid )
372388- [ Remove ` void ` from transport return types] ( ./MIGRATION.md#remove-void-from-transport-return-types )
389+ - [ Remove ` addGlobalEventProcessor ` in favor of ` addEventProcessor ` ] ( ./MIGRATION.md#remove-addglobaleventprocessor-in-favor-of-addeventprocessor )
373390
374391#### Deprecation of ` Hub ` and ` getCurrentHub() `
375392
@@ -540,7 +557,7 @@ addGlobalEventProcessor(event => {
540557
541558``` js
542559// v8
543- addEventProcessor (event => {
560+ Sentry . getGlobalScope (). addEventProcessor (event => {
544561 delete event .extra ;
545562 return event ;
546563});
@@ -569,6 +586,26 @@ interface Transport {
569586}
570587```
571588
589+ #### Remove ` addGlobalEventProcessor ` in favor of ` addEventProcessor `
590+
591+ In v8, we are removing the ` addGlobalEventProcessor ` function in favor of ` addEventProcessor ` .
592+
593+ ``` js
594+ // v7
595+ addGlobalEventProcessor (event => {
596+ delete event .extra ;
597+ return event ;
598+ });
599+ ```
600+
601+ ``` js
602+ // v8
603+ addEventProcessor (event => {
604+ delete event .extra ;
605+ return event ;
606+ });
607+ ```
608+
572609### Browser SDK (Browser, React, Vue, Angular, Ember, etc.)
573610
574611Removed top-level exports: ` Offline ` , ` makeXHRTransport ` , ` BrowserTracing ` , ` wrap `
@@ -577,6 +614,8 @@ Removed top-level exports: `Offline`, `makeXHRTransport`, `BrowserTracing`, `wra
577614- [ Removal of Offline integration] ( ./MIGRATION.md#removal-of-the-offline-integration )
578615- [ Removal of ` makeXHRTransport ` transport] ( ./MIGRATION.md#removal-of-makexhrtransport-transport )
579616- [ Removal of ` wrap ` method] ( ./MIGRATION.md#removal-of-wrap-method )
617+ - [ Removal of ` @sentry/angular-ivy ` package] ( ./MIGRATION.md#removal-of-sentryangular-ivy-package )
618+ - [ Removal of ` @sentry/replay ` package] ( ./MIGRATION.md#removal-of-sentryreplay-package )
580619
581620#### Removal of the ` BrowserTracing ` integration
582621
@@ -605,6 +644,10 @@ requires at least Angular 14. If you are using Angular 13 or lower, we suggest u
605644migrating to v8. If you can't upgrade your Angular version to at least Angular 14, you can also continue using the
606645` @sentry/angular-ivy@7 ` SDK. However, v7 of the SDKs will no longer be fully supported going forward.
607646
647+ #### Removal of ` @sentry/replay ` package
648+
649+ You can import from ` @sentry/browser ` (or from a respective SDK package like ` @sentry/react ` or ` @sentry/vue ` ).
650+
608651### Server-side SDKs (Node, Deno, Bun, etc.)
609652
610653Removed top-level exports: ` enableAnrDetection ` , ` Anr ` , ` deepReadDirSync `
@@ -891,7 +934,7 @@ replacement API.
891934
892935### Ember SDK
893936
894- Removed top-level exports: ` InitSentryForEmber `
937+ Removed top-level exports: ` InitSentryForEmber ` , ` StartTransactionFunction `
895938
896939- [ Removal of ` InitSentryForEmber ` export] ( ./MIGRATION.md#removal-of-initsentryforember-export )
897940
@@ -900,13 +943,51 @@ Removed top-level exports: `InitSentryForEmber`
900943The ` InitSentryForEmber ` export has been removed. Instead, you should use the ` Sentry.init ` method to initialize the
901944SDK.
902945
946+ ### Svelte SDK
947+
948+ Removed top-level exports: ` componentTrackingPreprocessor `
949+
950+ #### Removal of ` componentTrackingPreprocessor ` export
951+
952+ The ` componentTrackingPreprocessor ` export has been removed. You should instead use ` withSentryConfig ` to configure
953+ component tracking.
954+
955+ ``` js
956+ // v7 - svelte.config.js
957+ import { componentTrackingPreprocessor } from ' @sentry/svelte' ;
958+
959+ const config = {
960+ preprocess: [
961+ componentTrackingPreprocessor (),
962+ // ...
963+ ],
964+ // ...
965+ };
966+
967+ export default config ;
968+ ```
969+
970+ ``` js
971+ // v8 - svelte.config.js
972+ import { withSentryConfig } from " @sentry/svelte" ;
973+
974+ const config = {
975+ // Your svelte config
976+ compilerOptions: {... },
977+ };
978+
979+ export default withSentryConfig (config);
980+ ```
981+
903982## 5. Behaviour Changes
904983
905984- [ Updated behaviour of ` tracePropagationTargets ` in the browser] ( ./MIGRATION.md#updated-behaviour-of-tracepropagationtargets-in-the-browser-http-tracing-headers--cors )
906985- [ Updated behaviour of ` extraErrorDataIntegration ` ] ( ./MIGRATION.md#extraerrordataintegration-changes )
907986- [ Updated behaviour of ` transactionContext ` passed to ` tracesSampler ` ] ( ./MIGRATION.md#transactioncontext-no-longer-passed-to-tracessampler )
908987- [ Updated behaviour of ` getClient() ` ] ( ./MIGRATION.md#getclient-always-returns-a-client )
909988- [ Removal of Client-Side health check transaction filters] ( ./MIGRATION.md#removal-of-client-side-health-check-transaction-filters )
989+ - [ Change of Replay default options (` unblock ` and ` unmask ` )] ( ./MIGRATION.md#change-of-replay-default-options-unblock-and-unmask )
990+ - [ Angular Tracing Decorator renaming] ( ./MIGRATION.md#angular-tracing-decorator-renaming )
910991
911992#### Updated behaviour of ` tracePropagationTargets ` in the browser (HTTP tracing headers & CORS)
912993
@@ -1593,7 +1674,7 @@ Sentry.init({
15931674## Replay options changed (since 7.35.0) - #6645
15941675
15951676Some options for replay have been deprecated in favor of new APIs. See
1596- [ Replay Migration docs] ( ./packages/replay/MIGRATION .md#upgrading-replay-from-7340-to-7350 ) for details.
1677+ [ Replay Migration docs] ( ./docs/migration/replay .md#upgrading-replay-from-7340-to-7350---6645 ) for details.
15971678
15981679## Renaming of Next.js wrapper methods (since 7.31.0) - #6790
15991680
@@ -1631,4 +1712,4 @@ This release deprecates `@sentry/hub` and all of it's exports. All of the `@sent
16311712# Upgrading Sentry Replay (beta, 7.24.0)
16321713
16331714For details on upgrading Replay in its beta phase, please view the
1634- [ dedicated Replay MIGRATION docs] ( ./packages/replay/MIGRATION .md ) .
1715+ [ dedicated Replay MIGRATION docs] ( ./docs/migration/replay .md ) .
0 commit comments