@@ -24,18 +24,18 @@ stable release of `8.x` comes out).
24
24
to ` @sentry/node ` and all of our node-based server-side sdks (` @sentry/nextjs ` , ` @sentry/serverless ` , etc.). We no
25
25
longer test against Node 8, 10, or 12 and cannot guarantee that the SDK will work as expected on these versions.
26
26
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
28
28
browsers. This means that we no longer support IE11 (end of an era). This also means that the Browser SDK requires the
29
29
fetch API to be available in the environment.
30
30
31
31
New minimum supported browsers:
32
32
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
39
39
40
40
For IE11 support please transpile your code to ES5 using babel or similar and add required polyfills.
41
41
@@ -49,6 +49,7 @@ We've removed the following packages:
49
49
- [ @sentry/tracing ] ( ./MIGRATION.md#sentrytracing )
50
50
- [ @sentry/integrations ] ( ./MIGRATION.md#sentryintegrations )
51
51
- [ @sentry/serverless ] ( ./MIGRATION.md#sentryserverless )
52
+ - [ @sentry/replay ] ( ./MIGRATION.md#sentryreplay )
52
53
53
54
#### @sentry/hub
54
55
@@ -217,6 +218,20 @@ Sentry.init({
217
218
});
218
219
```
219
220
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
+
220
235
## 3. Performance Monitoring Changes
221
236
222
237
- [ 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
350
365
- [ Astro SDK] ( ./MIGRATION.md#astro-sdk )
351
366
- [ AWS Serverless SDK] ( ./MIGRATION.md#aws-serverless-sdk )
352
367
- [ Ember SDK] ( ./MIGRATION.md#ember-sdk )
368
+ - [ Svelte SDK] ( ./MIGRATION.md#svelte-sdk )
353
369
354
370
### General
355
371
356
372
Removed top-level exports: ` tracingOrigins ` , ` MetricsAggregator ` , ` metricsAggregatorIntegration ` , ` Severity ` ,
357
373
` Sentry.configureScope ` , ` Span ` , ` spanStatusfromHttpCode ` , ` makeMain ` , ` lastEventId ` , ` pushScope ` , ` popScope ` ,
358
- ` addGlobalEventProcessor ` , ` timestampWithMs ` , ` addExtensionMethods `
374
+ ` addGlobalEventProcessor ` , ` timestampWithMs ` , ` addExtensionMethods ` , ` addGlobalEventProcessor ` , ` getActiveTransaction `
359
375
360
376
Removed ` @sentry/utils ` exports: ` timestampWithMs ` , ` addOrUpdateIntegration ` , ` tracingContextFromHeaders ` , ` walk `
361
377
@@ -370,6 +386,7 @@ Removed `@sentry/utils` exports: `timestampWithMs`, `addOrUpdateIntegration`, `t
370
386
- [ Removal of ` addGlobalEventProcessor ` in favour of ` addEventProcessor ` ] ( ./MIGRATION.md#removal-of-addglobaleventprocessor-in-favour-of-addeventprocessor )
371
387
- [ Removal of ` lastEventId() ` method] ( ./MIGRATION.md#deprecate-lasteventid )
372
388
- [ 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 )
373
390
374
391
#### Deprecation of ` Hub ` and ` getCurrentHub() `
375
392
@@ -540,7 +557,7 @@ addGlobalEventProcessor(event => {
540
557
541
558
``` js
542
559
// v8
543
- addEventProcessor (event => {
560
+ Sentry . getGlobalScope (). addEventProcessor (event => {
544
561
delete event .extra ;
545
562
return event ;
546
563
});
@@ -569,6 +586,26 @@ interface Transport {
569
586
}
570
587
```
571
588
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
+
572
609
### Browser SDK (Browser, React, Vue, Angular, Ember, etc.)
573
610
574
611
Removed top-level exports: ` Offline ` , ` makeXHRTransport ` , ` BrowserTracing ` , ` wrap `
@@ -577,6 +614,8 @@ Removed top-level exports: `Offline`, `makeXHRTransport`, `BrowserTracing`, `wra
577
614
- [ Removal of Offline integration] ( ./MIGRATION.md#removal-of-the-offline-integration )
578
615
- [ Removal of ` makeXHRTransport ` transport] ( ./MIGRATION.md#removal-of-makexhrtransport-transport )
579
616
- [ 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 )
580
619
581
620
#### Removal of the ` BrowserTracing ` integration
582
621
@@ -605,6 +644,10 @@ requires at least Angular 14. If you are using Angular 13 or lower, we suggest u
605
644
migrating to v8. If you can't upgrade your Angular version to at least Angular 14, you can also continue using the
606
645
` @sentry/angular-ivy@7 ` SDK. However, v7 of the SDKs will no longer be fully supported going forward.
607
646
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
+
608
651
### Server-side SDKs (Node, Deno, Bun, etc.)
609
652
610
653
Removed top-level exports: ` enableAnrDetection ` , ` Anr ` , ` deepReadDirSync `
@@ -891,7 +934,7 @@ replacement API.
891
934
892
935
### Ember SDK
893
936
894
- Removed top-level exports: ` InitSentryForEmber `
937
+ Removed top-level exports: ` InitSentryForEmber ` , ` StartTransactionFunction `
895
938
896
939
- [ Removal of ` InitSentryForEmber ` export] ( ./MIGRATION.md#removal-of-initsentryforember-export )
897
940
@@ -900,13 +943,51 @@ Removed top-level exports: `InitSentryForEmber`
900
943
The ` InitSentryForEmber ` export has been removed. Instead, you should use the ` Sentry.init ` method to initialize the
901
944
SDK.
902
945
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
+
903
982
## 5. Behaviour Changes
904
983
905
984
- [ Updated behaviour of ` tracePropagationTargets ` in the browser] ( ./MIGRATION.md#updated-behaviour-of-tracepropagationtargets-in-the-browser-http-tracing-headers--cors )
906
985
- [ Updated behaviour of ` extraErrorDataIntegration ` ] ( ./MIGRATION.md#extraerrordataintegration-changes )
907
986
- [ Updated behaviour of ` transactionContext ` passed to ` tracesSampler ` ] ( ./MIGRATION.md#transactioncontext-no-longer-passed-to-tracessampler )
908
987
- [ Updated behaviour of ` getClient() ` ] ( ./MIGRATION.md#getclient-always-returns-a-client )
909
988
- [ 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 )
910
991
911
992
#### Updated behaviour of ` tracePropagationTargets ` in the browser (HTTP tracing headers & CORS)
912
993
@@ -1593,7 +1674,7 @@ Sentry.init({
1593
1674
## Replay options changed (since 7.35.0) - #6645
1594
1675
1595
1676
Some 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.
1597
1678
1598
1679
## Renaming of Next.js wrapper methods (since 7.31.0) - #6790
1599
1680
@@ -1631,4 +1712,4 @@ This release deprecates `@sentry/hub` and all of it's exports. All of the `@sent
1631
1712
# Upgrading Sentry Replay (beta, 7.24.0)
1632
1713
1633
1714
For 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