@sentry/replay - npm Package Versions

8.0.0-alpha.4

This is the fourth Alpha release of the v8 cycle, which includes a variety of breaking changes.

Read the in-depth migration guide to find out how to address any breaking changes in your code.

Important Changes

• feat: Set required node version to >=14.18.0 for all packages (#10968)

The minimum Node version required for the SDK is now 14.18.0.

• Serverless SDK Changes
  • feat(google-cloud): Add @sentry/google-cloud package (#10993)
  • feat(v8): Add @sentry/aws-serverless package (#11052)
  • feat(v8): Rename gcp package to @sentry/google-cloud-serverless (#11065)

@sentry/serverless is no longer published, and is replaced by two new packages: @sentry/google-cloud-serverless and @sentry/aws-serverless. These packages are now the recommended way to instrument serverless functions. See the migration guide for more details.

• build(bundles): Use ES2017 for bundles (drop ES5 support) (#10911)

The Browser SDK and CDN bundles now emits ES2017 compatible code and drops support for IE11. This also means that the Browser SDKs (@sentry/browser, @sentry/react, @sentry/vue, etc.) requires the fetch API to be available in the environment. If you need to support older browsers, please transpile your code to ES5 using babel or similar and add required polyfills.

New minimum supported browsers:

• Chrome 58
• Edge 15
• Safari/iOS Safari 11
• Firefox 54
• Opera 45
• Samsung Internet 7.2

Removal/Refactoring of deprecated functionality

• feat(browser): Remove IE parser from the default stack parsers (#11035)
• feat(bun/v8): Remove all deprecations from Bun SDK (#10971)
• feat(core): Remove startTransaction export (#11015)
• feat(v8/core): Move addTracingHeadersToFetchRequest and instrumentFetchRequest to core (#10918)
• feat(v8/deno): Remove deprecations from deno SDK (#10972)
• feat(v8/remix): Remove remixRouterInstrumentation (#10933)
• feat(v8/replay): Opt-in options for unmask and unblock (#11049)
• feat(v8/tracing): Delete BrowserTracing class (#10919)
• feat(v8/vercel-edge): Remove vercel-edge sdk deprecations (#10974)
• feat(replay/v8): Delete deprecated replaySession and errorSampleRates (#11045)
• feat(v8): Remove deprecated Replay, Feedback, ReplayCanvas exports (#10814)
• ref: Remove spanRecorder and all related code (#10977)
• ref: Remove deprecated origin field on span start options (#11058)
• ref: Remove deprecated properties from startSpan options (#11054)
• ref(core): Remove startTransaction & finishTransaction hooks (#11008)
• ref(nextjs): Remove sentry field in Next.js config as a means of configuration (#10839)
• ref(nextjs): Remove last internal deprecations (#11019)
• ref(react): Streamline browser tracing integrations & remove old code (#11012)
• ref(svelte): Remove startChild deprecations (#10956)
• ref(sveltekit): Update trace propagation & span options (#10838)
• ref(v8/angular): Remove instrumentAngularRouting and fix tests (#11021)

Other Changes

• feat: Ensure getRootSpan() does not rely on transaction (#10979)
• feat: Export getSpanDescendants() everywhere (#10924)
• feat: Make ESM output valid Node ESM (#10928)
• feat: Remove tags from spans & transactions (#10809)
• feat(angular): Update scope transactionName when route is resolved (#11043)
• feat(angular/v8): Change decorator naming and add name parameter (#11057)
• feat(astro): Update @sentry/astro to use OpenTelemetry (#10960)
• feat(browser): Remove HttpContext integration class (#10987)
• feat(browser): Use idle span for browser tracing (#10957)
• feat(build): Allow passing Sucrase options for rollup (#10747)
• feat(build): Core packages into single output files (#11030)
• feat(core): Allow custom tracing implementations (#11003)
• feat(core): Allow metrics aggregator per client (#10949)
• feat(core): Decouple scope.transactionName from root spans (#10991)
• feat(core): Ensure trace APIs always return a span (#10942)
• feat(core): Implement startIdleSpan (#10934)
• feat(core): Move globals to __SENTRY__ singleton (#11034)
• feat(core): Move more scope globals to __SENTRY__ (#11074)
• feat(core): Undeprecate setTransactionName (#10966)
• feat(core): Update continueTrace to be callback-only (#11044)
• feat(core): Update spanToJSON to handle OTEL spans (#10922)
• feat(deps): bump @sentry/cli from 2.29.1 to 2.30.0 (#11024)
• feat(feedback): New feedback integration with screenshots (#10590)
• feat(nextjs): Bump Webpack Plugin to version 2 and rework config options (#10978)
• feat(nextjs): Support Hybrid Cloud DSNs with tunnelRoute option (#10959)
• feat(node): Add setupFastifyErrorHandler utility (#11061)
• feat(node): Rephrase wording in http integration JSDoc (#10947)
• feat(opentelemetry): Do not use SentrySpan & Transaction classes (#10982)
• feat(opentelemetry): Remove hub from context (#10983)
• feat(opentelemetry): Use core getRootSpan functionality (#11004)
• feat(profiling-node): Refactor deprecated methods & non-hook variant (#10984)
• feat(react): Update scope's transactionName in React Router instrumentations (#11048)
• feat(remix): Refactor to use new performance APIs (#10980)
• feat(remix): Update remix SDK to be OTEL-powered (#11031)
• feat(sveltekit): Export unstable_sentryVitePluginOptions for full Vite plugin customization (#10930)
• feat(v8/bun): Update @sentry/bun to use OTEL node (#10997)
• fix(ember): Ensure browser tracing is correctly lazy loaded (#11026)
• fix(nextjs): Use passthrough createReduxEnhancer on server (#11005)
• fix(node): Add missing core re-exports (#10931)
• fix(node): Correct SDK name (#10961)
• fix(node): Do not assert in vendored proxy code (#11011)
• fix(node): Export spotlightIntegration from OTEL node (#10973)
• fix(node): support undici headers as strings or arrays (#10938)
• fix(opentelemetry): Fix span & sampling propagation (#11092)
• fix(react): Passes the fallback function through React's createElement function (#10623)
• fix(react): Set handled value in ErrorBoundary depending on fallback (#10989)
• fix(types): Add addScopeListener to Scope interface (#10952)
• fix(types): Add AttachmentType and use for envelope attachment_type property (#10946)
• fix(types): Remove usage of allowSyntheticDefaultImports (#11073)
• fix(v8/utils): Stack parser skip frames (not lines of stack string) (#10560)
• ref(angular): Refactor usage of startChild (#11056)
• ref(browser): Store browser metrics as attributes instead of tags (#10823)
• ref(browser): Update scope.transactionName on pageload and navigation span creation (#10992)
• ref(browser): Update browser metrics to avoid deprecations (#10943)
• ref(browser): Update browser profiling to avoid deprecated APIs (#11007)
• ref(feedback): Move UserFeedback type into feedback.ts (#11032)
• ref(nextjs): Clean up browser tracing integration (#11022)
• ref(node-experimental): Refactor usage of startChild() (#11047)
• ref(node): Use new performance APIs in legacy http & undici (#11055)
• ref(opentelemetry): Remove parent span map (#11014)
• ref(opentelemetry): Remove span metadata handling (#11020)

Work in this release contributed by @MFoster and @jessezhang91. Thank you for your contributions!

8.0.0-alpha.3

This alpha was released in an incomplete state. We recommend skipping this release and using the 8.0.0-alpha.4 release instead.

8.0.0-alpha.2

This alpha release fixes a build problem that prevented 8.0.0-alpha.1 from being properly released.

Important Changes

• feat: Remove @sentry/opentelemetry-node package (#10906)

The @sentry/opentelemetry-node package has been removed. Instead, you can either use @sentry/node with built-in OpenTelemetry support, or use @sentry/opentelemetry to manually connect Sentry with OpenTelemetry.

Removal/Refactoring of deprecated functionality

• ref: Refactor some deprecated startSpan options (#10825)
• feat(v8/core): remove void from transport return (#10794)
• ref(integrations): Delete deprecated class integrations (#10887)

Other Changes

• feat(core): Use serialized spans in transaction event (#10912)
• feat(deps): bump @sentry/cli from 2.28.6 to 2.29.1 (#10908)
• feat(node): Allow to configure skipOpenTelemetrySetup (#10907)
• feat(esm): Import rather than require inspector (#10910)
• fix(browser): Don't use chrome variable name (#10874)
• chore(sveltekit): Fix punctuation in a console.log (#10895)
• fix(opentelemetry): Ensure DSC propagation works correctly (#10904)
• feat(browser): Exclude span exports from non-performance CDN bundles (#10879)
• ref: Refactor span status handling to be OTEL compatible (#10871)
• feat(core): Fix span scope handling & transaction setting (#10886)
• ref(ember): Avoid namespace import to hopefully resolve minification issue (#10885)

Work in this release contributed by @harish-talview & @bfontaine. Thank you for your contributions!

8.0.0-alpha.1

This is the first Alpha release of the v8 cycle, which includes a variety of breaking changes.

Read the in-depth migration guide to find out how to address any breaking changes in your code.

Important Changes

- feat(node): Make @sentry/node powered by OpenTelemetry (#10762)

The biggest change is the switch to use OpenTelemetry under the hood in @sentry/node. This brings with it a variety of changes:

• There is now automated performance instrumentation for Express, Fastify, Nest.js and Koa. You can remove any performance and request isolation code you previously wrote manually for these frameworks.
• All performance instrumention is enabled by default, and will only take effect if the instrumented package is used. You don't need to use autoDiscoverNodePerformanceMonitoringIntegrations() anymore.
• You need to ensure to call Sentry.init() before you import any other packages. Otherwise, the packages cannot be instrumented:

const Sentry = require('@sentry/node');
Sentry.init({
  dsn: '...',
  // ... other config here
});
// now require other things below this!
const http = require('http');
const express = require('express');
// ....

• Currently, we only support CJS-based Node application out of the box. There is experimental ESM support, see the instructions.
• startTransaction and span.startChild() are no longer supported. This is due to the underlying change to OpenTelemetry powered performance instrumentation. See docs on the new performance APIs for details.

Related changes:

• feat(node-experimental): Add missing re-exports (#10679)
• feat(node-experimental): Move defaultStackParser & getSentryRelease (#10722)
• feat(node-experimental): Move errorHandler (#10728)
• feat(node-experimental): Move cron code over (#10742)
• feat(node-experimental): Move integrations from node (#10743)
• feat(node-experimental): Properly set request & session on http requests (#10676)
• feat(opentelemetry): Support forceTransaction in OTEL (#10807)
• feat(opentelemetry): Align span options with core span options (#10761)
• feat(opentelemetry): Do not capture span events as breadcrumbs (#10612)
• feat(opentelemetry): Ensure DSC & attributes are correctly set (#10806)
• feat(opentelemetry): Fix & align isolation scope usage in node-experimental (#10570)
• feat(opentelemetry): Merge node-experimental changes into opentelemetry (#10689)
• ref(node-experimental): Cleanup re-exports (#10741)
• ref(node-experimental): Cleanup tracing intergations (#10730)
• ref(node-experimental): Copy transport & client to node-experimental (#10720)
• ref(node-experimental): Remove custom isInitialized (#10607)
• ref(node-experimental): Remove custom hub & scope (#10616)
• ref(node-experimental): Remove deprecated class integrations (#10675)
• ref(node-experimental): Rename errorHandler to expressErrorHandler (#10746)
• ref(node-integration-tests): Migrate to new Http integration (#10765)
• ref(node): Align semantic attribute handling (#10827)

- feat: Remove @sentry/integrations package (#10799)

This package is no longer published. You can instead import these pluggable integrations directly from your SDK package (e.g. @sentry/browser or @sentry/react).

- feat: Remove @sentry/hub package (#10783)

This package is no longer published. You can instead import directly from your SDK package (e.g. @sentry/react or @sentry/node).

- feat(v8): Remove @sentry/tracing (#10625)

This package is no longer published. You can instead import directly from your SDK package (e.g. @sentry/react or @sentry/node).

- feat: Set required node version to >=14.8.0 for all packages (#10834)

The minimum required node version is now 14.8+. If you need support for older node versions, you can stay on the v7 branch.

- Removed class-based integrations

We have removed most of the deprecated class-based integrations. Instead, you can use the functional styles:

import * as Sentry from '@sentry/browser';
// v7
Sentry.init({
  integrations: [new Sentry.BrowserTracing()],
});
// v8
Sentry.init({
  integrations: [new Sentry.browserTracingIntegration()],
});

• ref: Remove BrowserTracing (#10653)
• feat(v8/node): Remove LocalVariables class integration (#10558)
• feat(v8/react): Delete react router exports (#10532)
• feat(v8/vue): Remove all deprecated exports from vue (#10533)
• feat(v8/wasm): Remove deprecated exports (#10552)

- feat(v8/browser): Remove XHR transport (#10703)

We have removed the XHR transport, and are instead using the fetch-based transport now by default. This means that if you are using Sentry in a browser environment without fetch, you'll need to either provide a fetch polyfill, or provide a custom transport to Sentry.

- feat(sveltekit): Update @sentry/vite-plugin to 2.x and adjust options API (#10813)

We have updated @sentry/sveltekit to use the latest version of @sentry/vite-plugin, which lead to changes in configuration options.

Other Changes

• feat: Ensure withActiveSpan is exported everywhere (#10878)
• feat: Allow passing null to withActiveSpan (#10717)
• feat: Implement new Async Context Strategy (#10647)
• feat: Remove hub from global, hub.run & hub utilities (#10718)
• feat: Update default trace propagation targets logic in the browser (#10621)
• feat: Ignore ResizeObserver and undefined error (#10845)
• feat(browser): Export getIsolationScope and getGlobalScope (#10658)
• feat(browser): Prevent initialization in browser extensions (#10844)
• feat(core): Add metric summaries to spans (#10554)
• feat(core): Decouple metrics aggregation from client (#10628)
• feat(core): Lookup client on current scope, not hub (#10635)
• feat(core): Make setXXX methods set on isolation scope (#10678)
• feat(core): Make custom tracing methods return spans & set default op (#10633)
• feat(core): Make global addBreadcrumb write to the isolation scope instead of current scope (#10586)
• feat(core): Remove health check transaction filters (#10818)
• feat(core): Streamline custom hub creation for node-experimental (#10555)
• feat(core): Update addEventProcessor to add to isolation scope (#10606)
• feat(core): Update Sentry.addBreadcrumb to skip hub (#10601)
• feat(core): Use global TextEncoder and TextDecoder (#10701)
• feat(deps): bump @sentry/cli from 2.26.0 to 2.28.0 (#10496)
• feat(deps): bump @sentry/cli from 2.28.0 to 2.28.5 (#10620)
• feat(deps): bump @sentry/cli from 2.28.5 to 2.28.6 (#10727)
• feat(integrations): Capture error arguments as exception regardless of level in captureConsoleIntegration (#10744)
• feat(metrics): Remove metrics method from BaseClient (#10789)
• feat(node): Remove unnecessary URL imports (#10860)
• feat(react): Drop support for React 15 (#10115)
• feat(remix): Add Vite dev-mode support to Express instrumentation. (#10784)
• fix: Export session API (#10711)
• fix(angular-ivy): Add exports field to package.json (#10569)
• fix(angular): Ensure navigations always create a transaction (#10646)
• fix(core): Add lost scope tests & fix update case (#10738)
• fix(core): Fix scope capturing via captureContext function (#10735)
• fix(feedback): Replay breadcrumb for feedback events was incorrect (#10536)
• fix(nextjs): Remove webpack:// prefix more broadly from source map sources field (#10642)
• fix(node): import worker_threads and fix node v14 types (#10791)
• fix(node): Record local variables with falsy values, null and undefined (#10821)
• fix(stacktrace): Always use ? for anonymous function name (#10732)
• fix(sveltekit): Avoid capturing Http 4xx errors on the client (#10571)
• fix(sveltekit): Ensure navigations and redirects always create a new transaction (#10656)
• fix(sveltekit): Properly await sourcemaps flattening (#10602)
• fix(types): Improve attachment type (#10832)
• fx(node): Fix anr worker check (#10719)
• ref: Cleanup browser profiling integration (#10766)
• ref: Collect child spans references via non-enumerable on Span object (#10715)
• ref: Make scope setters on hub only write to isolation scope (#10572)
• ref: Store runtime on isolation scope (#10657)
• ref(astro): Put request as SDK processing metadata instead of span data (#10840)
• ref(core): Always use a (default) ACS (#10644)
• ref(core): Make on and emit required on client (#10603)
• ref(core): Make remaining client methods required (#10605)
• ref(core): Rename Span class to SentrySpan (#10687)
• ref(core): Restructure hub exports (#10639)
• ref(core): Skip hub in top level captureXXX methods (#10688)
• ref(core): Allow number as span traceFlag (#10855)
• ref(core): Remove status field from Span (#10856)
• ref(remix): Make @remix-run/router a dependency. (#10479)
• ref(replay): Use beforeAddBreadcrumb hook instead of scope listener (#10600)
• ref(sveltekit): Hard-pin Vite plugin version (#10843)

Other Deprecation Removals/Changes

We have also removed or updated a variety of deprecated APIs.

• feat(v8): Remove extractTraceparentData export (#10559)
• feat(v8): Remove defaultIntegrations deprecated export (#10691)
• feat(v8): Remove deprecated span.isSuccess method (#10699)
• feat(v8): Remove deprecated traceHeaders method (#10776)
• feat(v8): Remove deprecated addInstrumentationHandler (#10693)
• feat(v8): Remove deprecated configureScope call (#10565)
• feat(v8): Remove deprecated runWithAsyncContext API (#10780)
• feat(v8): Remove deprecated spanStatusfromHttpCode export (#10563)
• feat(v8): Remove deprecated trace and startActiveSpan methods (#10593)
• feat(v8): Remove requestData deprecations (#10626)
• feat(v8): Remove Severity enum (#10551)
• feat(v8): Remove span.origin (#10753)
• feat(v8): Remove span.toTraceparent method (#10698)
• feat(v8): Remove usage of span.description and span.name (#10697)
• feat(v8): Update eventFromUnknownInput to only use client (#10692)
• feat(v8/astro): Remove deprecated exports from Astro SDK (#10611)
• feat(v8/browser): Remove _eventFromIncompleteOnError usage (#10553)
• feat(v8/browser): Remove XHR transport (#10703)
• feat(v8/browser): Rename TryCatch integration to browserApiErrorsIntegration (#10755)
• feat(v8/core): Remove deprecated setHttpStatus (#10774)
• feat(v8/core): Remove deprecated updateWithContext method (#10800)
• feat(v8/core): Remove getters for span.op (#10767)
• feat(v8/core): Remove span.finish call (#10773)
• feat(v8/core): Remove span.instrumenter and instrumenter option (#10769)
• feat(v8/ember): Remove deprecated exports (#10535)
• feat(v8/integrations): Remove deprecated exports (#10556)
• feat(v8/node): Remove deepReadDirSync export (#10564)
• feat(v8/node): Remove deprecated anr methods (#10562)
• feat(v8/node): Remove getModuleFromFilename export (#10754)
• feat(core): Remove deprecated props from Span interface (#10854)
• fix(v8): Remove deprecated tracing config (#10870)
• ref: Make setupOnce optional in integrations (#10729)
• ref: Migrate transaction source from metadata to attributes (#10674)
• ref: Refactor remaining makeMain usage (#10713)
• ref(astro): Remove deprecated Replay and BrowserTracing (#10768)
• feat(core): Remove deprecated scope.applyToEvent() method (#10842)
• ref(integrations): Remove offline integration (#9456)
• ref(nextjs): Remove all deprecated API (#10549)
• ref: Remove lastEventId (#10585)
• ref: Remove reuseExisting option for ACS (#10645)
• ref: Remove tracingOrigins options (#10614)
• ref: Remove deprecated showReportDialog APIs (#10609)
• ref: Remove usage of span tags (#10808)
• ref: Remove user segment (#10575)

7.x

A full list of changes in the 7.x release of the SDK can be found in the 7.x Changelog.

6.x

A full list of changes in the 6.x release of the SDK can be found in the 6.x Changelog.

5.x

A full list of changes in the 5.x release of the SDK can be found in the 5.x Changelog.

4.x

A full list of changes in the 4.x release of the SDK can be found in the 4.x Changelog.