|
4 | 4 |
|
5 | 5 | - "You miss 100 percent of the chances you don't take. — Wayne Gretzky" — Michael Scott
|
6 | 6 |
|
| 7 | +## 8.0.0 |
| 8 | + |
| 9 | +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 |
| 10 | +long time coming! Thanks to everyone for your patience and a special shout out to the brave souls testing preview builds |
| 11 | +and reporting issues - we appreciate your support! |
| 12 | + |
| 13 | +--- |
| 14 | + |
| 15 | +### How to Upgrade to Version 8: |
| 16 | + |
| 17 | +We recommend reading the |
| 18 | +[migration guide docs](https://docs.sentry.io/platforms/javascript/migration/v7-to-v8/#migration-codemod) to find out |
| 19 | +how to address any breaking changes in your code for your specific platform or framework. |
| 20 | + |
| 21 | +To automate upgrading to v8 as much as possible, use our migration codemod `@sentry/migr8`: |
| 22 | + |
| 23 | +```sh |
| 24 | +npx @sentry/migr8@latest |
| 25 | +``` |
| 26 | + |
| 27 | +All deprecations from the v7 cycle, with the exception of `getCurrentHub()`, have been removed and can no longer be used |
| 28 | +in v8. If you have an advanced Sentry SDK setup, we additionally recommend reading the |
| 29 | +[in-depth migration guide](./MIGRATION.md) in our repo which highlights all changes with additional details and |
| 30 | +information. |
| 31 | + |
| 32 | +The rest of this changelog highlights the most important (breaking) changes and links to more detailed information. |
| 33 | + |
| 34 | +### Version Support |
| 35 | + |
| 36 | +With v8, we dropped support for several old runtimes and browsers |
| 37 | + |
| 38 | +**Node SDKs:** The Sentry JavaScript SDK v8 now supports **Node.js 14.8.0 or higher**. This applies to `@sentry/node` |
| 39 | +and all of our node-based server-side sdks (`@sentry/nextjs`, `@sentry/remix`, etc.). Furthermore, version 8 now ships |
| 40 | +with full support for ESM-based node apps using **Node.js 18.19.0 or higher**. |
| 41 | + |
| 42 | +**Browser SDKs:** The browser SDKs now require |
| 43 | +[**ES2018+**](https://caniuse.com/?feats=mdn-javascript_builtins_regexp_dotall,js-regexp-lookbehind,mdn-javascript_builtins_regexp_named_capture_groups,mdn-javascript_builtins_regexp_property_escapes,mdn-javascript_builtins_symbol_asynciterator,mdn-javascript_functions_method_definitions_async_generator_methods,mdn-javascript_grammar_template_literals_template_literal_revision,mdn-javascript_operators_destructuring_rest_in_objects,mdn-javascript_operators_destructuring_rest_in_arrays,promise-finally) |
| 44 | +compatible browsers. New minimum browser versions: |
| 45 | + |
| 46 | +- Chrome 63 |
| 47 | +- Edge 79 |
| 48 | +- Safari/iOS Safari 12 |
| 49 | +- Firefox 58 |
| 50 | +- Opera 50 |
| 51 | +- Samsung Internet 8.2 |
| 52 | + |
| 53 | +For more details, please see the |
| 54 | +[version support section in our migration guide](./MIGRATION.md#1-version-support-changes). |
| 55 | + |
| 56 | +### Initializing Server-side SDKs (Node, Bun, Deno, Serverless): |
| 57 | + |
| 58 | +Initializing the SDKs on the server-side has been simplified a lot. However, the SDK now needs to be imported and |
| 59 | +initialized before any other import in your code. We recommend creating a new file to initialize the SDK and specifying |
| 60 | +it via the `--require` (CJS) or `--import` (ESM) Node CLI argument. See more details in our migration docs about |
| 61 | +[initializing the SDK in v8](https://docs.sentry.io/platforms/javascript/guides/node/migration/v7-to-v8/#updated-sdk-initialization). |
| 62 | + |
| 63 | +### Performance Monitoring Changes |
| 64 | + |
| 65 | +The API around performance monitoring and tracing has been vastly improved, and we've added support for more |
| 66 | +integrations out of the box. |
| 67 | + |
| 68 | +- [Performance Monitoring API](./MIGRATION.md#performance-monitoring-api) |
| 69 | +- [Performance Monitoring Integrations](./MIGRATION.md#performance-monitoring-integrations) |
| 70 | + |
| 71 | +### Package removal |
| 72 | + |
| 73 | +The following packages have been removed or replaced and will no longer be published: |
| 74 | + |
| 75 | +- [`@sentry/hub`](./MIGRATION.md#sentryhub) |
| 76 | +- [`@sentry/tracing`](./MIGRATION.md#sentrytracing) |
| 77 | +- [`@sentry/integrations`](./MIGRATION.md#sentryintegrations) |
| 78 | +- [`@sentry/serverless`](./MIGRATION.md#sentryserverless) |
| 79 | +- [`@sentry/replay`](./MIGRATION.md#sentryreplay) |
| 80 | + |
| 81 | +### [TODO] Changes since `8.0.0-rc.2` |
| 82 | + |
| 83 | +TODO add if any are noteworthy |
| 84 | + |
7 | 85 | ## 8.0.0-rc.1
|
8 | 86 |
|
9 | 87 | This release contains no changes and was done for technical purposes. This version is considered stable.
|
|
0 commit comments