playwright-core 1.55.0-alpha-2025-07-31 → 1.55.0-alpha-1754048396000

package/lib/protocol/validatorPrimitives.js

@@ -29,7 +29,8 @@ __export(validatorPrimitives_exports, {
   tBoolean: () => tBoolean,
   tChannel: () => tChannel,
   tEnum: () => tEnum,
-  tNumber: () => tNumber,
+  tFloat: () => tFloat,
+  tInt: () => tInt,
   tObject: () => tObject,
   tOptional: () => tOptional,
   tString: () => tString,
@@ -53,12 +54,24 @@ function maybeFindValidator(type, method, kind) {
 function createMetadataValidator() {
   return tOptional(scheme["Metadata"]);
 }
-const tNumber = (arg, path, context) => {
+const tFloat = (arg, path, context) => {
   if (arg instanceof Number)
     return arg.valueOf();
   if (typeof arg === "number")
     return arg;
-  throw new ValidationError(`${path}: expected number, got ${typeof arg}`);
+  throw new ValidationError(`${path}: expected float, got ${typeof arg}`);
+};
+const tInt = (arg, path, context) => {
+  let value;
+  if (arg instanceof Number)
+    value = arg.valueOf();
+  else if (typeof arg === "number")
+    value = arg;
+  else
+    throw new ValidationError(`${path}: expected integer, got ${typeof arg}`);
+  if (!Number.isInteger(value))
+    throw new ValidationError(`${path}: expected integer, got float ${value}`);
+  return value;
 };
 const tBoolean = (arg, path, context) => {
   if (arg instanceof Boolean)
@@ -170,7 +183,8 @@ const tType = (name) => {
   tBoolean,
   tChannel,
   tEnum,
-  tNumber,
+  tFloat,
+  tInt,
   tObject,
   tOptional,
   tString,

package/lib/server/bidi/bidiBrowser.js

@@ -183,6 +183,12 @@ class BidiBrowserContext extends import_browserContext.BrowserContext {
     promises.push(this.doUpdateDefaultViewport());
     if (this._options.geolocation)
       promises.push(this.setGeolocation(this._options.geolocation));
+    if (this._options.locale) {
+      promises.push(this._browser._browserSession.send("emulation.setLocaleOverride", {
+        locale: this._options.locale,
+        userContexts: [this._userContextId()]
+      }));
+    }
     await Promise.all(promises);
   }
   possiblyUninitializedPages() {
@@ -277,7 +283,7 @@ class BidiBrowserContext extends import_browserContext.BrowserContext {
       },
       state,
       origin,
-      userContext: this._browserContextId || "default"
+      userContext: this._userContextId()
     });
   }
   async setGeolocation(geolocation) {
@@ -289,7 +295,7 @@ class BidiBrowserContext extends import_browserContext.BrowserContext {
         longitude: geolocation.longitude,
         accuracy: geolocation.accuracy
       } : null,
-      userContexts: [this._browserContextId || "default"]
+      userContexts: [this._userContextId()]
     });
   }
   async doUpdateExtraHTTPHeaders() {
@@ -307,7 +313,7 @@ class BidiBrowserContext extends import_browserContext.BrowserContext {
     const { script } = await this._browser._browserSession.send("script.addPreloadScript", {
       // TODO: remove function call from the source.
       functionDeclaration: `() => { return ${initScript.source} }`,
-      userContexts: [this._browserContextId || "default"]
+      userContexts: [this._userContextId()]
     });
     this._initScriptIds.set(initScript, script);
   }

package/lib/server/bidi/bidiNetworkManager.js

@@ -37,13 +37,12 @@ var import_cookieStore = require("../cookieStore");
 var network = __toESM(require("../network"));
 var bidi = __toESM(require("./third_party/bidiProtocol"));
 class BidiNetworkManager {
-  constructor(bidiSession, page, onNavigationResponseStarted) {
+  constructor(bidiSession, page) {
     this._userRequestInterceptionEnabled = false;
     this._protocolRequestInterceptionEnabled = false;
     this._session = bidiSession;
     this._requests = /* @__PURE__ */ new Map();
     this._page = page;
-    this._onNavigationResponseStarted = onNavigationResponseStarted;
     this._eventListeners = [
       import_eventsHelper.eventsHelper.addEventListener(bidiSession, "network.beforeRequestSent", this._onBeforeRequestSent.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(bidiSession, "network.responseStarted", this._onResponseStarted.bind(this)),
@@ -112,8 +111,6 @@ class BidiNetworkManager {
     response.setRawResponseHeaders(null);
     response.setResponseHeadersSize(params.response.headersSize);
     this._page.frameManager.requestReceivedResponse(response);
-    if (params.navigation)
-      this._onNavigationResponseStarted(params);
   }
   _onResponseCompleted(params) {
     const request = this._requests.get(params.request.request);

package/lib/server/bidi/bidiPage.js

@@ -32,7 +32,6 @@ __export(bidiPage_exports, {
   kPlaywrightBindingChannel: () => kPlaywrightBindingChannel
 });
 module.exports = __toCommonJS(bidiPage_exports);
-var import_utils = require("../../utils");
 var import_eventsHelper = require("../utils/eventsHelper");
 var dialog = __toESM(require("../dialog"));
 var dom = __toESM(require("../dom"));
@@ -56,7 +55,7 @@ class BidiPage {
     this._realmToContext = /* @__PURE__ */ new Map();
     this._page = new import_page.Page(this, browserContext);
     this._browserContext = browserContext;
-    this._networkManager = new import_bidiNetworkManager.BidiNetworkManager(this._session, this._page, this._onNavigationResponseStarted.bind(this));
+    this._networkManager = new import_bidiNetworkManager.BidiNetworkManager(this._session, this._page);
     this._pdf = new import_bidiPdf.BidiPDF(this._session);
     this._page.on(import_page.Page.Events.FrameDetached, (frame) => this._removeContextsForFrame(frame, false));
     this._sessionListeners = [
@@ -64,6 +63,7 @@ class BidiPage {
       import_eventsHelper.eventsHelper.addEventListener(bidiSession, "script.message", this._onScriptMessage.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(bidiSession, "browsingContext.contextDestroyed", this._onBrowsingContextDestroyed.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(bidiSession, "browsingContext.navigationStarted", this._onNavigationStarted.bind(this)),
+      import_eventsHelper.eventsHelper.addEventListener(bidiSession, "browsingContext.navigationCommitted", this._onNavigationCommitted.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(bidiSession, "browsingContext.navigationAborted", this._onNavigationAborted.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(bidiSession, "browsingContext.navigationFailed", this._onNavigationFailed.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(bidiSession, "browsingContext.fragmentNavigated", this._onFragmentNavigated.bind(this)),
@@ -160,28 +160,12 @@ class BidiPage {
   _onNavigationStarted(params) {
     const frameId = params.context;
     this._page.frameManager.frameRequestedNavigation(frameId, params.navigation);
-    const url = params.url.toLowerCase();
-    if (url.startsWith("file:") || url.startsWith("data:") || url === "about:blank") {
-      const frame = this._page.frameManager.frame(frameId);
-      if (frame)
-        this._page.frameManager.frameCommittedNewDocumentNavigation(
-          frameId,
-          params.url,
-          "",
-          params.navigation,
-          /* initial */
-          false
-        );
-    }
   }
-  // TODO: there is no separate event for committed navigation, so we approximate it with responseStarted.
-  _onNavigationResponseStarted(params) {
+  _onNavigationCommitted(params) {
     const frameId = params.context;
-    const frame = this._page.frameManager.frame(frameId);
-    (0, import_utils.assert)(frame);
     this._page.frameManager.frameCommittedNewDocumentNavigation(
       frameId,
-      params.response.url,
+      params.url,
       "",
       params.navigation,
       /* initial */

package/lib/server/bidi/third_party/bidiProtocolCore.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var bidiProtocolCore_exports = {};
 __export(bidiProtocolCore_exports, {
   BrowsingContext: () => BrowsingContext,
+  Emulation: () => Emulation,
   ErrorCode: () => ErrorCode,
   Input: () => Input,
   Log: () => Log,
@@ -27,12 +28,6 @@ __export(bidiProtocolCore_exports, {
   Session: () => Session
 });
 module.exports = __toCommonJS(bidiProtocolCore_exports);
-/**
- * @license
- * Copyright 2024 Google Inc.
- * Modifications copyright (c) Microsoft Corporation.
- * SPDX-License-Identifier: Apache-2.0
- */
 var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2["InvalidArgument"] = "invalid argument";
   ErrorCode2["InvalidSelector"] = "invalid selector";
@@ -40,11 +35,13 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2["InvalidWebExtension"] = "invalid web extension";
   ErrorCode2["MoveTargetOutOfBounds"] = "move target out of bounds";
   ErrorCode2["NoSuchAlert"] = "no such alert";
+  ErrorCode2["NoSuchNetworkCollector"] = "no such network collector";
   ErrorCode2["NoSuchElement"] = "no such element";
   ErrorCode2["NoSuchFrame"] = "no such frame";
   ErrorCode2["NoSuchHandle"] = "no such handle";
   ErrorCode2["NoSuchHistoryEntry"] = "no such history entry";
   ErrorCode2["NoSuchIntercept"] = "no such intercept";
+  ErrorCode2["NoSuchNetworkData"] = "no such network data";
   ErrorCode2["NoSuchNode"] = "no such node";
   ErrorCode2["NoSuchRequest"] = "no such request";
   ErrorCode2["NoSuchScript"] = "no such script";
@@ -56,6 +53,7 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2["UnableToCloseBrowser"] = "unable to close browser";
   ErrorCode2["UnableToSetCookie"] = "unable to set cookie";
   ErrorCode2["UnableToSetFileInput"] = "unable to set file input";
+  ErrorCode2["UnavailableNetworkData"] = "unavailable network data";
   ErrorCode2["UnderspecifiedStoragePartition"] = "underspecified storage partition";
   ErrorCode2["UnknownCommand"] = "unknown command";
   ErrorCode2["UnknownError"] = "unknown error";
@@ -96,15 +94,43 @@ var BrowsingContext;
     CreateType2["Window"] = "window";
   })(CreateType = BrowsingContext2.CreateType || (BrowsingContext2.CreateType = {}));
 })(BrowsingContext || (BrowsingContext = {}));
+var Emulation;
+((Emulation2) => {
+  let ForcedColorsModeTheme;
+  ((ForcedColorsModeTheme2) => {
+    ForcedColorsModeTheme2["Light"] = "light";
+    ForcedColorsModeTheme2["Dark"] = "dark";
+  })(ForcedColorsModeTheme = Emulation2.ForcedColorsModeTheme || (Emulation2.ForcedColorsModeTheme = {}));
+})(Emulation || (Emulation = {}));
+((Emulation2) => {
+  let ScreenOrientationNatural;
+  ((ScreenOrientationNatural2) => {
+    ScreenOrientationNatural2["Portrait"] = "portrait";
+    ScreenOrientationNatural2["Landscape"] = "landscape";
+  })(ScreenOrientationNatural = Emulation2.ScreenOrientationNatural || (Emulation2.ScreenOrientationNatural = {}));
+})(Emulation || (Emulation = {}));
 var Network;
+((Network2) => {
+  let CollectorType;
+  ((CollectorType2) => {
+    CollectorType2["Blob"] = "blob";
+  })(CollectorType = Network2.CollectorType || (Network2.CollectorType = {}));
+})(Network || (Network = {}));
 ((Network2) => {
   let SameSite;
   ((SameSite2) => {
     SameSite2["Strict"] = "strict";
     SameSite2["Lax"] = "lax";
     SameSite2["None"] = "none";
+    SameSite2["Default"] = "default";
   })(SameSite = Network2.SameSite || (Network2.SameSite = {}));
 })(Network || (Network = {}));
+((Network2) => {
+  let DataType;
+  ((DataType2) => {
+    DataType2["Response"] = "response";
+  })(DataType = Network2.DataType || (Network2.DataType = {}));
+})(Network || (Network = {}));
 ((Network2) => {
   let InterceptPhase;
   ((InterceptPhase2) => {
@@ -143,6 +169,7 @@ var Input;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BrowsingContext,
+  Emulation,
   ErrorCode,
   Input,
   Log,

package/lib/server/browser.js

@@ -63,8 +63,7 @@ class Browser extends import_instrumentation.SdkObject {
       context._clientCertificatesProxy = clientCertificatesProxy;
       if (options.__testHookBeforeSetStorageState)
         await progress.race(options.__testHookBeforeSetStorageState());
-      if (options.storageState)
-        await context.setStorageState(progress, options.storageState);
+      await context.setStorageState(progress, options.storageState, "initial");
       this.emit(Browser.Events.Context, context);
       return context;
     } catch (error) {

package/lib/server/browserContext.js

@@ -66,7 +66,7 @@ class BrowserContext extends import_instrumentation.SdkObject {
     this._origins = /* @__PURE__ */ new Set();
     this._harRecorders = /* @__PURE__ */ new Map();
     this._tempDirs = [];
-    this._settingStorageState = false;
+    this._creatingStorageStatePage = false;
     this.initScripts = [];
     this._routesInFlight = /* @__PURE__ */ new Set();
     this._playwrightBindingExposed = false;
@@ -175,15 +175,11 @@ if (navigator.serviceWorker) navigator.serviceWorker.register = async () => { co
       page = void 0;
     }
     await page?.mainFrame().gotoImpl(progress, "about:blank", {});
-    await this._resetStorage(progress);
-    await progress.race(this.clock.resetForReuse());
+    await this.clock.uninstall(progress);
     await progress.race(this.setUserAgent(this._options.userAgent));
-    await progress.race(this.clearCache());
-    await progress.race(this.doClearCookies());
     await progress.race(this.doUpdateDefaultEmulatedMedia());
     await progress.race(this.doUpdateDefaultViewport());
-    if (this._options.storageState?.cookies)
-      await progress.race(this.addCookies(this._options.storageState?.cookies));
+    await this.setStorageState(progress, this._options.storageState, "resetForReuse");
     await page?.resetForReuse(progress);
   }
   _browserClosed() {
@@ -496,63 +492,59 @@ if (navigator.serviceWorker) navigator.serviceWorker.register = async () => { co
     }
     return result;
   }
-  async _resetStorage(progress) {
-    const oldOrigins = this._origins;
-    const newOrigins = new Map(this._options.storageState?.origins?.map((p) => [p.origin, p]) || []);
-    if (!oldOrigins.size && !newOrigins.size)
-      return;
-    let page = this.pages()[0];
-    page = page || await this.newPage(progress, false);
-    const interceptor = (route) => {
-      route.fulfill({ body: "<html></html>" }).catch(() => {
-      });
-    };
-    await page.addRequestInterceptor(progress, interceptor, "prepend");
-    try {
-      for (const origin of /* @__PURE__ */ new Set([...oldOrigins, ...newOrigins.keys()])) {
-        const frame = page.mainFrame();
-        await frame.gotoImpl(progress, origin, {});
-        await progress.race(frame.resetStorageForCurrentOriginBestEffort(newOrigins.get(origin)));
-      }
-      this._origins = /* @__PURE__ */ new Set([...newOrigins.keys()]);
-    } finally {
-      await page.removeRequestInterceptor(interceptor);
-    }
+  isCreatingStorageStatePage() {
+    return this._creatingStorageStatePage;
   }
-  isSettingStorageState() {
-    return this._settingStorageState;
-  }
-  async setStorageState(progress, state) {
+  async setStorageState(progress, state, mode) {
     let page;
-    this._settingStorageState = true;
+    let interceptor;
     try {
-      if (state.cookies)
+      if (mode !== "initial") {
+        await progress.race(this.clearCache());
+        await progress.race(this.doClearCookies());
+      }
+      if (state?.cookies)
         await progress.race(this.addCookies(state.cookies));
-      if (state.origins && state.origins.length) {
-        page = await this.newPage(progress, true);
-        await page.addRequestInterceptor(progress, (route) => {
+      const newOrigins = new Map(state?.origins?.map((p) => [p.origin, p]) || []);
+      const allOrigins = /* @__PURE__ */ new Set([...this._origins, ...newOrigins.keys()]);
+      if (allOrigins.size) {
+        if (mode === "resetForReuse")
+          page = this.pages()[0];
+        if (!page) {
+          try {
+            this._creatingStorageStatePage = mode !== "resetForReuse";
+            page = await this.newPage(progress, this._creatingStorageStatePage);
+          } finally {
+            this._creatingStorageStatePage = false;
+          }
+        }
+        interceptor = (route) => {
           route.fulfill({ body: "<html></html>" }).catch(() => {
           });
-        }, "prepend");
-        for (const originState of state.origins) {
+        };
+        await page.addRequestInterceptor(progress, interceptor, "prepend");
+        for (const origin of allOrigins) {
           const frame = page.mainFrame();
-          await frame.gotoImpl(progress, originState.origin, {});
+          await frame.gotoImpl(progress, origin, {});
           const restoreScript = `(() => {
             const module = {};
             ${rawStorageSource.source}
             const script = new (module.exports.StorageScript())(${this._browser.options.name === "firefox"});
-            return script.restore(${JSON.stringify(originState)});
+            return script.restore(${JSON.stringify(newOrigins.get(origin))});
           })()`;
           await progress.race(frame.evaluateExpression(restoreScript, { world: "utility" }));
         }
       }
+      this._origins = /* @__PURE__ */ new Set([...newOrigins.keys()]);
     } catch (error) {
       (0, import_stackTrace.rewriteErrorMessage)(error, `Error setting storage state:
 ` + error.message);
       throw error;
     } finally {
-      await page?.close();
-      this._settingStorageState = false;
+      if (mode !== "resetForReuse")
+        await page?.close();
+      else if (interceptor)
+        await page?.removeRequestInterceptor(interceptor);
     }
   }
   async extendInjectedScript(source, arg) {

package/lib/server/chromium/chromiumSwitches.js

@@ -42,6 +42,8 @@ const disabledFeatures = (assistantMode) => [
   "ThirdPartyStoragePartitioning",
   // See https://github.com/microsoft/playwright/issues/16126
   "Translate",
+  // See https://issues.chromium.org/u/1/issues/435410220
+  "AutoDeElevate",
   assistantMode ? "AutomationControlled" : ""
 ].filter(Boolean);
 const chromiumSwitches = (assistantMode, channel) => [

package/lib/server/chromium/crPage.js

@@ -369,7 +369,7 @@ class FrameSession {
     ]);
   }
   async _initialize(hasUIWindow) {
-    const isSettingStorageState = this._page.browserContext.isSettingStorageState();
+    const isSettingStorageState = this._page.browserContext.isCreatingStorageStatePage();
     if (!isSettingStorageState && hasUIWindow && !this._crPage._browserContext._browser.isClank() && !this._crPage._browserContext._options.noDefaultViewport) {
       const { windowId } = await this._client.send("Browser.getWindowForTarget");
       this._windowId = windowId;

package/lib/server/clock.js

@@ -37,8 +37,8 @@ class Clock {
     this._initScripts = [];
     this._browserContext = browserContext;
   }
-  async resetForReuse() {
-    await this._browserContext.removeInitScripts(this._initScripts);
+  async uninstall(progress) {
+    await progress.race(this._browserContext.removeInitScripts(this._initScripts));
     this._initScripts = [];
   }
   async fastForward(progress, ticks) {

package/lib/server/dispatchers/browserContextDispatcher.js

@@ -287,6 +287,9 @@ class BrowserContextDispatcher extends import_dispatcher.Dispatcher {
   async storageState(params, progress) {
     return await progress.race(this._context.storageState(progress, params.indexedDB));
   }
+  async setStorageState(params, progress) {
+    await this._context.setStorageState(progress, params.storageState, "update");
+  }
   async close(params, progress) {
     progress.metadata.potentiallyClosesScope = true;
     await this._context.close(params);
@@ -342,6 +345,9 @@ class BrowserContextDispatcher extends import_dispatcher.Dispatcher {
   async clockSetSystemTime(params, progress) {
     await this._context.clock.setSystemTime(progress, params.timeString ?? params.timeNumber ?? 0);
   }
+  async clockUninstall(params, progress) {
+    await this._context.clock.uninstall(progress);
+  }
   async updateSubscription(params, progress) {
     if (params.enabled)
       this._subscriptions.add(params.event);

package/lib/server/dispatchers/frameDispatcher.js

@@ -218,7 +218,7 @@ class FrameDispatcher extends import_dispatcher.Dispatcher {
     return result;
   }
   async ariaSnapshot(params, progress) {
-    return { snapshot: await this._frame.ariaSnapshot(progress, params.selector, params) };
+    return { snapshot: await this._frame.ariaSnapshot(progress, params.selector) };
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/lib/server/dom.js

@@ -653,8 +653,8 @@ class ElementHandle extends js.JSHandle {
   async boundingBox() {
     return this._page.delegate.getBoundingBox(this);
   }
-  async ariaSnapshot(options) {
-    return await this.evaluateInUtility(([injected, element, options2]) => injected.ariaSnapshot(element, options2), options);
+  async ariaSnapshot() {
+    return await this.evaluateInUtility(([injected, element]) => injected.ariaSnapshot(element, { mode: "expect" }), {});
   }
   async screenshot(progress, options) {
     return await this._page.screenshotter.screenshotElement(progress, this, options);

package/lib/server/frames.js

@@ -1118,8 +1118,8 @@ class Frame extends import_instrumentation.SdkObject {
   async waitForTimeout(progress, timeout) {
     return progress.wait(timeout);
   }
-  async ariaSnapshot(progress, selector, options) {
-    return await this._retryWithProgressIfNotConnected(progress, selector, true, true, (handle) => progress.race(handle.ariaSnapshot(options)));
+  async ariaSnapshot(progress, selector) {
+    return await this._retryWithProgressIfNotConnected(progress, selector, true, true, (handle) => progress.race(handle.ariaSnapshot()));
   }
   async expect(progress, selector, options, timeout) {
     progress.log(`${(0, import_utils.renderTitleForCall)(progress.metadata)}${timeout ? ` with timeout ${timeout}ms` : ""}`);
@@ -1358,29 +1358,6 @@ class Frame extends import_instrumentation.SdkObject {
       return injectedScript.extend(source2, arg2);
     }, { source, arg });
   }
-  async resetStorageForCurrentOriginBestEffort(newStorage) {
-    const context = await this._utilityContext();
-    await context.evaluate(async ({ ls }) => {
-      sessionStorage.clear();
-      localStorage.clear();
-      for (const entry of ls || [])
-        localStorage[entry.name] = entry.value;
-      const registrations = navigator.serviceWorker ? await navigator.serviceWorker.getRegistrations() : [];
-      await Promise.all(registrations.map(async (r) => {
-        if (!r.installing && !r.waiting && !r.active)
-          r.unregister().catch(() => {
-          });
-        else
-          await r.unregister().catch(() => {
-          });
-      }));
-      for (const db of await indexedDB.databases?.() || []) {
-        if (db.name)
-          indexedDB.deleteDatabase(db.name);
-      }
-    }, { ls: newStorage?.localStorage }).catch(() => {
-    });
-  }
   _asLocator(selector) {
     return (0, import_utils.asLocator)(this._page.browserContext._browser.sdkLanguage(), selector);
   }

package/lib/server/instrumentation.js

@@ -70,8 +70,7 @@ function serverSideCallMetadata() {
     type: "Internal",
     method: "",
     params: {},
-    log: [],
-    isServerSide: true
+    log: []
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/lib/server/launchApp.js

@@ -50,18 +50,31 @@ async function launchApp(browserType, options) {
       "--test-type="
     );
     if (!channel && !options.persistentContextOptions?.executablePath)
-      channel = (0, import_registry.findChromiumChannel)(options.sdkLanguage);
+      channel = (0, import_registry.findChromiumChannelBestEffort)(options.sdkLanguage);
   }
   const controller = new import_progress.ProgressController((0, import_instrumentation.serverSideCallMetadata)(), browserType);
-  const context = await controller.run((progress) => browserType.launchPersistentContext(progress, "", {
-    ignoreDefaultArgs: ["--enable-automation"],
-    ...options?.persistentContextOptions,
-    channel,
-    noDefaultViewport: options.persistentContextOptions?.noDefaultViewport ?? true,
-    acceptDownloads: options?.persistentContextOptions?.acceptDownloads ?? ((0, import_utils.isUnderTest)() ? "accept" : "internal-browser-default"),
-    colorScheme: options?.persistentContextOptions?.colorScheme ?? "no-override",
-    args
-  }), 0);
+  let context;
+  try {
+    context = await controller.run((progress) => browserType.launchPersistentContext(progress, "", {
+      ignoreDefaultArgs: ["--enable-automation"],
+      ...options?.persistentContextOptions,
+      channel,
+      noDefaultViewport: options.persistentContextOptions?.noDefaultViewport ?? true,
+      acceptDownloads: options?.persistentContextOptions?.acceptDownloads ?? ((0, import_utils.isUnderTest)() ? "accept" : "internal-browser-default"),
+      colorScheme: options?.persistentContextOptions?.colorScheme ?? "no-override",
+      args
+    }), 0);
+  } catch (error) {
+    if (channel) {
+      error = (0, import_utils.rewriteErrorMessage)(error, [
+        `Failed to launch "${channel}" channel.`,
+        "Using custom channels could lead to unexpected behavior due to Enterprise policies (chrome://policy).",
+        "Install the default browser instead:",
+        (0, import_utils.wrapInASCIIBox)(`${(0, import_registry.buildPlaywrightCLICommand)(options.sdkLanguage, "install")}`, 2)
+      ].join("\n"));
+    }
+    throw error;
+  }
   const [page] = context.pages();
   if (browserType.name() === "chromium" && process.platform === "darwin") {
     context.on("page", async (newPage) => {

package/lib/server/page.js

@@ -785,7 +785,7 @@ async function snapshotFrameForAI(progress, frame, frameOrdinal, frameIds) {
         const node = injected.document.body;
         if (!node)
           return true;
-        return injected.ariaSnapshot(node, { forAI: true, refPrefix });
+        return injected.ariaSnapshot(node, { mode: "ai", refPrefix });
       }, frameOrdinal ? "f" + frameOrdinal : ""));
       if (snapshotOrRetry === true)
         return continuePolling;

package/lib/server/registry/index.js

@@ -31,7 +31,7 @@ __export(registry_exports, {
   Registry: () => Registry,
   browserDirectoryToMarkerFilePath: () => browserDirectoryToMarkerFilePath,
   buildPlaywrightCLICommand: () => buildPlaywrightCLICommand,
-  findChromiumChannel: () => findChromiumChannel,
+  findChromiumChannelBestEffort: () => findChromiumChannelBestEffort,
   installBrowsersForNpmInstall: () => installBrowsersForNpmInstall,
   registry: () => registry,
   registryDirectory: () => registryDirectory,
@@ -1238,7 +1238,7 @@ async function installBrowsersForNpmInstall(browsers) {
     /* forceReinstall */
   );
 }
-function findChromiumChannel(sdkLanguage) {
+function findChromiumChannelBestEffort(sdkLanguage) {
   let channel = null;
   for (const name of ["chromium", "chrome", "msedge"]) {
     try {
@@ -1278,7 +1278,7 @@ const registry = new Registry(require("../../../browsers.json"));
   Registry,
   browserDirectoryToMarkerFilePath,
   buildPlaywrightCLICommand,
-  findChromiumChannel,
+  findChromiumChannelBestEffort,
   installBrowsersForNpmInstall,
   registry,
   registryDirectory,