sentry-javascript

Important Changes

• feat(tracing): Add interactions sample rate to browser tracing integrations (#11382)

You can now use a interactionsSampleRate to control the sample rate of INP spans. interactionsSampleRate is applied
on top of the global tracesSampleRate. Therefore if interactionsSampleRate is 0.5 and tracesSampleRate is 0.1,
then the actual sample rate for interactions is 0.05.

Sentry.init({
  tracesSampleRate: 0.1,
  integrations: [
    Sentry.browserTracingIntegration({
      interactionsSampleRate: 0.5,
    }),
  ],
});

• Deprecations

This release deprecates the Hub class, as well as the addRequestDataToTransaction method. The trpcMiddleware
method is no longer on the Handlers export, but instead is a standalone export.

Please see the detailed Migration docs on how to migrate to the new APIs.

• feat: Deprecate and relocate trpcMiddleware (#11389)
• feat(core): Deprecate Hub class (#11528)
• feat(types): Deprecate Hub interface (#11530)
• ref: Deprecate addRequestDataToTransaction (#11368)

Other Changes

• feat(core): Update metric normalization (#11519)
• feat(feedback): Customize feedback placeholder text color (#11521)
• feat(remix): Skip span creation for OPTIONS and HEAD request. (#11485)
• feat(utils): Add metric buckets rate limit (#11506)
• fix(core): unref timer to not block node exit (#11483)
• fix(metrics): Map statsd to metric_bucket (#11505)
• fix(spans): Allow zero exclusive time for INP spans (#11408)
• ref(feedback): Configure feedback fonts (#11520)

Bundle size 📦

This is the eighth alpha release of Sentry JavaScript SDK v8, 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: Add @sentry-internal/browser-utils (#11381)

A big part of the browser-runtime specific exports of the internal @sentry/utils package were moved into a new package
@sentry-internal/browser-utils. If you imported any API from @sentry/utils (which is generally not recommended but
necessary for some workarounds), please check that your import statements still point to existing exports after
upgrading.

• feat: Add loader file to node-based SDKs to support ESM monkeypatching (#11338)

When using ESM, it is necessary to use a "loader" to be able to instrument certain third-party packages and Node.js API.
The server-side SDKs now ship with a set of ESM loader hooks, that should be used when using ESM. Use them as follows:

# For Node.js <= 18.18.2
node --experimental-loader=@sentry/node/hook your-app.js

# For Node.js >= 18.19.0
node --import=@sentry/node/register your-app.js

Please note that due to an upstream bug, these loader hooks will currently crash or simply not work. We are planning to
fix this in upcoming versions of the SDK - definitely before a stable version 8 release.

• feat(node): Add Koa error handler (#11403)
• feat(node): Add NestJS error handler (#11375)

The Sentry SDK now exports integrations and error middlewares for Koa (koaIntegration(), setupKoaErrorHandler()) and
NestJS (setupNestErrorHandler()) that can be used to instrument your Koa and NestJS applications with error
monitoring.

Removal/Refactoring of deprecated functionality

• feat(core): Remove hub check in isSentryRequestUrl (#11407)
• feat(opentelemetry): Remove top level startActiveSpan (#11380)
• feat(types): beforeSend and beforeSendTransaction breaking changes (#11354)
• feat(v8): Remove all class based integrations (#11345)
• feat(v8/core): Remove span.attributes top level field (#11378)
• ref: Remove convertIntegrationFnToClass (#11343)
• ref(node): Remove the old node package (#11322)
• ref(tracing): Remove span.startChild() (#11376)
• ref(v8): Remove addRequestDataToTransaction util (#11369)
• ref(v8): Remove args on HandlerDataXhr (#11373)
• ref(v8): Remove getGlobalObject utility method (#11372)
• ref(v8): Remove metadata on transaction (#11397)
• ref(v8): Remove pushScope, popScope, isOlderThan, shouldSendDefaultPii from hub (#11404)
• ref(v8): Remove shouldCreateSpanForRequest from vercel edge options (#11371)
• ref(v8): Remove deprecated _reportAllChanges option (#11393)
• ref(v8): Remove deprecated scope.getTransaction() (#11365)
• ref(v8): Remove deprecated methods on scope (#11366)
• ref(v8): Remove deprecated span & transaction properties (#11400)
• ref(v8): Remove Transaction concept (#11422)

Other Changes

• feat: Add trpcMiddleware back to serverside SDKs (#11374)
• feat: Implement timed events & remove transaction.measurements (#11398)
• feat(browser): Bump web-vitals to 3.5.2 (#11391)
• feat(feedback): Add getFeedback utility to get typed feedback instance (#11331)
• feat(otel): Do not sample options and head requests (#11467)
• feat(remix): Update scope transactionName when resolving route (#11420)
• feat(replay): Bump rrweb to 2.12.0 (#11314)
• feat(replay): Use data sentry element as fallback for the component name (#11383)
• feat(sveltekit): Update scope transactionName when pageload route name is updated (#11406)
• feat(tracing-internal): Reset propagation context on navigation (#11401)
• feat(types): Add View Hierarchy types (#11409)
• feat(utils): Use globalThis (#11351)
• feat(vue): Update scope's transactionName when resolving a route (#11423)
• fix(core): unref timer to not block node exit (#11430)
• fix(node): Fix baggage propagation (#11363)
• fix(web-vitals): Check for undefined navigation entry (#11311)
• ref: Set preserveModules to true for browser packages (#11452)
• ref(core): Remove duplicate logic in scope.update (#11384)
• ref(feedback): Add font family style to actor (#11432)
• ref(feedback): Add font family to buttons (#11414)
• ref(gcp-serverless): Remove setting .__sentry_transaction (#11346)
• ref(nextjs): Replace multiplexer with conditional exports (#11442)

Bundle size 📦

This release deprecates some exports from the @sentry/replay package. These exports have been moved to the browser SDK
(or related framework SDKs like @sentry/react).

• feat(feedback): Make "required" text for input elements configurable (#11287)
• feat(node): Add scope to ANR events (#11267)
• feat(replay): Bump rrweb to 2.12.0 (#11317)
• fix(node): Local variables skipped after Promise (#11248)
• fix(node): Skip capturing Hapi Boom error responses (#11324)
• fix(web-vitals): Check for undefined navigation entry (#11312)
• ref(replay): Deprecate @sentry/replay exports (#11242)

Work in this release contributed by @soerface. Thank you for your contribution!

Bundle size 📦

This is the seventh alpha release of Sentry JavaScript SDK v8, 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(nextjs): Use OpenTelemetry for performance monitoring and tracing (#11016)

We now use OpenTelemetry under the hood to power performance monitoring and tracing in the Next.js SDK.

• feat(v8/gatsby): Update SDK initialization for gatsby (#11292)

In v8, you cannot initialize the SDK anymore via Gatsby plugin options. Instead, you have to configure the SDK in a
sentry.config.js file.

We also removed the automatic initialization of browserTracingIntegration. You now have to add this integration
yourself.

Removal/Refactoring of deprecated functionality

• feat(v8): Remove addGlobalEventProcessor (#11255)
• feat(v8): Remove deprecated span id fields (#11180)
• feat(v8): Remove makeMain export (#11278)
• feat(v8/core): Remove deprecated span.sampled (#11274)
• feat(v8/core): Remove getActiveTransaction (#11280)
• feat(v8/core): Remove spanMetadata field (#11271)
• feat(v8/ember): Remove deprecated StartTransactionFunction (#11270)
• feat(v8/replay): Remove deprecated replay options (#11268)
• feat(v8/svelte): Remove deprecated componentTrackingPreprocessor export (#11277)
• ref: Remove more usages of getCurrentHub in the codebase (#11281)
• ref(core): Remove scope.setSpan() and scope.getSpan() methods (#11051)
• ref(profiling-node): Remove usage of getCurrentHub (#11275)
• ref(v8): change integration.setupOnce signature (#11238)
• ref: remove node-experimental references (#11290)

Other Changes

• feat(feedback): Make "required" text for input elements configurable (#11152) (#11153)
• feat(feedback): Update user feedback screenshot and cropping to align with designs (#11227)
• feat(nextjs): Remove runtime and vercel tags (#11291)
• feat(node): Add scope to ANR events (#11256)
• feat(node): Do not include prismaIntegration by default (#11265)
• feat(node): Ensure tracePropagationTargets are respected (#11285)
• feat(node): Simplify SentrySpanProcessor (#11273)
• feat(profiling): Use OTEL powered node package (#11239)
• feat(utils): Allow text encoder/decoder polyfill from global SENTRY (#11283)
• fix(nextjs): Show misconfiguration warning (no instrumentation.ts) (#11266)
• fix(node): Add logs when node-fetch cannot be instrumented (#11289)
• fix(node): Skip capturing Hapi Boom error responses. (#11151)
• fix(node): Use suppressTracing to avoid capturing otel spans (#11288)
• fix(opentelemetry): Do not stomp span status when startSpan callback throws (#11170)

Bundle size 📦

This is the fifth alpha release of Sentry JavaScript SDK v8, 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(nextjs): Remove client.(server|client).config.ts functionality in favor of instrumentation.ts (#11059)
  • feat(nextjs): Bump minimum required Next.js version to 13.2.0 (#11097)

With version 8 of the SDK we will no longer support the use of sentry.server.config.ts and sentry.edge.config.ts
files. Instead, please initialize the Sentry Next.js SDK for the serverside in a
Next.js instrumentation hook.
sentry.client.config.ts|js is still supported and encouraged for initializing the clientside SDK. Please see the
Migration Guide for more details.

In addition, the Next.js SDK now requires a minimum Next.js version of 13.2.0.

• feat(v8/angular): Merge angular and angular-ivy packages and start Angular support at v14 (#11091)

The @sentry/angular-ivy package has been removed. The @sentry/angular package now supports Ivy by default and
requires at least Angular 14. See the Migration Guide for more
details.

Removal/Refactoring of deprecated functionality

• feat(aws-serverless): Remove deprecated rethrowAfterCapture option (#11126)
• feat(node): Remove deprecated/duplicate/unused definitions (#11120)
• feat(v8): Remove deprecated integration methods on client (#11134)
• feat(v8/browser): Remove class export for linked errors (#11129)
• feat(v8/browser): Remove deprecated wrap export (#11127)
• feat(v8/core): Remove deprecated client.setupIntegrations method (#11179)
• feat(v8/core): Remove deprecated integration classes (#11132)
• feat(v8/ember): Remove InitSentryForEmber export (#11202)
• feat(v8/nextjs): Remove usage of class integrations (#11182)
• feat(v8/replay): Delete deprecated types (#11177)
• feat(v8/utils): Remove deprecated util functions (#11143)
• ref(node): Remove class based export for local variable integration (#11128)

Other Changes

• feat(browser): Make fetch the default transport for offline (#11209)
• feat(core): Filter out noisy GoogleTag error by default (#11208)
• feat(deps): Bump @sentry/cli from 2.30.0 to 2.30.2 (#11168)
• feat(nextjs): Prefix webpack plugin log messages with runtime (#11173)
• feat(node-profiling): Output ESM and remove Sentry deps from output (#11135)
• feat(node): Allow Anr worker to be stopped and restarted (#11214)
• feat(node): Support tunnel option for ANR (#11163)
• feat(opentelemetry): Do not capture exceptions for timed events (#11221)
• feat(serverless): Add Node.js 20 to compatible runtimes (#11103)
• feat(sveltekit): Switch to Otel-based @sentry/node package (#11075)
• fix(attachments): Add missing view_hierarchy attachment type (#11197)
• fix(build): Ensure tree shaking works properly for ESM output (#11122)
• fix(feedback): Only allow screenshots in secure contexts (#11188)
• fix(feedback): Reduce force layout in screenshots (#11181)
• fix(feedback): Smoother cropping experience and better UI (#11165)
• fix(feedback): Fix screenshot black bars in Safari (#11233)
• fix(metrics): use correct statsd data category (#11184)
• fix(metrics): use web-vitals ttfb calculation (#11185)
• fix(node): Export initOpenTelemetry (#11158)
• fix(node): Clear ANR timer on stop (#11229)
• fix(node): Time zone handling for cron (#11225)
• fix(node): Use unique variable for ANR context transfer (#11161)
• fix(opentelemetry): Do not stomp span error status (#11169)
• fix(types): Fix incorrect sampled type on Transaction (#11115)

Bundle size 📦

This release fixes issues with Time to First Byte (TTFB) calculation in the SDK that was introduced with 7.95.0. It
also fixes some bugs with Interaction to First Paint (INP) instrumentation. This may impact your Sentry Performance
Score calculation.

• feat(serverless): Add Node.js 20 to compatible runtimes (#11104)
• feat(core): Backport ResizeObserver and googletag default filters (#11210)
• feat(webvitals): Adds event entry names for INP handler. Also guard against empty metric value
• fix(metrics): use correct statsd data category (#11187)
• fix(node): Record local variables with falsy values (v7) (#11190)
• fix(node): Use unique variable for ANR context transfer (v7) (#11162)
• fix(node): Time zone handling for cron (#11225)
• fix(tracing): use web-vitals ttfb calculation (#11231)
• fix(types): Fix incorrect sampled type on Transaction (#11146)
• fix(webvitals): Fix mapping not being maintained properly and sometimes not sending INP spans (#11183)

Work in this release contributed by @quisido and @joshkel. Thank you for your contributions!

Bundle size 📦

This release fixes issues with INP instrumentation with the Next.js SDK and adds support for the enableInp option in
the deprecated BrowserTracing integration for backwards compatibility.

• feat(performance): Port INP span instrumentation to old browser tracing (#11085)
• fix(ember): Ensure browser tracing is correctly lazy loaded (#11027)
• fix(node): Do not assert in vendored proxy code (v7 backport) (#11009)
• fix(react): Set handled value in ErrorBoundary depending on fallback [v7] (#11037)

Bundle size 📦

• fix(nextjs/v7): Use passthrough createReduxEnhancer on server (#11010)

Bundle size 📦

• feat(nextjs): Support Hybrid Cloud DSNs with tunnelRoute option (#10958)
• feat(remix): Add Vite dev-mode support to Express instrumentation (#10811)
• fix(core): Undeprecate setTransactionName
• fix(browser): Don't use chrome variable name (#10874)
• fix(nextjs): Client code should not use Node global (#10925)
• fix(node): support undici headers as strings or arrays (#10938)
• fix(types): Add AttachmentType and use for envelope attachment_type property (#10946)
• ref(ember): Avoid namespace import to hopefully resolve minification issue (#10885)
• chore(sveltekit): Fix punctuation in a console.log (#10895)

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

Bundle size 📦

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!

Bundle size 📦

Important Changes

• feat: Ensure withActiveSpan is exported everywhere (#10877)

You can use the withActiveSpan method to ensure a certain span is the active span in a given callback. This can be
used to create a span as a child of a specific span with the startSpan API methods:

const parentSpan = Sentry.startInactiveSpan({ name: 'parent' });
if (parentSpan) {
  withActiveSpan(parentSpan, () => {
    // This will be a direct child of parentSpan
    const childSpan = Sentry.startInactiveSpan({ name: 'child' });
  });
}

Bundle size 📦

Important Changes

• feat(performance): create Interaction standalone spans on inp events (#10709)

This release adds support for the INP web vital. This is currently only supported for Saas Sentry, and product support
is released with the upcoming 24.3.0 release of self-hosted.

To opt-in to this feature, you can use the enableInp option in the browserTracingIntegration:

Sentry.init({
  integrations: [
    Sentry.browserTracingIntegration({
      enableInp: true,
    });
  ]
})

Other Changes

• feat(feedback): Flush replays when feedback form opens (#10567)
• feat(profiling-node): Expose nodeProfilingIntegration (#10864)
• fix(profiling-node): Fix dependencies to point to current versions (#10861)
• fix(replay): Add errorHandler for replayCanvas integration (#10796)

Bundle size 📦

Important Changes

• feat(core): Allow to pass forceTransaction to startSpan() APIs (#10819)

You can now pass forceTransaction: true to startSpan(), startSpanManual() and startInactiveSpan(). This allows
you to start a span that you want to be a transaction, if possible. Under the hood, the SDK will connect this span to
the running active span (if there is one), but still send the new span as a transaction to the Sentry backend, if
possible, ensuring it shows up as a transaction throughout the system.

Please note that setting this to true does not guarantee that this will be sent as a transaction, but that the SDK
will try to do so. You can enable this flag if this span is important to you and you want to ensure that you can see it
in the Sentry UI.

Other Changes

• fix: Make breadcrumbs option optional in WinterCGFetch integration (#10792)

Bundle size 📦

• fix(performance): Fixes latest route name and source for interactions not updating properly on navigation (#10702)
• fix(tracing): Guard against missing window.location (#10659)
• ref: Make span types more robust (#10660)
• ref(remix): Make @remix-run/router a dependency (v7) (#10779)

Bundle size 📦

• fix: Export session API (#10712)
• fix(core): Fix scope capturing via captureContext function (#10737)

Bundle size 📦

In version 7.101.0 the @sentry/hub package was missing due to a publishing issue. This release contains the package
again.

• fix(nextjs): Remove webpack:// prefix more broadly from source map sources field (#10641)

Bundle size 📦

• feat: Export semantic attribute keys from SDK packages (#10637)
• feat(core): Add metric summaries to spans (#10554)
• feat(core): Deprecate the Hub constructor (#10584)
• feat(core): Make custom tracing methods return spans & set default op (#10633)
• feat(replay): Add getReplay utility function (#10510)
• fix(angular-ivy): Add exports field to package.json (#10569)
• fix(sveltekit): Avoid capturing Http 4xx errors on the client (#10571)
• fix(sveltekit): Properly await sourcemaps flattening (#10602)

Bundle size 📦

This release contains build fixes for profiling-node.

• build(profiling-node): make sure debug build plugin is used #10534
• build: Only run profiling e2e test if bindings have changed #10542
• fix(feedback): Replay breadcrumb for feedback events was incorrect #10536

Bundle size 📦

Important Changes

Deprecations

This release includes some deprecations. For more details please look at our
migration guide.

The deprecation most likely to affect you is the one of BrowserTracing. Instead of new BrowserTracing(), you should
now use browserTracingIntegration(), which will also handle framework-specific instrumentation out of the box for
you - no need to pass a custom routingInstrumentation anymore. For @sentry/react, we expose dedicated integrations
for the different react-router versions:

• reactRouterV6BrowserTracingIntegration()
• reactRouterV5BrowserTracingIntegration()
• reactRouterV4BrowserTracingIntegration()
• reactRouterV3BrowserTracingIntegration()

See the
migration guide
for details.

• feat(angular): Export custom browserTracingIntegration() (#10353)
• feat(browser): Deprecate BrowserTracing integration (#10493)
• feat(browser): Export browserProfilingIntegration (#10438)
• feat(bun): Export bunServerIntegration() (#10439)
• feat(nextjs): Add browserTracingIntegration (#10397)
• feat(react): Add reactRouterV3BrowserTracingIntegration for react router v3 (#10489)
• feat(react): Add reactRouterV4/V5BrowserTracingIntegration for react router v4 & v5 (#10488)
• feat(react): Add reactRouterV6BrowserTracingIntegration for react router v6 & v6.4 (#10491)
• feat(remix): Add custom browserTracingIntegration (#10442)
• feat(node): Expose functional integrations to replace classes (#10356)
• feat(vercel-edge): Replace WinterCGFetch with winterCGFetchIntegration (#10436)
• feat: Deprecate non-callback based continueTrace (#10301)
• feat(vue): Deprecate new VueIntegration() (#10440)
• feat(vue): Implement vue browserTracingIntegration() (#10477)
• feat(sveltekit): Add custom browserTracingIntegration() (#10450)

Profiling Node

@sentry/profiling-node has been ported into the monorepo. Future development for it will happen here!

• pkg(profiling-node): port profiling-node repo to monorepo (#10151)

Other Changes

• feat: Export setHttpStatus from all packages (#10475)
• feat(bundles): Add pluggable integrations on CDN to Sentry namespace (#10452)
• feat(core): Pass name & attributes to tracesSampler (#10426)
• feat(feedback): Add system-ui to start of font family (#10464)
• feat(node-experimental): Add koa integration (#10451)
• feat(node-experimental): Update opentelemetry packages (#10456)
• feat(node-experimental): Update tracing integrations to functional style (#10443)
• feat(replay): Bump rrweb to 2.10.0 (#10445)
• feat(replay): Enforce masking of credit card fields (#10472)
• feat(utils): Add propagationContextFromHeaders (#10313)
• fix: Make startSpan, startSpanManual and startInactiveSpan pick up the scopes at time of creation instead of
  termination (#10492)
• fix(feedback): Fix logo color when colorScheme is "system" (#10465)
• fix(nextjs): Do not report redirects and notFound calls as errors in server actions (#10474)
• fix(nextjs): Fix navigation tracing on app router (#10502)
• fix(nextjs): Apply server action data to correct isolation scope (#10514)
• fix(node): Use normal require call to import Undici (#10388)
• ref(nextjs): Remove internally used deprecated APIs (#10453)
• ref(vue): use startInactiveSpan in tracing mixin (#10406)

Bundle size 📦

Important Changes

Deprecations

This release includes some deprecations for span related methods and integrations in our Deno SDK, @sentry/deno. For
more details please look at our
migration guide.

• feat(core): Deprecate Span.setHttpStatus in favor of setHttpStatus (#10268)
• feat(core): Deprecate spanStatusfromHttpCode in favour of getSpanStatusFromHttpCode (#10361)
• feat(core): Deprecate StartSpanOptions.origin in favour of passing attribute (#10274)
• feat(deno): Expose functional integrations to replace classes (#10355)

Other Changes

• feat(bun): Add missing @sentry/node re-exports (#10396)
• feat(core): Add afterAllSetup hook for integrations (#10345)
• feat(core): Ensure startSpan() can handle spans that require parent (#10386)
• feat(core): Read propagation context off scopes in startSpan APIs (#10300)
• feat(remix): Export missing @sentry/node functions (#10385, #10391)
• feat(serverless): Add missing @sentry/node re-exports (#10390)
• feat(sveltekit): Add more missing @sentry/node re-exports (#10392)
• feat(tracing): Export proper type for browser tracing (#10411)
• feat(tracing): Expose new browserTracingIntegration (#10351)
• fix: Ensure afterAllSetup is called when using addIntegration() (#10372)
• fix(core): Export spanToTraceContext function from span utils (#10364)
• fix(core): Make FunctionToString integration use SETUP_CLIENTS weakmap (#10358)
• fix(deno): Call function if client is not setup (#10354)
• fix(react): Fix attachReduxState option (#10381)
• fix(spotlight): Use unpatched http.request (#10369)
• fix(tracing): Only create request span if there is active span (#10375)
• ref: Read propagation context off of scope and isolation scope when propagating and applying trace context (#10297)

Work in this release contributed by @AleshaOleg. Thank you for your contribution!

Bundle size 📦