playwright-core 1.58.0-alpha-2025-12-06 → 1.58.0-alpha-2025-12-07

package/lib/client/page.js

@@ -62,6 +62,7 @@ class Page extends import_channelOwner.ChannelOwner {
     this._closeWasCalled = false;
     this._harRouters = [];
     this._locatorHandlers = /* @__PURE__ */ new Map();
+    this._instrumentation.onPage(this);
     this._browserContext = parent;
     this._timeoutSettings = new import_timeoutSettings.TimeoutSettings(this._platform, this._browserContext._timeoutSettings);
     this.keyboard = new import_input.Keyboard(this);
@@ -673,6 +674,12 @@ class Page extends import_channelOwner.ChannelOwner {
     }
     return result.pdf;
   }
+  async perform(task, options = {}) {
+    throw new Error("Not implemented in playwright-core");
+  }
+  extract(query, schema, options = {}) {
+    throw new Error("Not implemented in playwright-core");
+  }
   async _snapshotForAI(options = {}) {
     return await this._channel.snapshotForAI({ timeout: this._timeoutSettings.timeout(options), track: options.track });
   }

package/lib/protocol/validator.js

@@ -608,6 +608,12 @@ import_validatorPrimitives.scheme.BrowserTypeLaunchPersistentContextParams = (0,
   serviceWorkers: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["allow", "block"])),
   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,
+    cacheDir: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+    cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"]))
+  })),
   userDataDir: import_validatorPrimitives.tString,
   slowMo: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tFloat)
 });
@@ -700,6 +706,12 @@ import_validatorPrimitives.scheme.BrowserNewContextParams = (0, import_validator
   serviceWorkers: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["allow", "block"])),
   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,
+    cacheDir: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+    cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"]))
+  })),
   proxy: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
     server: import_validatorPrimitives.tString,
     bypass: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
@@ -771,6 +783,12 @@ import_validatorPrimitives.scheme.BrowserNewContextForReuseParams = (0, import_v
   serviceWorkers: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["allow", "block"])),
   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,
+    cacheDir: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+    cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"]))
+  })),
   proxy: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({
     server: import_validatorPrimitives.tString,
     bypass: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
@@ -886,7 +904,13 @@ import_validatorPrimitives.scheme.BrowserContextInitializer = (0, import_validat
     strictSelectors: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tBoolean),
     serviceWorkers: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["allow", "block"])),
     selectorEngines: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)((0, import_validatorPrimitives.tType)("SelectorEngine"))),
-    testIdAttributeName: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString)
+    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,
+      cacheDir: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+      cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"]))
+    }))
   })
 });
 import_validatorPrimitives.scheme.BrowserContextBindingCallEvent = (0, import_validatorPrimitives.tObject)({
@@ -2776,6 +2800,12 @@ import_validatorPrimitives.scheme.AndroidDeviceLaunchBrowserParams = (0, import_
   serviceWorkers: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["allow", "block"])),
   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,
+    cacheDir: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
+    cacheMode: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tEnum)(["ignore", "force", "auto"]))
+  })),
   pkg: (0, import_validatorPrimitives.tOptional)(import_validatorPrimitives.tString),
   args: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tArray)(import_validatorPrimitives.tString)),
   proxy: (0, import_validatorPrimitives.tOptional)((0, import_validatorPrimitives.tObject)({

package/lib/server/browserContext.js

@@ -145,7 +145,7 @@ if (navigator.serviceWorker) navigator.serviceWorker.register = async () => { co
     return true;
   }
   static reusableContextHash(params) {
-    const paramsCopy = { ...params };
+    const paramsCopy = { ...params, agent: void 0 };
     if (paramsCopy.selectorEngines?.length === 0)
       delete paramsCopy.selectorEngines;
     for (const k of Object.keys(paramsCopy)) {

package/package.json

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

package/types/types.d.ts

@@ -27,6 +27,11 @@ type ElementHandleWaitForSelectorOptionsNotHidden = ElementHandleWaitForSelector
   state?: 'visible'|'attached';
 };
 
+// @ts-ignore this will be any if zod is not installed
+type ZodTypeAny = import('zod').ZodTypeAny;
+// @ts-ignore this will be any if zod is not installed
+type ZodInfer<T extends ZodTypeAny> = import('zod').infer<T>;
+
 /**
  * Page provides methods to interact with a single tab in a [Browser](https://playwright.dev/docs/api/class-browser),
  * or an [extension background page](https://developer.chrome.com/extensions/background_pages) in Chromium. One
@@ -1013,6 +1018,24 @@ export interface Page {
      */
     behavior?: 'wait'|'ignoreErrors'|'default'
   }): Promise<void>;
+
+  /**
+   * Extract information from the page using the agentic loop, return it in a given Zod format.
+   *
+   * **Usage**
+   *
+   * ```js
+   * await page.extract('List of items in the cart', z.object({
+   *   title: z.string().describe('Item title to extract'),
+   *   price: z.string().describe('Item price to extract'),
+   * }).array());
+   * ```
+   *
+   * @param query Task to perform using agentic loop.
+   * @param schema
+   * @param options
+   */
+  extract<Schema extends ZodTypeAny>(query: string, schema: Schema): Promise<ZodInfer<Schema>>;
   /**
    * Emitted when the page closes.
    */
@@ -3796,6 +3819,31 @@ export interface Page {
     width?: string|number;
   }): Promise<Buffer>;
 
+  /**
+   * Perform action using agentic loop.
+   *
+   * **Usage**
+   *
+   * ```js
+   * await page.perform('Click submit button');
+   * ```
+   *
+   * @param task Task to perform using agentic loop.
+   * @param options
+   */
+  perform(task: string, options?: {
+    /**
+     * All the agentic actions are converted to the Playwright calls and are cached. By default, they are cached globally
+     * with the `task` as a key. This option allows controlling the cache key explicitly.
+     */
+    key?: string;
+
+    /**
+     * Maximum number of agentic steps to take while performing this action.
+     */
+    maxTurns?: number;
+  }): Promise<void>;
+
   /**
    * **NOTE** Use locator-based [locator.press(key[, options])](https://playwright.dev/docs/api/class-locator#locator-press)
    * instead. Read more about [locators](https://playwright.dev/docs/locators).
@@ -22033,6 +22081,32 @@ export interface BrowserContextOptions {
    */
   acceptDownloads?: boolean;
 
+  /**
+   * Agent settings for [page.perform(task[, options])](https://playwright.dev/docs/api/class-page#page-perform) and
+   * [page.extract(query, schema[, options])](https://playwright.dev/docs/api/class-page#page-extract).
+   */
+  agent?: {
+    /**
+     * LLM provider to use
+     */
+    provider: string;
+
+    /**
+     * Model identifier within provider
+     */
+    model: string;
+
+    /**
+     * Cache folder to use/generate code for performed actions into. Cache is not used if not specified (default).
+     */
+    cacheDir?: string;
+
+    /**
+     * Cache control, defauls to 'auto'
+     */
+    cacheMode?: 'force'|'ignore'|'auto';
+  };
+
   /**
    * When using [page.goto(url[, options])](https://playwright.dev/docs/api/class-page#page-goto),
    * [page.route(url, handler[, options])](https://playwright.dev/docs/api/class-page#page-route),