playwright 1.57.0-alpha-2025-10-08 → 1.57.0-alpha-2025-10-10

package/lib/mcp/browser/tab.js

@@ -222,12 +222,15 @@ class Tab extends import_events.EventEmitter {
     return (await this.refLocators([params]))[0];
   }
   async refLocators(params) {
-    const snapshot = await this.page._snapshotForAI();
-    return params.map((param) => {
-      if (!snapshot.includes(`[ref=${param.ref}]`))
+    return Promise.all(params.map(async (param) => {
+      try {
+        const locator = this.page.locator(`aria-ref=${param.ref}`).describe(param.element);
+        const { resolvedSelector } = await locator._resolveSelector();
+        return { locator, resolved: (0, import_utils.asLocator)("javascript", resolvedSelector) };
+      } catch (e) {
         throw new Error(`Ref ${param.ref} not found in the current page snapshot. Try capturing new snapshot.`);
-      return this.page.locator(`aria-ref=${param.ref}`).describe(param.element);
-    });
+      }
+    }));
   }
   async waitForTimeout(time) {
     if (this._javaScriptBlocked()) {

package/lib/mcp/browser/tools/evaluate.js

@@ -34,7 +34,6 @@ module.exports = __toCommonJS(evaluate_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
 const evaluateSchema = import_bundle.z.object({
   function: import_bundle.z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
   element: import_bundle.z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
@@ -54,12 +53,12 @@ const evaluate = (0, import_tool.defineTabTool)({
     let locator;
     if (params.ref && params.element) {
       locator = await tab.refLocator({ ref: params.ref, element: params.element });
-      response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.evaluate(${javascript.quote(params.function)});`);
+      response.addCode(`await page.${locator.resolved}.evaluate(${javascript.quote(params.function)});`);
     } else {
       response.addCode(`await page.evaluate(${javascript.quote(params.function)});`);
     }
     await tab.waitForCompletion(async () => {
-      const receiver = locator ?? tab.page;
+      const receiver = locator?.locator ?? tab.page;
       const result = await receiver._evaluateFunction(params.function);
       response.addResult(JSON.stringify(result, null, 2) || "undefined");
     });

package/lib/mcp/browser/tools/form.js

@@ -33,7 +33,6 @@ __export(form_exports, {
 module.exports = __toCommonJS(form_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
-var import_utils = require("./utils");
 var codegen = __toESM(require("../codegen"));
 const fillForm = (0, import_tool.defineTabTool)({
   capability: "core",
@@ -53,8 +52,8 @@ const fillForm = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     for (const field of params.fields) {
-      const locator = await tab.refLocator({ element: field.name, ref: field.ref });
-      const locatorSource = `await page.${await (0, import_utils.generateLocator)(locator)}`;
+      const { locator, resolved } = await tab.refLocator({ element: field.name, ref: field.ref });
+      const locatorSource = `await page.${resolved}`;
       if (field.type === "textbox" || field.type === "slider") {
         const secret = tab.context.lookupSecret(field.value);
         await locator.fill(secret.value);

package/lib/mcp/browser/tools/keyboard.js

@@ -24,7 +24,6 @@ module.exports = __toCommonJS(keyboard_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var import_snapshot = require("./snapshot");
-var import_utils = require("./utils");
 const pressKey = (0, import_tool.defineTabTool)({
   capability: "core",
   schema: {
@@ -60,20 +59,20 @@ const type = (0, import_tool.defineTabTool)({
     type: "input"
   },
   handle: async (tab, params, response) => {
-    const locator = await tab.refLocator(params);
+    const { locator, resolved } = await tab.refLocator(params);
     const secret = tab.context.lookupSecret(params.text);
     await tab.waitForCompletion(async () => {
       if (params.slowly) {
         response.setIncludeSnapshot();
-        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.pressSequentially(${secret.code});`);
+        response.addCode(`await page.${resolved}.pressSequentially(${secret.code});`);
         await locator.pressSequentially(secret.value);
       } else {
-        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.fill(${secret.code});`);
+        response.addCode(`await page.${resolved}.fill(${secret.code});`);
         await locator.fill(secret.value);
       }
       if (params.submit) {
         response.setIncludeSnapshot();
-        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.press('Enter');`);
+        response.addCode(`await page.${resolved}.press('Enter');`);
         await locator.press("Enter");
       }
     });

package/lib/mcp/browser/tools/screenshot.js

@@ -68,12 +68,12 @@ const screenshot = (0, import_tool.defineTabTool)({
     const isElementScreenshot = params.element && params.ref;
     const screenshotTarget = isElementScreenshot ? params.element : params.fullPage ? "full page" : "viewport";
     response.addCode(`// Screenshot ${screenshotTarget} and save it as ${fileName}`);
-    const locator = params.ref ? await tab.refLocator({ element: params.element || "", ref: params.ref }) : null;
-    if (locator)
-      response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.screenshot(${javascript.formatObject(options)});`);
+    const ref = params.ref ? await tab.refLocator({ element: params.element || "", ref: params.ref }) : null;
+    if (ref)
+      response.addCode(`await page.${ref.resolved}.screenshot(${javascript.formatObject(options)});`);
     else
       response.addCode(`await page.screenshot(${javascript.formatObject(options)});`);
-    const buffer = locator ? await locator.screenshot(options) : await tab.page.screenshot(options);
+    const buffer = ref ? await ref.locator.screenshot(options) : await tab.page.screenshot(options);
     response.addResult(`Took the ${screenshotTarget} screenshot and saved it as ${fileName}`);
     if (!params.fullPage) {
       response.addImage({

package/lib/mcp/browser/tools/snapshot.js

@@ -35,7 +35,6 @@ module.exports = __toCommonJS(snapshot_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
 const snapshot = (0, import_tool.defineTool)({
   capability: "core",
   schema: {
@@ -70,7 +69,7 @@ const click = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    const locator = await tab.refLocator(params);
+    const { locator, resolved } = await tab.refLocator(params);
     const options = {
       button: params.button,
       modifiers: params.modifiers
@@ -78,9 +77,9 @@ const click = (0, import_tool.defineTabTool)({
     const formatted = javascript.formatObject(options, " ", "oneline");
     const optionsAttr = formatted !== "{}" ? formatted : "";
     if (params.doubleClick)
-      response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.dblclick(${optionsAttr});`);
+      response.addCode(`await page.${resolved}.dblclick(${optionsAttr});`);
     else
-      response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.click(${optionsAttr});`);
+      response.addCode(`await page.${resolved}.click(${optionsAttr});`);
     await tab.waitForCompletion(async () => {
       if (params.doubleClick)
         await locator.dblclick(options);
@@ -105,14 +104,14 @@ const drag = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    const [startLocator, endLocator] = await tab.refLocators([
+    const [start, end] = await tab.refLocators([
       { ref: params.startRef, element: params.startElement },
       { ref: params.endRef, element: params.endElement }
     ]);
     await tab.waitForCompletion(async () => {
-      await startLocator.dragTo(endLocator);
+      await start.locator.dragTo(end.locator);
     });
-    response.addCode(`await page.${await (0, import_utils.generateLocator)(startLocator)}.dragTo(page.${await (0, import_utils.generateLocator)(endLocator)});`);
+    response.addCode(`await page.${start.resolved}.dragTo(page.${end.resolved});`);
   }
 });
 const hover = (0, import_tool.defineTabTool)({
@@ -126,8 +125,8 @@ const hover = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    const locator = await tab.refLocator(params);
-    response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.hover();`);
+    const { locator, resolved } = await tab.refLocator(params);
+    response.addCode(`await page.${resolved}.hover();`);
     await tab.waitForCompletion(async () => {
       await locator.hover();
     });
@@ -147,8 +146,8 @@ const selectOption = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    const locator = await tab.refLocator(params);
-    response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.selectOption(${javascript.formatObject(params.values)});`);
+    const { locator, resolved } = await tab.refLocator(params);
+    response.addCode(`await page.${resolved}.selectOption(${javascript.formatObject(params.values)});`);
     await tab.waitForCompletion(async () => {
       await locator.selectOption(params.values);
     });
@@ -164,8 +163,8 @@ const pickLocator = (0, import_tool.defineTabTool)({
     type: "readOnly"
   },
   handle: async (tab, params, response) => {
-    const locator = await tab.refLocator(params);
-    response.addResult(await (0, import_utils.generateLocator)(locator));
+    const { resolved } = await tab.refLocator(params);
+    response.addResult(resolved);
   }
 });
 var snapshot_default = [

package/lib/mcp/browser/tools/utils.js

@@ -20,11 +20,9 @@ var utils_exports = {};
 __export(utils_exports, {
   callOnPageNoTrace: () => callOnPageNoTrace,
   dateAsFileName: () => dateAsFileName,
-  generateLocator: () => generateLocator,
   waitForCompletion: () => waitForCompletion
 });
 module.exports = __toCommonJS(utils_exports);
-var import_utils = require("playwright-core/lib/utils");
 async function waitForCompletion(tab, callback) {
   const requests = /* @__PURE__ */ new Set();
   let frameNavigated = false;
@@ -76,14 +74,6 @@ async function waitForCompletion(tab, callback) {
     dispose();
   }
 }
-async function generateLocator(locator) {
-  try {
-    const { resolvedSelector } = await locator._resolveSelector();
-    return (0, import_utils.asLocator)("javascript", resolvedSelector);
-  } catch (e) {
-    throw new Error("Ref not found, likely because element was removed. Use browser_snapshot to see what elements are currently on the page.");
-  }
-}
 async function callOnPageNoTrace(page, callback) {
   return await page._wrapApiCall(() => callback(page), { internal: true });
 }
@@ -95,6 +85,5 @@ function dateAsFileName(extension) {
 0 && (module.exports = {
   callOnPageNoTrace,
   dateAsFileName,
-  generateLocator,
   waitForCompletion
 });

package/lib/mcp/browser/tools/verify.js

@@ -34,7 +34,6 @@ module.exports = __toCommonJS(verify_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
 const verifyElement = (0, import_tool.defineTabTool)({
   capability: "testing",
   schema: {
@@ -92,7 +91,7 @@ const verifyList = (0, import_tool.defineTabTool)({
     type: "assertion"
   },
   handle: async (tab, params, response) => {
-    const locator = await tab.refLocator({ ref: params.ref, element: params.element });
+    const { locator } = await tab.refLocator({ ref: params.ref, element: params.element });
     const itemTexts = [];
     for (const item of params.items) {
       const itemLocator = locator.getByText(item);
@@ -125,8 +124,8 @@ const verifyValue = (0, import_tool.defineTabTool)({
     type: "assertion"
   },
   handle: async (tab, params, response) => {
-    const locator = await tab.refLocator({ ref: params.ref, element: params.element });
-    const locatorSource = `page.${await (0, import_utils.generateLocator)(locator)}`;
+    const { locator, resolved } = await tab.refLocator({ ref: params.ref, element: params.element });
+    const locatorSource = `page.${resolved}`;
     if (params.type === "textbox" || params.type === "slider" || params.type === "combobox") {
       const value = await locator.inputValue();
       if (value !== params.value) {

package/lib/reporters/html.js

@@ -197,8 +197,6 @@ function startHtmlReportServer(folder) {
         return false;
       }
     }
-    if (relativePath.endsWith("/stall.js"))
-      return true;
     if (relativePath === "/")
       relativePath = "/index.html";
     const absolutePath = import_path.default.join(folder, ...relativePath.split("/"));
@@ -274,25 +272,6 @@ class HtmlBuilder {
       const testFile = data.values().next().value.testFile;
       singleTestId = testFile.tests[0].testId;
     }
-    if (process.env.PW_HMR === "1") {
-      const redirectFile = import_path.default.join(this._reportFolder, "index.html");
-      await this._writeReportData(redirectFile);
-      async function redirect() {
-        const hmrURL = new URL("http://localhost:44224");
-        const popup = window.open(hmrURL);
-        const listener = (evt) => {
-          if (evt.source === popup && evt.data === "ready") {
-            const element = document.getElementById("playwrightReportBase64");
-            popup.postMessage(element?.textContent ?? "", hmrURL.origin);
-            window.removeEventListener("message", listener);
-            window.close();
-          }
-        };
-        window.addEventListener("message", listener);
-      }
-      import_fs.default.appendFileSync(redirectFile, `<script>(${redirect.toString()})()</script>`);
-      return { ok, singleTestId };
-    }
     const appFolder = import_path.default.join(require.resolve("playwright-core"), "..", "lib", "vite", "htmlReport");
     await (0, import_utils.copyFileAndMakeWritable)(import_path.default.join(appFolder, "index.html"), import_path.default.join(this._reportFolder, "index.html"));
     if (this._hasTraces) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright",
-  "version": "1.57.0-alpha-2025-10-08",
+  "version": "1.57.0-alpha-2025-10-10",
   "description": "A high-level API to automate web browsers",
   "repository": {
     "type": "git",
@@ -64,7 +64,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "playwright-core": "1.57.0-alpha-2025-10-08"
+    "playwright-core": "1.57.0-alpha-2025-10-10"
   },
   "optionalDependencies": {
     "fsevents": "2.3.2"