Skip to content

Commit 8e14fe8

Browse files
committed
meta: Add CHANGELOG for 8.0.0
1 parent 4dcfb24 commit 8e14fe8

File tree

1 file changed

+78
-0
lines changed

1 file changed

+78
-0
lines changed

CHANGELOG.md

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,84 @@
44

55
- "You miss 100 percent of the chances you don't take. — Wayne Gretzky" — Michael Scott
66

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+
785
## 8.0.0-rc.1
886

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

0 commit comments

Comments
 (0)