@sentry/serverless

Version 7 of the Sentry JavaScript SDK brings a variety of features and fixes including bundle size and performance improvements, brand new integrations, support for the attachments API, and key bug fixes.

This release does not change or remove any top level public API methods (captureException, captureMessage), and only requires changes to certain configuration options or custom clients/integrations/transports.

Note: The v7 version of the JavaScript SDK requires a self-hosted version of Sentry 20.6.0 or higher. If you are using a version of self-hosted Sentry (aka onpremise) older than 20.6.0 then you will need to upgrade.

For detailed overview of all the changes, please see our v7 migration guide.

Breaking Changes

If you are a regular consumer of the Sentry JavaScript SDK you only need to focus on the general items. The internal breaking changes are aimed at libraries that build on top of and extend the JavaScript SDK (like @sentry/electron or @sentry/react-native).

General

• breaking

  Updated CommonJS distributions to use ES6 by default. If you need to support Internet Explorer 11 or old Node.js versions, we recommend using a preprocessing tool like Babel to convert Sentry packages to ES5.

• breaking

  Default bundle.min.js to ES6 instead of ES5. ES5 bundles are still available at bundle.es5.min.js.

• breaking

  Updated build system to use TypeScript 3.8.3

• breaking

  Deprecated Severity enum for bundle size reasons. Please use string literals instead.

• breaking

  Removed critical Severity level.

• breaking

  whitelistUrls and blacklistUrls have been renamed to allowUrls and denyUrls in the Sentry.init() options.

• breaking

  BaseClient and it's child classes now require transport, stackParser, and integrations to be explicitly passed in. This was done to improve tree-shakability.

• breaking

  Updated package distribution structure and stopped distributing CDN bundles through @sentry/* npm packages. See details in our migration docs.

• breaking

  Simplified Transport API. This means custom transports will have to be adjusted accordingly.

• breaking

  Updated how Node Transport Options are passed down.

• breaking

  Start propogating baggage HTTP header alongside sentry-trace header to propogate additional tracing related information.

• breaking

  Renamed registerRequestInstrumentation export to instrumentOutgoingRequests in @sentry/tracing.

• breaking

  Renamed UserAgent integration to HttpContext.

• breaking

  Replaced BrowserTracing integration's maxTransactionDuration option with finalTimeout option in the @sentry/tracing package and reset idleTimeout based on activities count. This should improve accuracy of web-vitals like LCP by 20-30%.

• breaking

  Updated @sentry/angular to be compiled by the angular compiler.

• breaking

  Made tracing package treeshakable

• breaking

  Removed support for Node v6.

• breaking

  Removed @sentry/minimal package in favour of using @sentry/hub.

• breaking

  Removed support for Opera browser pre v15

• breaking

  Removed ignoreSentryErrors option from AWS lambda SDK. Errors originating from the SDK will now always be caught internally.

• breaking

  Removed Integrations.BrowserTracing export from @sentry/nextjs. Please import BrowserTracing from @sentry/nextjs directly.

• breaking

  Removed static id property from BrowserTracing integration.

• breaking

  Removed SDK_NAME export from @sentry/browser, @sentry/node, @sentry/tracing and @sentry/vue packages.

• breaking

  Removed Angular, Ember, and Vue integrations from @sentry/integrations in favour of the explicit framework packages: @sentry/angular, @sentry/ember, and @sentry/vue.

• breaking

  Removed enums Status, RequestSessionStatus, and SessionStatus. Deprecated enums SpanStatus and Severity. This was done to save on bundle size. (#4891)

• breaking

  Removed support for deprecated @sentry/apm package.

• breaking

  Removed deprecated user field from DSN interface. publicKey should be used instead.

• breaking

  Removed deprecated getActiveDomain method and DomainAsCarrier type from @sentry/hub.

• breaking

  Removed eventStatusFromHttpCode to save on bundle size.

• breaking

  Removed usage of deprecated event.stacktrace field.

• breaking

  Removed raven-node backward-compat code

• breaking

  Removed showReportDialog method on BrowserClient

• breaking

  Removed deprecated startSpan and child methods

• breaking

  Removed deprecated frameContextLines options

• breaking

  Removed Sentry from window in the Gatsby SDK

Other Changes

Features

• tracing: Add Prisma ORM integration.

• react: Add react-router-v6 integration

• Add attachments API

• Add name field to EventProcessor

• Expose configurable stack parser

• tracing: Make setMeasurement public API

• tracing: Add GB unit to device memory tag value

• Export browser integrations individually

• core: Send Baggage in Envelope Header

Fixes

• browser: Fix memory leak in addEventListener instrumentation

• build: Fix express import in gcpfunction

• ember: Export sha hashes of injected scripts

• hub: Add missing parameter to captureException docstring

• integrations: Mark ExtraErrorData as already normalized

• serverless: Adjust v6 Lambda layer hotfix for v7

• tracing: Adjust sideEffects package.json entry for v7

• tracing: Remove isInstanceOf check in Hub constructor

• tracing: Don't use querySelector when not available

• nextjs: Update webpack-plugin and change how cli binary is detected. This should reduce bundle size of NextJS applications.

• utils: Fix infinite recursion in dropUndefinedKeys

Misc

• build: Vendor polyfills injected during build