feat(core)!: Remove scope.clear() method (#23230)

This was only used in tests, where we can better solve this by resetting
the ACS totally.

Will also deprecate this on v10.

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: mydea

dev-packages/deno-integration-tests/src/index.ts

@@ -1,15 +1,19 @@
 import type { TransactionEvent } from '@sentry/core';
-import { getCurrentScope, getGlobalScope, getIsolationScope } from '@sentry/deno';
+import { getAsyncContextStrategy, getMainCarrier, setAsyncContextStrategy } from '@sentry/core';
 
 /**
- * Clear the current, isolation, and global scopes and detach the client so each
- * test starts from a clean slate.
+ * Wipe the Sentry carrier so the current, isolation, and global scopes (and the
+ * client) are recreated fresh, letting each test start from a clean slate.
+ *
+ * The async-context strategy is preserved across the wipe: channel integrations
+ * subscribe once per process and capture the strategy's `AsyncLocalStorage` at
+ * that point. Dropping it here would strand that ALS, so scope propagation into
+ * channel callbacks would silently break for every test after the first.
  */
 export function resetGlobals(): void {
-  getCurrentScope().clear();
-  getCurrentScope().setClient(undefined);
-  getIsolationScope().clear();
-  getGlobalScope().clear();
+  const acs = getAsyncContextStrategy(getMainCarrier());
+  getMainCarrier().__SENTRY__ = undefined;
+  setAsyncContextStrategy(acs);
 }
 
 export interface TransactionSink {

dev-packages/node-integration-tests/suites/public-api/configureScope/clear_scope/scenario.ts

@@ -664,6 +664,7 @@ Affected SDKs: `@sentry/cloudflare`.
 ### `@sentry/core` / All SDKs
 
 - The internal, deprecated `addAutoIpAddressToUser` export was removed.
+- `Scope.clear()` was removed. To reset scope state, re-initialize the SDK or run your code in a fresh scope via `withScope`/`withIsolationScope`.
 - The deprecated positional `spanOrigin` argument of `instrumentFetchRequest` was removed. Pass an options object (e.g. `{ spanOrigin }`) as the last argument instead.
 - The `createSpanEnvelope` function and the `SpanEnvelope` / `SpanItem` types were removed. They existed only to send standalone (v1) spans as their own segment envelope, which the SDK no longer does. Standalone spans are gone; spans are sent either on their transaction or, with span streaming, as streamed spans (`StreamedSpanEnvelope`).
 - The `disableInstrumentationWarnings` option and the `MissingInstrumentationContext` type were removed. Now that instrumentation is channel-based, the SDK can no longer detect the "you imported a framework before `Sentry.init()`" case, so the warning it gated and the context it attached no longer exist.

dev-packages/node-integration-tests/suites/public-api/configureScope/clear_scope/test.ts

@@ -1,13 +1,6 @@
 import type { BrowserClient } from '@sentry/browser';
-import {
-  browserTracingIntegration,
-  getActiveSpan,
-  getClient,
-  getCurrentScope,
-  getGlobalScope,
-  getIsolationScope,
-  SDK_VERSION,
-} from '@sentry/browser';
+import { browserTracingIntegration, getActiveSpan, getClient, SDK_VERSION } from '@sentry/browser';
+import { getMainCarrier } from '@sentry/core';
 import * as SentryBrowser from '@sentry/browser';
 import { afterEach, describe, expect, it, vi } from 'vitest';
 import { init } from '../../src/client/sdk';
@@ -19,10 +12,7 @@ describe('Sentry client SDK', () => {
     afterEach(() => {
       vi.clearAllMocks();
 
-      getCurrentScope().clear();
-      getCurrentScope().setClient(undefined);
-      getIsolationScope().clear();
-      getGlobalScope().clear();
+      getMainCarrier().__SENTRY__ = undefined;
     });
 
     it('adds Astro metadata to the SDK options', () => {

docs/migration/v11-end-state.md

@@ -1,3 +1,4 @@
+import { getMainCarrier } from '@sentry/core';
 import * as SentryNode from '@sentry/node';
 import { SDK_VERSION } from '@sentry/node';
 import { afterEach, describe, expect, it, vi } from 'vitest';
@@ -10,10 +11,7 @@ describe('Sentry server SDK', () => {
     afterEach(() => {
       vi.clearAllMocks();
 
-      SentryNode.getGlobalScope().clear();
-      SentryNode.getIsolationScope().clear();
-      SentryNode.getCurrentScope().clear();
-      SentryNode.getCurrentScope().setClient(undefined);
+      getMainCarrier().__SENTRY__ = undefined;
     });
 
     it('adds Astro metadata to the SDK options', () => {

packages/astro/test/client/sdk.test.ts

@@ -1,12 +1,11 @@
-import { getCurrentScope, getIsolationScope, SentrySpan, setCurrentClient, spanToJSON } from '@sentry/core';
+import { getMainCarrier, SentrySpan, setCurrentClient, spanToJSON } from '@sentry/core';
 import { beforeEach, describe, expect, it, test } from 'vitest';
 import { extractNetworkProtocol, startAndEndSpan } from '../../src/performance/utils';
 import { getDefaultClientOptions, TestClient } from '../utils/TestClient';
 
 describe('startAndEndSpan()', () => {
   beforeEach(() => {
-    getCurrentScope().clear();
-    getIsolationScope().clear();
+    getMainCarrier().__SENTRY__ = undefined;
 
     const client = new TestClient(
       getDefaultClientOptions({

packages/astro/test/server/sdk.test.ts

@@ -1,8 +1,7 @@
 import type { Span, SpanAttributes } from '@sentry/core';
 import {
   getClient,
-  getCurrentScope,
-  getIsolationScope,
+  getMainCarrier,
   SEMANTIC_ATTRIBUTE_SENTRY_OP,
   SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN,
   SentrySpan,
@@ -46,8 +45,7 @@ function mockPerformanceResourceTiming(
 describe('addWebVitalsToSpan', () => {
   beforeEach(() => {
     vi.restoreAllMocks();
-    getCurrentScope().clear();
-    getIsolationScope().clear();
+    getMainCarrier().__SENTRY__ = undefined;
 
     const client = new TestClient(
       getDefaultClientOptions({
@@ -151,8 +149,7 @@ describe('_addResourceSpans', () => {
   });
 
   beforeEach(() => {
-    getCurrentScope().clear();
-    getIsolationScope().clear();
+    getMainCarrier().__SENTRY__ = undefined;
 
     const client = new TestClient(
       getDefaultClientOptions({
@@ -590,8 +587,7 @@ describe('_addNavigationSpans', () => {
   });
 
   beforeEach(() => {
-    getCurrentScope().clear();
-    getIsolationScope().clear();
+    getMainCarrier().__SENTRY__ = undefined;
 
     const client = new TestClient(
       getDefaultClientOptions({

packages/browser-utils/test/browser/utils.test.ts

@@ -1,5 +1,5 @@
 import type { Span } from '@sentry/core';
-import { getCurrentScope, getIsolationScope, SentrySpan, setCurrentClient, spanToJSON } from '@sentry/core';
+import { getMainCarrier, SentrySpan, setCurrentClient, spanToJSON } from '@sentry/core';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { _addUserTimingSpan, userTimingIntegration } from '../../src/performance/userTiming';
 import * as utils from '../../src/performance/utils';
@@ -12,8 +12,7 @@ describe('userTimingIntegration', () => {
 
   beforeEach(() => {
     vi.restoreAllMocks();
-    getCurrentScope().clear();
-    getIsolationScope().clear();
+    getMainCarrier().__SENTRY__ = undefined;
 
     client = new TestClient(getDefaultClientOptions({ tracesSampleRate: 1 }));
     setCurrentClient(client);
@@ -133,8 +132,7 @@ describe('_addUserTimingSpan', () => {
 
   beforeEach(() => {
     vi.restoreAllMocks();
-    getCurrentScope().clear();
-    getIsolationScope().clear();
+    getMainCarrier().__SENTRY__ = undefined;
 
     const client = new TestClient(getDefaultClientOptions({ tracesSampleRate: 1 }));
     setCurrentClient(client);

packages/browser-utils/test/performance/browserMetrics.test.ts

@@ -4,8 +4,7 @@
 
 import {
   eventFiltersIntegration,
-  getGlobalScope,
-  getIsolationScope,
+  getMainCarrier,
   getReportDialogEndpoint,
   lastEventId,
   SDK_VERSION,
@@ -49,10 +48,7 @@ describe('SentryBrowser', () => {
   const beforeSend = vi.fn(event => event);
 
   beforeEach(() => {
-    getGlobalScope().clear();
-    getIsolationScope().clear();
-    getCurrentScope().clear();
-    getCurrentScope().setClient(undefined);
+    getMainCarrier().__SENTRY__ = undefined;
 
     init({
       beforeSend,