@sentry-internal/browser-utils - npm Package Versions

8.0.0

The Sentry JS SDK team is proud to announce the release of version 8.0.0 of Sentry's JavaScript SDKs - it's been a long time coming! Thanks to everyone for your patience and a special shout out to the brave souls testing preview builds and reporting issues - we appreciate your support!

How to Upgrade to Version 8:

We recommend reading the migration guide docs to find out how to address any breaking changes in your code for your specific platform or framework.

To automate upgrading to v8 as much as possible, use our migration codemod @sentry/migr8:

npx @sentry/migr8@latest

All deprecations from the v7 cycle, with the exception of getCurrentHub(), have been removed and can no longer be used in v8. If you have an advanced Sentry SDK setup, we additionally recommend reading the in-depth migration guide in our repo which highlights all changes with additional details and information.

The rest of this changelog highlights the most important (breaking) changes and links to more detailed information.

Version Support

With v8, we dropped support for several old runtimes and browsers

Node SDKs: The Sentry JavaScript SDK v8 now supports Node.js 14.8.0 or higher. This applies to @sentry/node and all of our node-based server-side sdks (@sentry/nextjs, @sentry/remix, etc.). Furthermore, version 8 now ships with full support for ESM-based node apps using Node.js 18.19.0 or higher.

Browser SDKs: The browser SDKs now require ES2018+ compatible browsers. New minimum browser versions:

• Chrome 71
• Edge 79
• Safari 12.1, iOS Safari 12.2
• Firefox 65
• Opera 58
• Samsung Internet 10

For more details, please see the version support section in our migration guide.

Initializing Server-side SDKs (Node, Bun, Deno, Serverless):

In v8, we support a lot more node-based packages than before. In order to ensure auto-instrumentation works, the SDK now needs to be imported and initialized before any other import in your code.

We recommend creating a new file (e.g. instrumentation.js) to import and initialize the SDK. Then, import the file on top of your entry file or detailed instructions, check our updated SDK setup docs initializing the SDK in v8.

Performance Monitoring Changes

The API around performance monitoring and tracing has been streamlined, and we've added support for more integrations out of the box.

• Performance Monitoring API
• Performance Monitoring Integrations

Functional Integrations

Integrations are now simple functions instead of classes. Class-based integrations have been removed:

// old (v7)
Sentry.init({
  integrations: [new Sentry.BrowserTracing()],
});

// new (v8)
Sentry.init({
  integrations: [Sentry.browserTracingIntegration()],
});

Package removal

The following packages have been removed or replaced and will no longer be published:

• @sentry/hub
• @sentry/tracing
• @sentry/integrations
• @sentry/serverless
• @sentry/replay

Changes since 8.0.0-rc.3

• feat(nextjs): Remove transpileClientSDK (#11978)

  As we are dropping support for Internet Explorer 11 and other other older browser versions wih version 8.0.0, we are also removing the transpileClientSDK option from the Next.js SDK. If you need to support these browser versions, please configure Webpack and Next.js to down-compile the SDK.

• feat(serverless): Do not include performance integrations by default (#11998)

  To keep Lambda bundle size reasonable, the SDK no longer ships with all performance (database) integrations by default. Add the Sentry integrations of the databases and other tools you're using manually to your Sentry.init call by following this guide. Note that this change does not apply if you use the SDK with the Sentry AWS Lambda layer.

• feat(feedback): Simplify public css configuration for feedback (#11985)

• fix(feedback): Check for empty user (#11993)

• fix(replay): Fix type for replayCanvasIntegration (#11995)

• fix(replay): Fix user activity not being updated in start() (#12001)

8.0.0-rc.2

Important Changes

• feat(node): Register ESM patching hooks in init for supported Node.js versions

This release includes adds support for ESM when Sentry.init() is called within a module imported via the --import Node.js flag:

node --import ./your-file-with-sentry-init.mjs your-app.mjs

Note that the SDK only supports ESM for node versions 18.19.0 and above, and 20.6.0 above.

Other Changes

• deps(node): Bump @opentelemetry/core to 1.24.1 and @opentelemetry/instrumentation to 0.51.1 (#11941)
• feat(connect): Warn if connect is not instrumented (#11936)
• feat(express): Warn if express is not instrumented (#11930)
• feat(fastify): Warn if fastify is not instrumented (#11917)
• feat(hapi): Warn if hapi is not instrumented (#11937)
• feat(koa): Warn if koa is not instrumented (#11931)
• fix(browser): Continuously record CLS web vital (#11934)
• fix(feedback): Pick user from any scope (#11928)
• fix(node): Fix cron instrumentation and add tests (#11811)

8.0.0-rc.1

This release contains no changes and was done for technical purposes. This version is considered stable.

For the sake of completeness this changelog entry includes the changes from the previous release candidate:

We recommend to read the detailed migration guide in the docs.

Important Changes

• feat(node): Support hapi v21 & fix E2E test (#11906)

We now support hapi v21 and added tests for it.

• feat(node): Warn if ESM mode is detected (#11914)

When running Sentry in ESM mode, we will now warn you that this is not supported as of now. We are working on ensuring support with ESM builds.

Other Changes

• feat(feedback): Iterate on css for better scrolling & resizing when browser is small (#11893)
• fix(node): Ensure prisma integration creates valid DB spans (#11908)
• fix(node): Include loader hook files in package.json (#11911)

8.0.0-rc.0

This is the first release candidate of Sentry JavaScript SDK v8.

We recommend to read the detailed migration guide in the docs.

Important Changes

• feat(node): Support hapi v21 & fix E2E test (#11906)

We now support hapi v21 and added tests for it.

• feat(node): Warn if ESM mode is detected (#11914)

When running Sentry in ESM mode, we will now warn you that this is not supported as of now. We are working on ensuring support with ESM builds.

Other Changes

• feat(feedback): Iterate on css for better scrolling & resizing when browser is small (#11893)
• fix(node): Ensure prisma integration creates valid DB spans (#11908)
• fix(node): Include loader hook files in package.json (#11911)

8.0.0-beta.6

This beta release contains various bugfixes and improvements for the v8 beta cycle.

• feat: Add tunnel support to multiplexed transport (#11806)
• feat: Export spanToBaggageHeader utility (#11881)
• feat(browser): Disable standalone http.client spans (#11879)
• feat(ember): Update ember dependencies (#11753)
• feat(fedback): Convert CDN bundles to use async feedback for lower bundle sizes (#11791)
• feat(feedback): Add captureFeedback method (#11428)
• feat(feedback): Have screenshot by default (#11839)
• feat(integrations): Add zod integration (#11144)
• feat(ioredis): Add integration for ioredis (#11856)
• feat(nextjs): Add transaction name to scope of server component (#11850)
• feat(nextjs): Be smarter in warning about old ways of init configuration (#11882)
• feat(nextjs): Set transaction names on scope for route handlers and generation functions (#11869)
• feat(node): Support Node 22 (#11871)
• fix(angular): Run tracing calls outside Angular (#11748)
• fix(feedback): Be consistent about whether screenshot should and can render (#11859)
• fix(nestjs): Ensure Nest.js interceptor works with non-http context (#11880)
• fix(node): Fix nest.js error handler (#11874)
• fix(react): Fix react router v4/v5 instrumentation (#11855)
• ref: Add geo location types (#11847)

8.0.0-beta.5

This beta release contains various bugfixes and improvements for the v8 beta cycle.

Important Changes

• feat(svelte): Add Svelte 5 support (#11807)

We now officially support Svelte 5.

• feat(browser): Send standalone fetch and XHR spans if there's no active parent span (#11783)

Starting with this version, spans for outgoing fetch/xhr requests will be captured even if no pageload/navigation span is ongoing. This means that you will be able to have a more complete trace, especially for web applications that make a lot of HTTP requests on longer lived pages.

Other Changes

• feat(astro): Add transactionName to isolation scope for requests (#11786)
• feat(browser): Create standalone INP spans via startInactiveSpan (#11788)
• feat(core): Add trace envelope header to span envelope (#11699)
• feat(core): Add options to start standalone (segment) spans via start*Span APIs (#11696)
• feat(core): Set default scope for BaseClient methods (#11775)
• feat(core): Wrap cron withMonitor callback in withIsolationScope (#11797)
• feat(feedback): New feedback button design (#11641)
• feat(nextjs): Add transactionName to isolation scope for Next.js server side features (#11782)
• feat(nextjs): Mute webpack warnings about critical dependencies inside @opentelemetry/instrumentation (#11810)
• feat(node): Upgrade @prisma/instrumentation to 5.13.0 (#11779)
• feat(react): type error as unknown in ErrorBoundary (#11819)
• feat(remix): Add wrapHandleErrorWithSentry (#10370)
• feat(remix): Set formData as action span data. (#10836)
• feat(remix): Update scope transactionName for Remix server features (#11784)
• fix(angular): Call showReportDialog in root context (#11703)
• fix(core): Capture only failed console.assert calls (#11799)
• fix(ember): Ensure unnecessary spans are avoided (#11846)
• fix(feedback): Clarify the difference between createWidget and create Form in the feedback public api (#11838)
• fix(feedback): Fix feedback type (#11787)
• fix(feedback): Vendor preact into bundle (#11845)
• fix(remix): Rethrow loader, action and documentRequest errors (#11793)
• ref: Always return an immediately generated event ID from captureException(), captureMessage(), and captureEvent() (#11805)
• ref(core): Remove transaction name extraction from requestDataIntegration (#11513)
• ref(svelte): Use onlyIfParent for recording component update spans (#11809)

8.0.0-beta.4

Important Changes

• feat(browser): Add INP support for v8 (#11650)

INP web vital support was now forward-ported to version 8. Recording of INP data is enabled by default.

• feat(core): Increase default transport buffer size from 30 to 64 (#11764)

The default limit of queued events to be sent was increased from 30 to 64 events. You may observe a higher memory footprint of the SDK. You can override this limit by setting the transportOptions.bufferSize option in Sentry.init().

• feat(replay): Add "maxCanvasSize" option for replay canvases (#11617)

A maxCanvasSize option was added to the replayCanvasIntegration to disallow capturing of canvases larger than a certain size. This value defaults to 1280 which will not capture canvases bigger than 1280x1280 pixels.

Other Changes

• deps: Downgrade @opentelemetry/instrumentation-http to 0.48.0 (#11745)
• deps(nextjs): Remove unnecessary and faulty @opentelemetry/api dependency from Next.js package (#11717)
• feat(aws): Add OTEL based integrations (#11548)
• feat(core): Ensure trace context only includes relevant data (#11713)
• feat(deps): Bump @opentelemetry/instrumentation-fastify from 0.33.0 to 0.35.0 (#11690)
• feat(deps): Bump @opentelemetry/instrumentation-graphql from 0.37.0 to 0.39.0 (#11692)
• feat(deps): Bump @opentelemetry/instrumentation-http from 0.48.0 to 0.50.0 (#11725)
• feat(deps): Bump @opentelemetry/instrumentation-mongoose from 0.35.0 to 0.37.0 (#11693)
• feat(deps): Bump @opentelemetry/instrumentation-mysql2 from 0.35.0 to 0.37.0 (#11726)
• feat(deps): Bump @opentelemetry/instrumentation-nestjs-core from 0.34.0 to 0.36.0 (#11727)
• feat(deps): Bump @opentelemetry/sdk-metrics from 1.21.0 to 1.23.0 (#11695)
• feat(deps): Bump @prisma/instrumentation from 5.9.0 to 5.12.1 (#11724)
• feat(feedback): Create async bundles and code to resolve helper integrations (#11621)
• feat(nextjs): Sample out low-quality spans on older Next.js versions (#11722)
• feat(opentelemetry): Support new http method attribute (#11756)
• feat(opentelemetry): Use rest args for addOpenTelemetryInstrumentation (#11721)
• feat(replay): Upgrade rrweb packages to 2.15.0 (#11736)
• fix(browser): Ensure lazyLoadIntegration works in NPM mode (#11673)
• fix(browser): Set custom sentry source correctly (#11735)
• fix(ember): Do not create rendering spans without transaction (#11749)
• fix(serverless): Check if cloud event callback is a function (#9044) (#11701)
• ref(nextjs): Remove unnecessary logic to filter symbolification/sentry spans (#11714)

8.0.0-beta.3

Important Changes

• feat(opentelemetry): Add addOpenTelemetryInstrumentation (#11667)

A utility function addOpenTelemetryInstrumentation was added that allows for the registration of instrumentations that conform to the OpenTelemetry JS API without having to specify @opentelemetry/instrumentation as a dependency.

• ref(core): Don't start transaction for trpc middleware (#11697)

Going forward, the Sentry trpcMiddleware will only create spans. Previously it used to always create a transaction. This change was made to integrate more nicely with the HTTP instrumentation added in earlier versions to avoid creating unnecessary transactions.

Other Changes

• feat(nextjs): Instrument outgoing http requests (#11685)
• feat(opentelemetry): Remove setupGlobalHub (#11668)
• fix: Missing ErrorEvent export are added to node, browser, bun, deno, vercel-edge sub-packages (#11649)
• fix(nextjs): Do not sample next spans if they have remote parent (#11680)
• fix(nextjs): Re-enable OTEL fetch instrumentation and disable Next.js fetch instrumentation (#11686)
• fix(node): Ensure DSC on envelope header uses root span (#11683)
• ref(browser): Streamline pageload span creation and scope handling (#11679)
• ref(core): Directly use endSession (#11669)

8.0.0-beta.2

Important Changes

• feat(browser): Update propagationContext on spanEnd to keep trace consistent

To ensure consistency throughout a route's duration, we update the scope's propagation context when the initial page load or navigation span ends. This keeps span-specific attributes like the sampled decision and dynamic sampling context on the scope, even after the transaction has ended.

• fix(browser): Don't assume window.document is available (#11602)

We won't assume window.dodument is available in the browser SDKs anymore. This should prevent errors in environments where window.document is not available (such as web workers).

Other changes

• feat(core): Add server.address to browser http.client spans (#11634)
• feat(opentelemetry): Update OTEL packages & relax some version ranges (#11580)
• feat(deps): bump @opentelemetry/instrumentation-hapi from 0.34.0 to 0.36.0 (#11496)
• feat(deps): bump @opentelemetry/instrumentation-koa from 0.37.0 to 0.39.0 (#11495)
• feat(deps): bump @opentelemetry/instrumentation-pg from 0.38.0 to 0.40.0 (#11494)
• feat(nextjs): Skip OTEL root spans emitted by Next.js (#11623)
• feat(node): Collect Local Variables via a worker (#11586)
• fix(nextjs): Escape Next.js' OpenTelemetry instrumentation (#11625)
• fix(feedback): Fix timeout on feedback submission (#11619)
• fix(node): Allow use of NodeClient without calling init (#11585)
• fix(node): Ensure DSC is correctly set in envelope headers (#11628)