v8.51.0

Compare Source

Important Changes

• feat(v8/node): Add prismaInstrumentation option to Prisma integration as escape hatch for all Prisma versions (#​15128)

  This release adds a compatibility API to add support for Prisma version 6.
  To capture performance data for Prisma version 6:

  1. Install the @prisma/instrumentation package on version 6.

  2. Pass a new PrismaInstrumentation() instance as exported from @prisma/instrumentation to the prismaInstrumentation option:

     import { PrismaInstrumentation } from '@​prisma/instrumentation';
     
     Sentry.init({
       integrations: [
         prismaIntegration({
           // Override the default instrumentation that Sentry uses
           prismaInstrumentation: new PrismaInstrumentation(),
         }),
       ],
     });

     The passed instrumentation instance will override the default instrumentation instance the integration would use, while the prismaIntegration will still ensure data compatibility for the various Prisma versions.

  3. Remove the previewFeatures = ["tracing"] option from the client generator block of your Prisma schema.

Other Changes

• feat(v8/browser): Add multiplexedtransport.js CDN bundle (#​15046)
• feat(v8/browser): Add Unleash integration (#​14948)
• feat(v8/deno): Deprecate Deno SDK as published on deno.land (#​15121)
• feat(v8/sveltekit): Deprecate fetchProxyScriptNonce option (#​15011)
• fix(v8/aws-lambda): Avoid overwriting root span name (#​15054)
• fix(v8/core): fatal events should set session as crashed (#​15073)
• fix(v8/node/nestjs): Use method on current fastify request (#​15104)

Work in this release was contributed by @​tjhiggins, and @​nwalters512. Thank you for your contributions!

Bundle size 📦

v8.50.0

Compare Source

• feat(v8/react): Add support for React Router createMemoryRouter (#​14985)

Bundle size 📦

v8.49.0

Compare Source

• feat(v8/browser): Flush offline queue on flush and browser online event (#​14969)
• feat(v8/react): Add a handled prop to ErrorBoundary (#​14978)
• fix(profiling/v8): Don't put require, __filename and __dirname on global object (#​14952)
• fix(v8/node): Enforce that ContextLines integration does not leave open file handles (#​14997)
• fix(v8/replay): Disable mousemove sampling in rrweb for iOS browsers (#​14944)
• fix(v8/sveltekit): Ensure source maps deletion is called after source ma… (#​14963)
• fix(v8/vue): Re-throw error when no errorHandler exists (#​14943)

Work in this release was contributed by @​HHK1 and @​mstrokin. Thank you for your contribution!

Bundle size 📦

v8.48.0

Compare Source

Deprecations

• feat(v8/core): Deprecate getDomElement method (#​14799)

  Deprecates getDomElement. There is no replacement.

Other changes

• fix(nestjs/v8): Use correct main/module path in package.json (#​14791)
• fix(v8/core): Use consistent continueTrace implementation in core (#​14819)
• fix(v8/node): Correctly resolve debug IDs for ANR events with custom appRoot (#​14823)
• fix(v8/node): Ensure NODE_OPTIONS is not passed to worker threads (#​14825)
• fix(v8/angular): Fall back to element tagName when name is not provided to TraceDirective (#​14828)
• fix(aws-lambda): Remove version suffix from lambda layer (#​14843)
• fix(v8/node): Ensure express requests are properly handled (#​14851)
• feat(v8/node): Add openTelemetrySpanProcessors option (#​14853)
• fix(v8/react): Use Set as the allRoutes container. (#​14878) (#​14884)
• fix(v8/react): Improve handling of routes nested under path="/" (#​14897)
• feat(v8/core): Add normalizedRequest to samplingContext (#​14903)
• fix(v8/feedback): Avoid lazy loading code for syncFeedbackIntegration (#​14918)

Work in this release was contributed by @​arturovt. Thank you for your contribution!

Bundle size 📦

v8.47.0

Compare Source

• feat(v8/core): Add updateSpanName helper function (#​14736)
• feat(v8/node): Do not overwrite prisma db.system in newer Prisma versions (#​14772)
• feat(v8/node/deps): Bump @​prisma/instrumentation from 5.19.1 to 5.22.0 (#​14755)
• feat(v8/replay): Mask srcdoc iframe contents per default (#​14779)
• ref(v8/nextjs): Fix typo in source maps deletion warning (#​14776)

Work in this release was contributed by @​aloisklink and @​benjick. Thank you for your contributions!

Bundle size 📦

v8.46.0

Compare Source

• feat: Allow capture of more than 1 ANR event [v8] (#​14713)
• feat(node): Detect Railway release name [v8] (#​14714)
• fix: Normalise ANR debug image file paths if appRoot was supplied [v8] (#​14709)
• fix(nuxt): Remove build config from tsconfig (#​14737)

Work in this release was contributed by @​conor-ob. Thank you for your contribution!

Bundle size 📦

v8.45.1

Compare Source

• fix(feedback): Return when the sendFeedback promise resolves (#​14683)

Bundle size 📦

v8.45.0

Compare Source

• feat(core): Add handled option to captureConsoleIntegration (#​14664)
• feat(browser): Attach virtual stack traces to HttpClient events (#​14515)
• feat(replay): Upgrade rrweb packages to 2.31.0 (#​14689)
• fix(aws-serverless): Remove v8 layer as it overwrites the current layer for docs (#​14679)
• fix(browser): Mark stack trace from captureMessage with attachStacktrace: true as synthetic (#​14668)
• fix(core): Mark stack trace from captureMessage with attatchStackTrace: true as synthetic (#​14670)
• fix(core): Set level in server runtime captureException (#​10587)
• fix(profiling-node): Guard invocation of native profiling methods (#​14676)
• fix(nuxt): Inline nitro-utils function (#​14680)
• fix(profiling-node): Ensure profileId is added to transaction event (#​14681)
• fix(react): Add React Router Descendant Routes support (#​14304)
• fix: Disable ANR and Local Variables if debugger is enabled via CLI args (#​14643)

Work in this release was contributed by @​anonrig and @​Zih0. Thank you for your contributions!

v8.44.0

Compare Source

Deprecations

• feat: Deprecate autoSessionTracking (#​14640)

  Deprecates autoSessionTracking.
  To enable session tracking, it is recommended to unset autoSessionTracking and ensure that either, in browser environments
  the browserSessionIntegration is added, or in server environments the httpIntegration is added.

  To disable session tracking, it is recommended to unset autoSessionTracking and to remove the browserSessionIntegration in
  browser environments, or in server environments configure the httpIntegration with the trackIncomingRequestsAsSessions option set to false.

Other Changes

• feat: Reword log message around unsent spans (#​14641)
• feat(opentelemetry): Set response context for http.server spans (#​14634)
• fix(google-cloud-serverless): Update homepage link in package.json (#​14411)
• fix(nuxt): Add unbuild config to not fail on warn (#​14662)

Work in this release was contributed by @​robinvw1. Thank you for your contribution!

v8.43.0

Compare Source

Important Changes

• feat(nuxt): Add option autoInjectServerSentry (no default import()) (#​14553)

  Using the dynamic import() as the default behavior for initializing the SDK on the server-side did not work for every project.
  The default behavior of the SDK has been changed, and you now need to use the --import flag to initialize Sentry on the server-side to leverage full functionality.

  Example with --import:

  node --import ./.output/server/sentry.server.config.mjs .output/server/index.mjs

  In case you are not able to use the --import flag, you can enable auto-injecting Sentry in the nuxt.config.ts (comes with limitations):

  sentry: {
    autoInjectServerSentry: 'top-level-import', // or 'experimental_dynamic-import'
  },

• feat(browser): Adds LaunchDarkly and OpenFeature integrations (#​14207)

  Adds browser SDK integrations for tracking feature flag evaluations through the LaunchDarkly JS SDK and OpenFeature Web SDK:

  import * as Sentry from '@​sentry/browser';
  
  Sentry.init({
    integrations: [
      // Track LaunchDarkly feature flags
      Sentry.launchDarklyIntegration(),
      // Track OpenFeature feature flags
      Sentry.openFeatureIntegration(),
    ],
  });

  • Read more about the Feature Flags feature in Sentry.
  • Read more about the LaunchDarkly SDK Integration.
  • Read more about the OpenFeature SDK Integration.

• feat(browser): Add featureFlagsIntegration for custom tracking of flag evaluations (#​14582)

  Adds a browser integration to manually track feature flags with an API. Feature flags are attached to subsequent error events:

  import * as Sentry from '@​sentry/browser';
  
  const featureFlagsIntegrationInstance = Sentry.featureFlagsIntegration();
  
  Sentry.init({
    // Initialize the SDK with the feature flag integration
    integrations: [featureFlagsIntegrationInstance],
  });
  
  // Manually track a feature flag
  featureFlagsIntegrationInstance.addFeatureFlag('my-feature', true);

• feat(astro): Add Astro 5 support (#​14613)

  With this release, the Sentry Astro SDK officially supports Astro 5.

Deprecations

• feat(nextjs): Deprecate typedef for hideSourceMaps (#​14594)

  The functionality of hideSourceMaps was removed in version 8 but was forgotten to be deprecated and removed.
  It will be completely removed in the next major version.

• feat(core): Deprecate APIs around RequestSessions (#​14566)

  The APIs around RequestSessions are mostly used internally.
  Going forward the SDK will not expose concepts around RequestSessions.
  Instead, functionality around server-side Release Health will be managed in integrations.

Other Changes

• feat(browser): Add browserSessionIntegration (#​14551)
• feat(core): Add raw_security envelope types (#​14562)
• feat(deps): Bump @​opentelemetry/instrumentation from 0.55.0 to 0.56.0 (#​14625)
• feat(deps): Bump @​sentry/cli from 2.38.2 to 2.39.1 (#​14626)
• feat(deps): Bump @​sentry/rollup-plugin from 2.22.6 to 2.22.7 (#​14622)
• feat(deps): Bump @​sentry/webpack-plugin from 2.22.6 to 2.22.7 (#​14623)
• feat(nestjs): Add fastify support (#​14549)
• feat(node): Add @​vercel/ai instrumentation (#​13892)
• feat(node): Add disableAnrDetectionForCallback function (#​14359)
• feat(node): Add trackIncomingRequestsAsSessions option to http integration (#​14567)
• feat(nuxt): Add option autoInjectServerSentry (no default import()) (#​14553)
• feat(nuxt): Add warning when Netlify or Vercel build is discovered (#​13868)
• feat(nuxt): Improve serverless event flushing and scope isolation (#​14605)
• feat(opentelemetry): Stop looking at propagation context for span creation (#​14481)
• feat(opentelemetry): Update OpenTelemetry dependencies to ^1.29.0 (#​14590)
• feat(opentelemetry): Update OpenTelemetry dependencies to 1.28.0 (#​14547)
• feat(replay): Upgrade rrweb packages to 2.30.0 (#​14597)
• fix(core): Decode filename and module stack frame properties in Node stack parser (#​14544)
• fix(core): Filter out unactionable CEFSharp promise rejection error by default (#​14595)
• fix(nextjs): Don't show warning about devtool option (#​14552)
• fix(nextjs): Only apply tracing metadata to data fetcher data when data is an object (#​14575)
• fix(node): Guard against invalid maxSpanWaitDuration values (#​14632)
• fix(react): Match routes with parseSearch option in TanStack Router instrumentation (#​14328)
• fix(sveltekit): Fix git SHA not being picked up for release (#​14540)
• fix(types): Fix generic exports with default (#​14576)

Work in this release was contributed by @​lsmurray. Thank you for your contribution!

v8.42.0

Compare Source

Important Changes

• feat(react): React Router v7 support (library) (#​14513)

  This release adds support for React Router v7 (library mode).
  Check out the docs on how to set up the integration: Sentry React Router v7 Integration Docs

Deprecations

• feat: Warn about source-map generation (#​14533)

  In the next major version of the SDK we will change how source maps are generated when the SDK is added to an application.
  Currently, the implementation varies a lot between different SDKs and can be difficult to understand.
  Moving forward, our goal is to turn on source maps for every framework, unless we detect that they are explicitly turned off.
  Additionally, if we end up enabling source maps, we will emit a log message that we did so.

  With this particular release, we are emitting warnings that source map generation will change in the future and we print instructions on how to prepare for the next major.

• feat(nuxt): Deprecate tracingOptions in favor of vueIntegration (#​14530)

  Currently it is possible to configure tracing options in two places in the Sentry Nuxt SDK:

  • In Sentry.init()
  • Inside tracingOptions in Sentry.init()

  For tree-shaking purposes and alignment with the Vue SDK, it is now recommended to instead use the newly exported vueIntegration() and its tracingOptions option to configure tracing options in the Nuxt SDK:

  // sentry.client.config.ts
  import * as Sentry from '@​sentry/nuxt';
  
  Sentry.init({
    // ...
    integrations: [
      Sentry.vueIntegration({
        tracingOptions: {
          trackComponents: true,
        },
      }),
    ],
  });

Other Changes

• feat(browser-utils): Update web-vitals to v4.2.4 (#​14439)
• feat(nuxt): Expose vueIntegration (#​14526)
• fix(feedback): Handle css correctly in screenshot mode (#​14535)

Bundle size 📦

v8.41.0

Compare Source

Important Changes

• meta(nuxt): Require minimum Nuxt v3.7.0 (#​14473)

  We formalized that the Nuxt SDK is at minimum compatible with Nuxt version 3.7.0 and above.
  Additionally, the SDK requires the implicit nitropack dependency to satisfy version ^2.10.0 and ofetch to satisfy ^1.4.0.
  It is recommended to check your lock-files and manually upgrade these dependencies if they don't match the version ranges.

Deprecations

We are deprecating a few APIs which will be removed in the next major.

The following deprecations will potentially affect you:

• feat(core): Update & deprecate undefined option handling (#​14450)

  In the next major version we will change how passing undefined to tracesSampleRate / tracesSampler / enableTracing will behave.

  Currently, doing the following:

  Sentry.init({
    tracesSampleRate: undefined,
  });

  Will result in tracing being enabled (although no spans will be generated) because the tracesSampleRate key is present in the options object.
  In the next major version, this behavior will be changed so that passing undefined (or rather having a tracesSampleRate key) will result in tracing being disabled, the same as not passing the option at all.
  If you are currently relying on undefined being passed, and and thus have tracing enabled, it is recommended to update your config to set e.g. tracesSampleRate: 0 instead, which will also enable tracing in v9.

  The same applies to tracesSampler and enableTracing.

• feat(core): Log warnings when returning null in beforeSendSpan (#​14433)

  Currently, the beforeSendSpan option in Sentry.init() allows you to drop individual spans from a trace by returning null from the hook.
  Since this API lends itself to creating "gaps" inside traces, we decided to change how this API will work in the next major version.

  With the next major version the beforeSendSpan API can only be used to mutate spans, but no longer to drop them.
  With this release the SDK will warn you if you are using this API to drop spans.
  Instead, it is recommended to configure instrumentation (i.e. integrations) directly to control what spans are created.

  Additionally, with the next major version, root spans will also be passed to beforeSendSpan.

• feat(utils): Deprecate @sentry/utils (#​14431)

  With the next major version the @sentry/utils package will be merged into the @sentry/core package.
  It is therefore no longer recommended to use the @sentry/utils package.

• feat(vue): Deprecate configuring Vue tracing options anywhere else other than through the vueIntegration's tracingOptions option (#​14385)

  Currently it is possible to configure tracing options in various places in the Sentry Vue SDK:

  • In Sentry.init()
  • Inside tracingOptions in Sentry.init()
  • In the vueIntegration() options
  • Inside tracingOptions in the vueIntegration() options

  Because this is a bit messy and confusing to document, the only recommended way to configure tracing options going forward is through the tracingOptions in the vueIntegration().
  The other means of configuration will be removed in the next major version of the SDK.

• feat: Deprecate registerEsmLoaderHooks.include and registerEsmLoaderHooks.exclude (#​14486)

  Currently it is possible to define registerEsmLoaderHooks.include and registerEsmLoaderHooks.exclude options in Sentry.init() to only apply ESM loader hooks to a subset of modules.
  This API served as an escape hatch in case certain modules are incompatible with ESM loader hooks.

  Since this API was introduced, a way was found to only wrap modules that there exists instrumentation for (meaning a vetted list).
  To only wrap modules that have instrumentation, it is recommended to instead set registerEsmLoaderHooks.onlyIncludeInstrumentedModules to true.

  Note that onlyIncludeInstrumentedModules: true will become the default behavior in the next major version and the registerEsmLoaderHooks will no longer accept fine-grained options.

The following deprecations will most likely not affect you unless you are building an SDK yourself:

• feat(core): Deprecate arrayify (#​14405)
• feat(core): Deprecate flatten (#​14454)
• feat(core): Deprecate urlEncode (#​14406)
• feat(core): Deprecate validSeverityLevels (#​14407)
• feat(core/utils): Deprecate getNumberOfUrlSegments (#​14458)
• feat(utils): Deprecate memoBuilder, BAGGAGE_HEADER_NAME, and makeFifoCache ([#​14434](h