sentry-javascript

Important Changes

• feat: Mark errors caught by the SDK as unhandled
  • feat(browser): Mark errors caught from TryCatch integration as unhandled (#8890)
  • feat(integrations): Mark errors caught from HttpClient and CaptureConsole integrations as unhandled (#8891)
  • feat(nextjs): Mark errors caught from NextJS wrappers as unhandled (#8893)
  • feat(react): Mark errors captured from ErrorBoundary as unhandled (#8914)
  • feat(remix): Mark errors caught from Remix instrumentation as unhandled (#8894)
  • feat(serverless): Mark errors caught in Serverless handlers as unhandled (#8907)
  • feat(vue): Mark errors caught by Vue wrappers as unhandled (#8905)

This release fixes inconsistent behaviour of when our SDKs classify captured errors as unhandled.
Previously, some of our instrumentations correctly set unhandled, while others set handled.
Going forward, all errors caught automatically from our SDKs will be marked as unhandled.
If you manually capture errors (e.g. by calling Sentry.captureException), your errors will continue to be reported as handled.

This change might lead to a decrease in reported crash-free sessions and consequently in your release health score.
If you have concerns about this, feel free to open an issue.

Other Changes

• feat(node-experimental): Implement new performance APIs (#8911)
• feat(node-experimental): Sync OTEL context with Sentry AsyncContext (#8797)
• feat(replay): Allow to configure maxReplayDuration (#8769)
• feat(remix): Add debugid injection and map deletion to sourcemaps script (#8814)
• fix(browser): Add replay and profiling options to BrowserClientOptions (#8921)
• fix(browser): Check for existence of instrumentation targets (#8939)
• fix(nextjs): Don't re-export default in route handlers (#8924)
• fix(node): Improve mysql integration (#8923)
• fix(remix): Guard against missing default export for server instrument (#8909)
• ref(browser): Deprecate top-level wrap function (#8927)
• ref(node-otel): Avoid exporting internals & refactor attribute adding (#8920)

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

Bundle size 📦

Important Changes

• feat(replay): Upgrade to rrweb2.0

This should be fully backwards compatible with previously recorded replays. Only breaking change is that we will not be masking aria-label by default. This is to better support searching by clicks. Another issue is there is about a 13% bundle size increase, however this comes with improved performance and improved replay fidelity especially in regards to web components.

Bundle size 📦

• fix: Defer tracing decision to downstream SDKs when using SDK without performance (#8839)
• fix(nextjs): Fix package.json exports (#8895)
• fix(sveltekit): Ensure target file exists before applying auto instrumentation (#8881)
• ref: Use consistent console instrumentation (#8879)
• ref(browser): Refactor sentry breadcrumb to use hook (#8892)
• ref(tracing): Add origin to spans (#8765)

Bundle size 📦

Important Changes

• feat(replay): Upgrade to rrweb2.0

This should be fully backwards compatible with previously recorded replays. Only breaking change is that we will not be masking aria-label by default. This is to better support searching by clicks. Another issue is there is about a 13% bundle size increase, however this comes with improved performance and improved replay fidelity especially in regards to web components.

Bundle size 📦

• build: Remove build-specific polyfills (#8809)
• build(deps): bump protobufjs from 6.11.3 to 6.11.4 (#8822)
• deps(sveltekit): Bump @sentry/vite-plugin (#8877)
• feat(core): Introduce Sentry.startActiveSpan and Sentry.startSpan (#8803)
• fix: Memoize AsyncLocalStorage instance (#8831)
• fix(nextjs): Check for validity of API route handler signature (#8811)
• fix(nextjs): Fix requestAsyncStorageShim path resolution on windows (#8875)
• fix(node): Log entire error object in OnUncaughtException (#8876)
• fix(node): More relevant warning message when tracing extensions are missing (#8820)
• fix(replay): Streamline session creation/refresh (#8813)
• fix(sveltekit): Avoid invalidating data on route changes in wrapServerLoadWithSentry (#8801)
• fix(tracing): Better guarding for performance observer (#8872)
• ref(sveltekit): Remove custom client fetch instrumentation and use default instrumentation (#8802)
• ref(tracing-internal): Deprecate tracePropagationTargets in BrowserTracing (#8874)

Bundle size 📦

Important Changes

• feat(replay): Upgrade to rrweb2.0

This should be fully backwards compatible with previously recorded replays. Only breaking change is that we will not be masking aria-label by default. This is to better support searching by clicks. Another issue is there is about a 13% bundle size increase, however this comes with improved performance and improved replay fidelity especially in regards to web components.

Bundle size 📦

• feat(core): Add setMeasurement export (#8791)
• fix(nextjs): Check for existence of default export when wrapping pages (#8794)
• fix(nextjs): Ensure imports are valid relative paths (#8799)
• fix(nextjs): Only re-export default export if it exists (#8800)

Bundle size 📦

Important Changes

• feat(replay): Upgrade to rrweb2.0

This should be fully backwards compatible with previously recorded replays. Only breaking change is that we will not be masking aria-label by default. This is to better support searching by clicks. Another issue is there is about a 13% bundle size increase, however this comes with improved performance and improved replay fidelity especially in regards to web components.

Bundle size 📦

• build(deps): bump @opentelemetry/instrumentation from 0.41.0 to 0.41.2
• feat(eventbuilder): Export exceptionFromError for use in hybrid SDKs (#8766)
• feat(node-experimental): Re-export from node (#8786)
• feat(tracing): Add db connection attributes for mysql spans (#8775)
• feat(tracing): Add db connection attributes for postgres spans (#8778)
• feat(tracing): Improve data collection for mongodb spans (#8774)
• fix(nextjs): Execute sentry config independently of autoInstrumentServerFunctions and autoInstrumentAppDirectory (#8781)
• fix(replay): Ensure we do not flush if flush took too long (#8784)
• fix(replay): Ensure we do not try to flush when we force stop replay (#8783)
• fix(replay): Fix hasCheckout handling (#8782)
• fix(replay): Handle multiple clicks in a short time (#8773)
• ref(replay): Skip events being added too long after initial segment (#8768)

Bundle size 📦

Important Changes

• feat(integrations): Add ContextLines integration for html-embedded JS stack frames (#8699)

This release adds the ContextLines integration as an optional integration for the Browser SDKs to @sentry/integrations.

This integration adds source code from inline JavaScript of the current page's HTML (e.g. JS in <script> tags) to stack traces of captured errors.
It can't collect source code from assets referenced by your HTML (e.g. <script src="..." />).

The ContextLines integration is useful when you have inline JS code in HTML pages that can't be accessed by Sentry's backend, for example, due to a login-protected page.

import { ContextLines } from "@sentry/integrations";

Sentry.init({
  // ...
  integrations: [
    new ContextLines({
      // The number of lines to collect before and after each stack frame's line number
      // Defaults to 7
      frameContextLines: 7,
    }),
  ],
});

Other Changes

• fix(nextjs): Make all wrappers isomorphic and available in all runtimes (#8743)
• fix(replay): Cancel debounce when replay is too short/long (#8742)
• fix(utils): dirname and basename should handle Windows paths (#8737)
• ref: Hoist flush, close, and lastEventId into @sentry/core (#8731)
• ref(node): Don't call JSON.stringify on prisma client when logging (#8745)

Bundle size 📦

• feat(nextjs): Add AsyncLocalStorage async context strategy to edge SDK (#8720)
• fix(core): Filter internal API frames for synthetic frames (#8710)
• fix(integrations): Capture exception if any arg to console method is an error (#8671)
• fix(node-experimental): Update auto integration lookup & readme (#8690)
• fix(node): Add availablility check on current hub to Node ContextLines integration (#8715)
• fix(replay): Ensure buffer sessions end after capturing an error (#8713)
• fix(replay): Ensure buffer->session switch is reliable (#8712)
• fix(replay): Ensure we debounce flush if replay too short (#8716)
• fix(replay): Improve capture of errorIds/traceIds (#8678)
• fix(tracing): Set correct parent span id on fetch sentry-trace header (#8687)
• fix(utils): Avoid pre_context and context_line overlap if frame lineno is out of bounds (#8722)
• ref(replay): Improve status logging (#8709)
• ref(nextjs): Allow withSentryConfig to accept async config function (#8721)

Bundle size 📦

Important Changes

• feat(node-experimental): Add @sentry/node-experimental package as MVP for POTEL (#8609)

This introduces a new, experimental package, @sentry/node-experimental.
This is a variant of the Node SDK which uses OpenTelemetry under the hood for performance instrumentation.

Note that this package is very much WIP, considered unstable and may change at any time.
No SemVer guarantees apply whatsoever. Still, if you're brave enough you can give it a try.
Read more about @sentry/node-experimental

Other Changes

• fix(node): Don't set extra baggage headers (#8657)
• fix(tracing): Trim idle transaction spans if they exceed final timeout (#8653)

Bundle size 📦

• fix(nextjs): Match folder paths with trailing separator (#8615)
• fix(replay): Ignore clicks with shift pressed (#8648)
• fix(replay): Use session.started for min/max duration check (#8617)

Bundle size 📦

Important Changes

• feat(replay): Ensure min/max duration when flushing (#8596)

We will not send replays that are <5s long anymore. Additionally, we also added further safeguards to avoid overly long (>1h) replays.
You can optionally configure the min. replay duration (defaults to 5s):

new Replay({
  minReplayDuration: 10000 // in ms - note that this is capped at 15s max!
})

Other Changes

• fix(profiling): Align to SDK selected time origin (#8599)
• fix(replay): Ensure multi click has correct timestamps (#8591)
• fix(utils): Truncate aggregate exception values (LinkedErrors) (#8593)

Bundle size 📦

• fix(browser): 0 is a valid index (#8581)
• fix(nextjs): Ensure Webpack plugin is available after dynamic require (#8584)
• types(browser): Add browser profiling client options (#8565)

Bundle size 📦

No changes. This release was published to fix publishing issues with 7.59.0 and 7.59.1.
Please see 7.59.0 for the changes in that release.

Bundle size 📦

No changes. This release was published to fix a publishing issue with 7.59.0. Please see 7.59.0 for the changes in that release.

Bundle size 📦

Important Changes

• feat(remix): Add Remix v2 support (#8415)

This release adds support for Remix v2 future flags, in particular for the new error handling utilities of Remix v2. We recommend you switch to using v2_errorBoundary future flag to get the best error handling experience with Sentry.

To capture errors from v2 client-side ErrorBoundary, you should define your own ErrorBoundary in root.tsx and use Sentry.captureRemixErrorBoundaryError helper to capture the error.

// root.tsx
import { captureRemixErrorBoundaryError } from "@sentry/remix";

export const ErrorBoundary: V2_ErrorBoundaryComponent = () => {
  const error = useRouteError();

  captureRemixErrorBoundaryError(error);

  return <div> ... </div>;
};

For server-side errors, define a handleError function in your server entry point and use the Sentry.captureRemixServerException helper to capture the error.

// entry.server.tsx
export function handleError(
  error: unknown,
  { request }: DataFunctionArgs
): void {
  if (error instanceof Error) {
    Sentry.captureRemixServerException(error, "remix.server", request);
  } else {
    // Optionally capture non-Error objects
    Sentry.captureException(error);
  }
}

For more details, see the Sentry Remix SDK documentation.

Other Changes

• feat(core): Add ModuleMetadata integration (#8475)
• feat(core): Allow multiplexed transport to send to multiple releases (#8559)
• feat(tracing): Add more network timings to http calls (#8540)
• feat(tracing): Bring http timings out of experiment (#8563)
• fix(nextjs): Avoid importing SentryWebpackPlugin in dev mode (#8557)
• fix(otel): Use HTTP_URL attribute for client requests (#8539)
• fix(replay): Better session storage check (#8547)
• fix(replay): Handle errors in beforeAddRecordingEvent callback (#8548)
• fix(tracing): Improve network.protocol.version (#8502)

Bundle size 📦

• fix(nextjs): Avoid importing SentryWebpackPlugin in dev mode (#8543)

Bundle size 📦

• feat(replay): Re-sample sessions after they expire #8407

This pre-release contains a revamped replay session expiration handling.
Now, when a session expires (because it ran for too long), we will always
re-sample the session, and may start another one (or start buffering) based on the sample rates.

Bundle size 📦