playwright-core 1.58.0-alpha-2025-12-18 → 1.58.0-alpha-2025-12-19

package/browsers.json

@@ -31,14 +31,14 @@
     },
     {
       "name": "firefox",
-      "revision": "1504",
+      "revision": "1507",
       "installByDefault": true,
       "browserVersion": "145.0.2",
       "title": "Firefox"
     },
     {
       "name": "firefox-beta",
-      "revision": "1499",
+      "revision": "1502",
       "installByDefault": false,
       "browserVersion": "146.0b8",
       "title": "Firefox Beta"

package/lib/client/browserType.js

@@ -169,7 +169,8 @@ class BrowserType extends import_channelOwner.ChannelOwner {
       endpointURL,
       headers,
       slowMo: params.slowMo,
-      timeout: new import_timeoutSettings.TimeoutSettings(this._platform).timeout(params)
+      timeout: new import_timeoutSettings.TimeoutSettings(this._platform).timeout(params),
+      isLocal: params.isLocal
     });
     const browser = import_browser.Browser.from(result.browser);
     browser._connectToBrowserType(this, {}, params.logger);

package/lib/protocol/validator.js

@@ -609,10 +609,10 @@ import_validatorPrimitives.scheme.BrowserTypeLaunchPersistentContextParams = (0,
   selectorEngines: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("SelectorEngine"))),
   testIdAttributeName: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
   agent: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
-    provider: import_validatorPrimitives.tString,
-    model: import_validatorPrimitives.tString,
+    provider: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+    model: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
-    cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "update", "auto"])),
+    cacheOutFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
     maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
     maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
@@ -628,7 +628,8 @@ import_validatorPrimitives.scheme.BrowserTypeConnectOverCDPParams = (0, import_v
   endpointURL: import_validatorPrimitives.tString,
   headers: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
   slowMo: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tFloat),
-  timeout: import_validatorPrimitives.tFloat
+  timeout: import_validatorPrimitives.tFloat,
+  isLocal: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tBoolean)
 });
 import_validatorPrimitives.scheme.BrowserTypeConnectOverCDPResult = (0, import_validatorPrimitives.tObject)({
   browser: (0, import_validatorPrimitives.tChannel)(["Browser"]),
@@ -710,10 +711,10 @@ import_validatorPrimitives.scheme.BrowserNewContextParams = (0, import_validator
   selectorEngines: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("SelectorEngine"))),
   testIdAttributeName: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
   agent: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
-    provider: import_validatorPrimitives.tString,
-    model: import_validatorPrimitives.tString,
+    provider: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+    model: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
-    cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "update", "auto"])),
+    cacheOutFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
     maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
     maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
@@ -790,10 +791,10 @@ import_validatorPrimitives.scheme.BrowserNewContextForReuseParams = (0, import_v
   selectorEngines: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("SelectorEngine"))),
   testIdAttributeName: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
   agent: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
-    provider: import_validatorPrimitives.tString,
-    model: import_validatorPrimitives.tString,
+    provider: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+    model: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
-    cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "update", "auto"])),
+    cacheOutFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
     maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
     maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
@@ -915,10 +916,10 @@ import_validatorPrimitives.scheme.BrowserContextInitializer = (0, import_validat
     selectorEngines: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("SelectorEngine"))),
     testIdAttributeName: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     agent: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
-      provider: import_validatorPrimitives.tString,
-      model: import_validatorPrimitives.tString,
+      provider: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+      model: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
       cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
-      cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "update", "auto"])),
+      cacheOutFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
       secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
       maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
       maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)
@@ -2843,10 +2844,10 @@ import_validatorPrimitives.scheme.AndroidDeviceLaunchBrowserParams = (0, import_
   selectorEngines: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("SelectorEngine"))),
   testIdAttributeName: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
   agent: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
-    provider: import_validatorPrimitives.tString,
-    model: import_validatorPrimitives.tString,
+    provider: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+    model: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     cacheFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
-    cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "update", "auto"])),
+    cacheOutFile: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
     secrets: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("NameValue"))),
     maxTurns: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt),
     maxTokens: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tInt)

package/lib/server/agent/agent.js

@@ -61,8 +61,8 @@ ${options.query}`;
 async function perform(progress, context, userTask, resultSchema, options = {}) {
   const { page } = context;
   const browserContext = page.browserContext;
-  if (!browserContext._options.agent)
-    throw new Error(`page.perform() and page.extract() require the agent to be set on the browser context`);
+  if (!browserContext._options.agent?.provider || !browserContext._options.agent?.model)
+    throw new Error(`This action requires the agent provider and model to be set on the browser context`);
   const { full } = await page.snapshotForAI(progress);
   const { tools, callTool } = (0, import_backend.toolsForLoop)(context);
   page.emit(import_page.Page.Events.AgentTurn, { role: "user", message: userTask });
@@ -121,44 +121,49 @@ ${full}
     }
   };
 }
-const allCaches = /* @__PURE__ */ new Map();
 async function cachedPerform(progress, context, options) {
-  if (!context.options?.cacheFile || context.options.cacheMode === "ignore" || context.options.cacheMode === "update")
+  if (!context.options?.cacheFile)
     return false;
-  const cache = await cachedActions(context.options.cacheFile);
+  const cache = await cachedActions(context, context.options?.cacheFile);
   const cacheKey = (options.key ?? options.task).trim();
-  const entry = cache[cacheKey];
-  if (!entry) {
-    if (context.options.cacheMode === "force")
-      throw new Error(`No cached actions for key "${cacheKey}", but cache mode is set to "force"`);
+  const entry = cache.actions[cacheKey];
+  if (!entry)
     return false;
-  }
   for (const action of entry.actions)
     await (0, import_actionRunner.runAction)(progress, "run", context.page, action, context.options.secrets ?? []);
   return true;
 }
 async function updateCache(context, options) {
   const cacheFile = context.options?.cacheFile;
-  if (!cacheFile)
-    return;
-  const cache = await cachedActions(cacheFile);
+  const cacheOutFile = context.options?.cacheOutFile;
+  const cache = cacheFile ? await cachedActions(context, cacheFile) : { actions: {}, newActions: {} };
   const cacheKey = (options.key ?? options.task).trim();
-  cache[cacheKey] = {
+  const newEntry = {
     timestamp: Date.now(),
     actions: context.actions
   };
-  const entries = Object.entries(cache);
-  entries.sort((e1, e2) => e1[0].localeCompare(e2[0]));
-  await import_fs.default.promises.writeFile(cacheFile, JSON.stringify(Object.fromEntries(entries), void 0, 2));
+  cache.actions[cacheKey] = newEntry;
+  cache.newActions[cacheKey] = newEntry;
+  if (cacheOutFile) {
+    const entries = Object.entries(cache.newActions);
+    entries.sort((e1, e2) => e1[0].localeCompare(e2[0]));
+    await import_fs.default.promises.writeFile(cacheOutFile, JSON.stringify(Object.fromEntries(entries), void 0, 2));
+  } else if (cacheFile) {
+    const entries = Object.entries(cache.actions);
+    entries.sort((e1, e2) => e1[0].localeCompare(e2[0]));
+    await import_fs.default.promises.writeFile(cacheFile, JSON.stringify(Object.fromEntries(entries), void 0, 2));
+  }
 }
-async function cachedActions(cacheFile) {
-  let cache = allCaches.get(cacheFile);
+async function cachedActions(context, cacheFile) {
+  let cache = context[agentCacheSymbol];
   if (!cache) {
-    cache = await import_fs.default.promises.readFile(cacheFile, "utf-8").then((text) => JSON.parse(text)).catch(() => ({}));
-    allCaches.set(cacheFile, cache);
+    const actions = await import_fs.default.promises.readFile(cacheFile, "utf-8").then((text) => JSON.parse(text)).catch(() => ({}));
+    cache = { actions, newActions: {} };
+    context[agentCacheSymbol] = cache;
   }
   return cache;
 }
+const agentCacheSymbol = Symbol("agentCache");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   pageExtract,

package/lib/server/chromium/chromium.js

@@ -114,7 +114,8 @@ class Chromium extends import_browserType.BrowserType {
       };
       (0, import_browserContext.validateBrowserContextOptions)(persistent, browserOptions);
       const browser = await progress.race(import_crBrowser.CRBrowser.connect(this.attribution.playwright, chromeTransport, browserOptions));
-      browser._isCollocatedWithServer = false;
+      if (!options.isLocal)
+        browser._isCollocatedWithServer = false;
       browser.on(import_browser.Browser.Events.Disconnected, doCleanup);
       return browser;
     } catch (error) {

package/lib/server/chromium/crPage.js

@@ -709,8 +709,7 @@ class FrameSession {
   }
   _onScreencastFrame(payload) {
     this._page.screencast.throttleFrameAck(() => {
-      this._client.send("Page.screencastFrameAck", { sessionId: payload.sessionId }).catch(() => {
-      });
+      this._client._sendMayFail("Page.screencastFrameAck", { sessionId: payload.sessionId });
     });
     const buffer = Buffer.from(payload.data, "base64");
     this._page.emit(import_page.Page.Events.ScreencastFrame, {

package/lib/server/firefox/ffBrowser.js

@@ -54,7 +54,6 @@ class FFBrowser extends import_browser.Browser {
     this.session.on("Browser.detachedFromTarget", this._onDetachedFromTarget.bind(this));
     this.session.on("Browser.downloadCreated", this._onDownloadCreated.bind(this));
     this.session.on("Browser.downloadFinished", this._onDownloadFinished.bind(this));
-    this.session.on("Browser.videoRecordingFinished", this._onVideoRecordingFinished.bind(this));
   }
   static async connect(parent, transport, options) {
     const connection = new import_ffConnection.FFConnection(transport, options.protocolLogger, options.browserLogsCollector);
@@ -141,9 +140,6 @@ class FFBrowser extends import_browser.Browser {
     const error = payload.canceled ? "canceled" : payload.error;
     this._downloadFinished(payload.uuid, error);
   }
-  _onVideoRecordingFinished(payload) {
-    this._takeVideo(payload.screencastId)?.reportFinished();
-  }
   _onDisconnect() {
     for (const video of this._idToVideo.values())
       video.artifact.reportFinished(new import_errors.TargetClosedError(this.closeReason()));
@@ -199,15 +195,13 @@ class FFBrowserContext extends import_browserContext.BrowserContext {
       promises.push(this.doUpdateOffline());
     promises.push(this.doUpdateDefaultEmulatedMedia());
     if (this._options.recordVideo) {
-      promises.push(this._ensureVideosPath().then(() => {
-        return this._browser.session.send("Browser.setVideoRecordingOptions", {
-          // validateBrowserContextOptions ensures correct video size.
-          options: {
-            ...this._options.recordVideo.size,
-            dir: this._options.recordVideo.dir
-          },
-          browserContextId: this._browserContextId
-        });
+      promises.push(this._browser.session.send("Browser.setScreencastOptions", {
+        // validateBrowserContextOptions ensures correct video size.
+        options: {
+          ...this._options.recordVideo.size,
+          quality: 90
+        },
+        browserContextId: this._browserContextId
       }));
     }
     const proxy = this._options.proxyOverride || this._options.proxy;
@@ -379,12 +373,8 @@ class FFBrowserContext extends import_browserContext.BrowserContext {
   }
   async doClose(reason) {
     if (!this._browserContextId) {
-      if (this._options.recordVideo) {
-        await this._browser.session.send("Browser.setVideoRecordingOptions", {
-          options: void 0,
-          browserContextId: this._browserContextId
-        });
-      }
+      if (this._options.recordVideo)
+        await Promise.all(this._ffPages().map((ffPage) => ffPage._page.screencast.stopVideoRecording()));
       await this._browser.close({ reason });
     } else {
       await this._browser.session.send("Browser.removeBrowserContext", { browserContextId: this._browserContextId });

package/lib/server/firefox/ffPage.js

@@ -41,9 +41,9 @@ var import_ffConnection = require("./ffConnection");
 var import_ffExecutionContext = require("./ffExecutionContext");
 var import_ffInput = require("./ffInput");
 var import_ffNetworkManager = require("./ffNetworkManager");
-var import_debugLogger = require("../utils/debugLogger");
 var import_stackTrace = require("../../utils/isomorphic/stackTrace");
 var import_errors = require("../errors");
+var import_debugLogger = require("../utils/debugLogger");
 const UTILITY_WORLD_NAME = "__playwright_utility_world__";
 class FFPage {
   constructor(session, browserContext, opener) {
@@ -83,13 +83,16 @@ class FFPage {
       import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.workerDestroyed", this._onWorkerDestroyed.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.dispatchMessageFromWorker", this._onDispatchMessageFromWorker.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.crashed", this._onCrashed.bind(this)),
-      import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.videoRecordingStarted", this._onVideoRecordingStarted.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.webSocketCreated", this._onWebSocketCreated.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.webSocketClosed", this._onWebSocketClosed.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.webSocketFrameReceived", this._onWebSocketFrameReceived.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.webSocketFrameSent", this._onWebSocketFrameSent.bind(this)),
       import_eventsHelper.eventsHelper.addEventListener(this._session, "Page.screencastFrame", this._onScreencastFrame.bind(this))
     ];
+    const screencast = this._page.screencast;
+    const videoOptions = screencast.launchVideoRecorder();
+    if (videoOptions)
+      screencast.startVideoRecording(videoOptions).catch((e) => import_debugLogger.debugLogger.log("error", e));
     this._session.once("Page.ready", () => {
       if (this._reportedAsNew)
         return;
@@ -272,9 +275,6 @@ class FFPage {
     this._session.markAsCrashed();
     this._page._didCrash();
   }
-  _onVideoRecordingStarted(event) {
-    this._browserContext._browser._videoStarted(this._browserContext, event.screencastId, event.file, this._page.waitForInitializedOrError());
-  }
   didClose() {
     this._markAsError(new import_errors.TargetClosedError(this._page.closeReason()));
     this._session.dispose();
@@ -418,18 +418,14 @@ class FFPage {
     });
   }
   async startScreencast(options) {
-    const { screencastId } = await this._session.send("Page.startScreencast", options);
-    this._screencastId = screencastId;
+    await this._session.send("Page.startScreencast", options);
   }
   async stopScreencast() {
-    await this._session.send("Page.stopScreencast");
+    await this._session.sendMayFail("Page.stopScreencast");
   }
   _onScreencastFrame(event) {
-    if (!this._screencastId)
-      return;
-    const screencastId = this._screencastId;
     this._page.screencast.throttleFrameAck(() => {
-      this._session.send("Page.screencastFrameAck", { screencastId }).catch((e) => import_debugLogger.debugLogger.log("error", e));
+      this._session.sendMayFail("Page.screencastFrameAck");
     });
     const buffer = Buffer.from(event.data, "base64");
     this._page.emit(import_page2.Page.Events.ScreencastFrame, {

package/lib/server/registry/index.js

@@ -145,68 +145,78 @@ const EXECUTABLE_PATHS = {
     "win-x64": ["PrintDeps.exe"]
   }
 };
+function cftUrl(suffix) {
+  return ({ browserVersion }) => {
+    return {
+      path: `${browserVersion}/${suffix}`,
+      mirrors: [
+        "https://cdn.playwright.dev/chrome-for-testing-public"
+      ]
+    };
+  };
+}
 const DOWNLOAD_PATHS = {
   "chromium": {
     "<unknown>": void 0,
     "ubuntu18.04-x64": void 0,
-    "ubuntu20.04-x64": "builds/chromium/%s/chromium-linux.zip",
-    "ubuntu22.04-x64": "builds/chromium/%s/chromium-linux.zip",
-    "ubuntu24.04-x64": "builds/chromium/%s/chromium-linux.zip",
+    "ubuntu20.04-x64": cftUrl("linux64/chrome-linux64.zip"),
+    "ubuntu22.04-x64": cftUrl("linux64/chrome-linux64.zip"),
+    "ubuntu24.04-x64": cftUrl("linux64/chrome-linux64.zip"),
     "ubuntu18.04-arm64": void 0,
     "ubuntu20.04-arm64": "builds/chromium/%s/chromium-linux-arm64.zip",
     "ubuntu22.04-arm64": "builds/chromium/%s/chromium-linux-arm64.zip",
     "ubuntu24.04-arm64": "builds/chromium/%s/chromium-linux-arm64.zip",
-    "debian11-x64": "builds/chromium/%s/chromium-linux.zip",
+    "debian11-x64": cftUrl("linux64/chrome-linux64.zip"),
     "debian11-arm64": "builds/chromium/%s/chromium-linux-arm64.zip",
-    "debian12-x64": "builds/chromium/%s/chromium-linux.zip",
+    "debian12-x64": cftUrl("linux64/chrome-linux64.zip"),
     "debian12-arm64": "builds/chromium/%s/chromium-linux-arm64.zip",
-    "debian13-x64": "builds/chromium/%s/chromium-linux.zip",
+    "debian13-x64": cftUrl("linux64/chrome-linux64.zip"),
     "debian13-arm64": "builds/chromium/%s/chromium-linux-arm64.zip",
-    "mac10.13": "builds/chromium/%s/chromium-mac.zip",
-    "mac10.14": "builds/chromium/%s/chromium-mac.zip",
-    "mac10.15": "builds/chromium/%s/chromium-mac.zip",
-    "mac11": "builds/chromium/%s/chromium-mac.zip",
-    "mac11-arm64": "builds/chromium/%s/chromium-mac-arm64.zip",
-    "mac12": "builds/chromium/%s/chromium-mac.zip",
-    "mac12-arm64": "builds/chromium/%s/chromium-mac-arm64.zip",
-    "mac13": "builds/chromium/%s/chromium-mac.zip",
-    "mac13-arm64": "builds/chromium/%s/chromium-mac-arm64.zip",
-    "mac14": "builds/chromium/%s/chromium-mac.zip",
-    "mac14-arm64": "builds/chromium/%s/chromium-mac-arm64.zip",
-    "mac15": "builds/chromium/%s/chromium-mac.zip",
-    "mac15-arm64": "builds/chromium/%s/chromium-mac-arm64.zip",
-    "win64": "builds/chromium/%s/chromium-win64.zip"
+    "mac10.13": cftUrl("mac-x64/chrome-mac-x64.zip"),
+    "mac10.14": cftUrl("mac-x64/chrome-mac-x64.zip"),
+    "mac10.15": cftUrl("mac-x64/chrome-mac-x64.zip"),
+    "mac11": cftUrl("mac-x64/chrome-mac-x64.zip"),
+    "mac11-arm64": cftUrl("mac-arm64/chrome-mac-arm64.zip"),
+    "mac12": cftUrl("mac-x64/chrome-mac-x64.zip"),
+    "mac12-arm64": cftUrl("mac-arm64/chrome-mac-arm64.zip"),
+    "mac13": cftUrl("mac-x64/chrome-mac-x64.zip"),
+    "mac13-arm64": cftUrl("mac-arm64/chrome-mac-arm64.zip"),
+    "mac14": cftUrl("mac-x64/chrome-mac-x64.zip"),
+    "mac14-arm64": cftUrl("mac-arm64/chrome-mac-arm64.zip"),
+    "mac15": cftUrl("mac-x64/chrome-mac-x64.zip"),
+    "mac15-arm64": cftUrl("mac-arm64/chrome-mac-arm64.zip"),
+    "win64": cftUrl("win64/chrome-win64.zip")
   },
   "chromium-headless-shell": {
     "<unknown>": void 0,
     "ubuntu18.04-x64": void 0,
-    "ubuntu20.04-x64": "builds/chromium/%s/chromium-headless-shell-linux.zip",
-    "ubuntu22.04-x64": "builds/chromium/%s/chromium-headless-shell-linux.zip",
-    "ubuntu24.04-x64": "builds/chromium/%s/chromium-headless-shell-linux.zip",
+    "ubuntu20.04-x64": cftUrl("linux64/chrome-headless-shell-linux64.zip"),
+    "ubuntu22.04-x64": cftUrl("linux64/chrome-headless-shell-linux64.zip"),
+    "ubuntu24.04-x64": cftUrl("linux64/chrome-headless-shell-linux64.zip"),
     "ubuntu18.04-arm64": void 0,
     "ubuntu20.04-arm64": "builds/chromium/%s/chromium-headless-shell-linux-arm64.zip",
     "ubuntu22.04-arm64": "builds/chromium/%s/chromium-headless-shell-linux-arm64.zip",
     "ubuntu24.04-arm64": "builds/chromium/%s/chromium-headless-shell-linux-arm64.zip",
-    "debian11-x64": "builds/chromium/%s/chromium-headless-shell-linux.zip",
+    "debian11-x64": cftUrl("linux64/chrome-headless-shell-linux64.zip"),
     "debian11-arm64": "builds/chromium/%s/chromium-headless-shell-linux-arm64.zip",
-    "debian12-x64": "builds/chromium/%s/chromium-headless-shell-linux.zip",
+    "debian12-x64": cftUrl("linux64/chrome-headless-shell-linux64.zip"),
     "debian12-arm64": "builds/chromium/%s/chromium-headless-shell-linux-arm64.zip",
-    "debian13-x64": "builds/chromium/%s/chromium-headless-shell-linux.zip",
+    "debian13-x64": cftUrl("linux64/chrome-headless-shell-linux64.zip"),
     "debian13-arm64": "builds/chromium/%s/chromium-headless-shell-linux-arm64.zip",
     "mac10.13": void 0,
     "mac10.14": void 0,
     "mac10.15": void 0,
-    "mac11": "builds/chromium/%s/chromium-headless-shell-mac.zip",
-    "mac11-arm64": "builds/chromium/%s/chromium-headless-shell-mac-arm64.zip",
-    "mac12": "builds/chromium/%s/chromium-headless-shell-mac.zip",
-    "mac12-arm64": "builds/chromium/%s/chromium-headless-shell-mac-arm64.zip",
-    "mac13": "builds/chromium/%s/chromium-headless-shell-mac.zip",
-    "mac13-arm64": "builds/chromium/%s/chromium-headless-shell-mac-arm64.zip",
-    "mac14": "builds/chromium/%s/chromium-headless-shell-mac.zip",
-    "mac14-arm64": "builds/chromium/%s/chromium-headless-shell-mac-arm64.zip",
-    "mac15": "builds/chromium/%s/chromium-headless-shell-mac.zip",
-    "mac15-arm64": "builds/chromium/%s/chromium-headless-shell-mac-arm64.zip",
-    "win64": "builds/chromium/%s/chromium-headless-shell-win64.zip"
+    "mac11": cftUrl("mac-x64/chrome-headless-shell-mac-x64.zip"),
+    "mac11-arm64": cftUrl("mac-arm64/chrome-headless-shell-mac-arm64.zip"),
+    "mac12": cftUrl("mac-x64/chrome-headless-shell-mac-x64.zip"),
+    "mac12-arm64": cftUrl("mac-arm64/chrome-headless-shell-mac-arm64.zip"),
+    "mac13": cftUrl("mac-x64/chrome-headless-shell-mac-x64.zip"),
+    "mac13-arm64": cftUrl("mac-arm64/chrome-headless-shell-mac-arm64.zip"),
+    "mac14": cftUrl("mac-x64/chrome-headless-shell-mac-x64.zip"),
+    "mac14-arm64": cftUrl("mac-arm64/chrome-headless-shell-mac-arm64.zip"),
+    "mac15": cftUrl("mac-x64/chrome-headless-shell-mac-x64.zip"),
+    "mac15-arm64": cftUrl("mac-arm64/chrome-headless-shell-mac-arm64.zip"),
+    "win64": cftUrl("win64/chrome-headless-shell-win64.zip")
   },
   "chromium-tip-of-tree": {
     "<unknown>": void 0,
@@ -1124,8 +1134,16 @@ Run "${buildPlaywrightCLICommand(sdkLanguage, "install " + name)}"` : "";
     const downloadPathTemplate = paths[import_hostPlatform.hostPlatform] || paths["<unknown>"];
     if (!downloadPathTemplate)
       return [];
-    const downloadPath = util.format(downloadPathTemplate, descriptor.revision);
-    let downloadURLs = PLAYWRIGHT_CDN_MIRRORS.map((mirror) => `${mirror}/${downloadPath}`);
+    let downloadPath;
+    let mirrors;
+    if (typeof downloadPathTemplate === "function") {
+      const result = downloadPathTemplate(descriptor);
+      downloadPath = result.path;
+      mirrors = result.mirrors;
+    } else {
+      downloadPath = util.format(downloadPathTemplate, descriptor.revision);
+      mirrors = PLAYWRIGHT_CDN_MIRRORS;
+    }
     let downloadHostEnv;
     if (descriptor.name.startsWith("chromium"))
       downloadHostEnv = "PLAYWRIGHT_CHROMIUM_DOWNLOAD_HOST";
@@ -1135,8 +1153,8 @@ Run "${buildPlaywrightCLICommand(sdkLanguage, "install " + name)}"` : "";
       downloadHostEnv = "PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST";
     const customHostOverride = downloadHostEnv && (0, import_utils.getFromENV)(downloadHostEnv) || (0, import_utils.getFromENV)("PLAYWRIGHT_DOWNLOAD_HOST");
     if (customHostOverride)
-      downloadURLs = [`${customHostOverride}/${downloadPath}`];
-    return downloadURLs;
+      mirrors = [customHostOverride];
+    return mirrors.map((mirror) => `${mirror}/${downloadPath}`);
   }
   async _downloadExecutable(descriptor, executablePath) {
     const downloadURLs = this._downloadURLs(descriptor);

package/lib/server/webkit/wkPage.js

@@ -49,7 +49,6 @@ var import_wkInput = require("./wkInput");
 var import_wkInterceptableRequest = require("./wkInterceptableRequest");
 var import_wkProvisionalPage = require("./wkProvisionalPage");
 var import_wkWorkers = require("./wkWorkers");
-var import_debugLogger = require("../utils/debugLogger");
 var import_webkit = require("./webkit");
 const UTILITY_WORLD_NAME = "__playwright_utility_world__";
 class WKPage {
@@ -836,7 +835,7 @@ class WKPage {
   _onScreencastFrame(event) {
     const generation = this._screencastGeneration;
     this._page.screencast.throttleFrameAck(() => {
-      this._pageProxySession.send("Screencast.screencastFrameAck", { generation }).catch((e) => import_debugLogger.debugLogger.log("error", e));
+      this._pageProxySession.sendMayFail("Screencast.screencastFrameAck", { generation });
     });
     const buffer = Buffer.from(event.data, "base64");
     this._page.emit(import_page.Page.Events.ScreencastFrame, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright-core",
-  "version": "1.58.0-alpha-2025-12-18",
+  "version": "1.58.0-alpha-2025-12-19",
   "description": "A high-level API to automate web browsers",
   "repository": {
     "type": "git",

package/types/types.d.ts

@@ -22046,6 +22046,12 @@ export interface ConnectOverCDPOptions {
    */
   headers?: { [key: string]: string; };
 
+  /**
+   * Tells Playwright that it runs on the same host as the CDP server. It will enable certain optimizations that rely
+   * upon the file system being the same between Playwright and the Browser.
+   */
+  isLocal?: boolean;
+
   /**
    * Logger sink for Playwright logging. Optional.
    * @deprecated The logs received by the logger are incomplete. Please use tracing instead.
@@ -22226,14 +22232,14 @@ export interface BrowserContextOptions {
    */
   agent?: {
     /**
-     * LLM provider to use.
+     * LLM provider to use. Required in non-cache mode.
      */
-    provider: string;
+    provider?: string;
 
     /**
-     * Model identifier within provider.
+     * Model identifier within the provider. Required in non-cache mode.
      */
-    model: string;
+    model?: string;
 
     /**
      * Cache file to use/generate code for performed actions into. Cache is not used if not specified (default).
@@ -22241,9 +22247,9 @@ export interface BrowserContextOptions {
     cacheFile?: string;
 
     /**
-     * Cache control, defaults to 'auto'.
+     * When specified, generated entries are written into the `cacheOutFile` instead of updating the `cacheFile`.
      */
-    cacheMode?: "force"|"ignore"|"update"|"auto";
+    cacheOutFile?: string;
 
     /**
      * Secrets to hide from the LLM.