playwright 1.57.0-alpha-2025-10-13 → 1.57.0-alpha-2025-10-15

package/lib/mcp/browser/config.js

@@ -260,7 +260,7 @@ async function resolveFile(config, clientInfo, fileName, options) {
     fileName = fileName.split("\\").join("/");
     const resolvedFile = import_path.default.resolve(dir, fileName);
     if (!resolvedFile.startsWith(import_path.default.resolve(dir) + import_path.default.sep))
-      throw new Error(`Resolved file path for ${fileName} is outside of the output directory`);
+      throw new Error(`Resolved file path ${resolvedFile} is outside of the output directory ${dir}. Use relative file names to stay within the output directory.`);
     return resolvedFile;
   }
   return import_path.default.join(dir, sanitizeForFilePath(fileName));

package/lib/mcp/browser/response.js

@@ -31,7 +31,7 @@ class Response {
     this._result = [];
     this._code = [];
     this._images = [];
-    this._includeSnapshot = false;
+    this._includeSnapshot = "none";
     this._includeTabs = false;
     this._context = context;
     this.toolName = toolName;
@@ -62,15 +62,15 @@ class Response {
   images() {
     return this._images;
   }
-  setIncludeSnapshot() {
-    this._includeSnapshot = true;
+  setIncludeSnapshot(full) {
+    this._includeSnapshot = full ?? "incremental";
   }
   setIncludeTabs() {
     this._includeTabs = true;
   }
   async finish() {
-    if (this._includeSnapshot && this._context.currentTab())
-      this._tabSnapshot = await this._context.currentTabOrDie().captureSnapshot();
+    if (this._includeSnapshot !== "none" && this._context.currentTab())
+      this._tabSnapshot = await this._context.currentTabOrDie().captureSnapshot(this._includeSnapshot);
     for (const tab of this._context.tabs())
       await tab.updateTitle();
   }
@@ -99,7 +99,7 @@ ${this._code.join("\n")}
 \`\`\``);
       response.push("");
     }
-    if (this._includeSnapshot || this._includeTabs)
+    if (this._includeSnapshot !== "none" || this._includeTabs)
       response.push(...renderTabsMarkdown(this._context.tabs(), this._includeTabs));
     if (this._tabSnapshot?.modalStates.length) {
       response.push(...(0, import_tab.renderModalStates)(this._context, this._tabSnapshot.modalStates));

package/lib/mcp/browser/tab.js

@@ -172,10 +172,10 @@ class Tab extends import_events.EventEmitter {
     await this._initializedPromise;
     return this._requests;
   }
-  async captureSnapshot() {
+  async captureSnapshot(mode) {
     let tabSnapshot;
     const modalStates = await this._raceAgainstModalStates(async () => {
-      const snapshot = await this.page._snapshotForAI();
+      const snapshot = await this.page._snapshotForAI({ mode, track: "response" });
       tabSnapshot = {
         url: this.page.url(),
         title: await this.page.title(),

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

@@ -36,7 +36,7 @@ var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
 var import_utils = require("./utils");
 const pdfSchema = import_bundle.z.object({
-  filename: import_bundle.z.string().optional().describe("File name to save the pdf to. Defaults to `page-{timestamp}.pdf` if not specified.")
+  filename: import_bundle.z.string().optional().describe("File name to save the pdf to. Defaults to `page-{timestamp}.pdf` if not specified. Prefer relative file names to stay within the output directory.")
 });
 const pdf = (0, import_tool.defineTabTool)({
   capability: "pdf",

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

@@ -28,16 +28,20 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var screenshot_exports = {};
 __export(screenshot_exports, {
-  default: () => screenshot_default
+  default: () => screenshot_default,
+  scaleImageToFitMessage: () => scaleImageToFitMessage
 });
 module.exports = __toCommonJS(screenshot_exports);
+var import_fs = __toESM(require("fs"));
+var import_utils = require("playwright-core/lib/utils");
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
+var import_utils2 = require("./utils");
 const screenshotSchema = import_bundle.z.object({
   type: import_bundle.z.enum(["png", "jpeg"]).default("png").describe("Image format for the screenshot. Default is png."),
-  filename: import_bundle.z.string().optional().describe("File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified."),
+  filename: import_bundle.z.string().optional().describe("File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified. Prefer relative file names to stay within the output directory."),
   element: import_bundle.z.string().optional().describe("Human-readable element description used to obtain permission to screenshot the element. If not provided, the screenshot will be taken of viewport. If element is provided, ref must be provided too."),
   ref: import_bundle.z.string().optional().describe("Exact target element reference from the page snapshot. If not provided, the screenshot will be taken of viewport. If ref is provided, element must be provided too."),
   fullPage: import_bundle.z.boolean().optional().describe("When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots.")
@@ -57,12 +61,11 @@ const screenshot = (0, import_tool.defineTabTool)({
     if (params.fullPage && params.ref)
       throw new Error("fullPage cannot be used with element screenshots.");
     const fileType = params.type || "png";
-    const fileName = await tab.context.outputFile(params.filename ?? (0, import_utils.dateAsFileName)(fileType), { origin: "llm", reason: "Saving screenshot" });
+    const fileName = await tab.context.outputFile(params.filename ?? (0, import_utils2.dateAsFileName)(fileType), { origin: "llm", reason: "Saving screenshot" });
     const options = {
       type: fileType,
       quality: fileType === "png" ? void 0 : 90,
       scale: "css",
-      path: fileName,
       ...params.fullPage !== void 0 && { fullPage: params.fullPage }
     };
     const isElementScreenshot = params.element && params.ref;
@@ -74,15 +77,30 @@ const screenshot = (0, import_tool.defineTabTool)({
     else
       response.addCode(`await page.screenshot(${javascript.formatObject(options)});`);
     const buffer = ref ? await ref.locator.screenshot(options) : await tab.page.screenshot(options);
+    await (0, import_utils.mkdirIfNeeded)(fileName);
+    await import_fs.default.promises.writeFile(fileName, buffer);
     response.addResult(`Took the ${screenshotTarget} screenshot and saved it as ${fileName}`);
-    if (!params.fullPage) {
-      response.addImage({
-        contentType: fileType === "png" ? "image/png" : "image/jpeg",
-        data: buffer
-      });
-    }
+    response.addImage({
+      contentType: fileType === "png" ? "image/png" : "image/jpeg",
+      data: scaleImageToFitMessage(buffer, fileType)
+    });
   }
 });
+function scaleImageToFitMessage(buffer, imageType) {
+  const image = imageType === "png" ? import_utilsBundle.PNG.sync.read(buffer) : import_utilsBundle.jpegjs.decode(buffer, { maxMemoryUsageInMB: 512 });
+  const pixels = image.width * image.height;
+  const shrink = Math.min(1568 / image.width, 1568 / image.height, Math.sqrt(1.15 * 1024 * 1024 / pixels));
+  if (shrink > 1)
+    return buffer;
+  const width = image.width * shrink | 0;
+  const height = image.height * shrink | 0;
+  const scaledImage = (0, import_utils.scaleImageToSize)(image, { width, height });
+  return imageType === "png" ? import_utilsBundle.PNG.sync.write(scaledImage) : import_utilsBundle.jpegjs.encode(scaledImage, 80).data;
+}
 var screenshot_default = [
   screenshot
 ];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  scaleImageToFitMessage
+});

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

@@ -46,7 +46,7 @@ const snapshot = (0, import_tool.defineTool)({
   },
   handle: async (context, params, response) => {
     await context.ensureTab();
-    response.setIncludeSnapshot();
+    response.setIncludeSnapshot("full");
   }
 });
 const elementSchema = import_bundle.z.object({

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

@@ -49,14 +49,14 @@ const browserTabs = (0, import_tool.defineTool)({
       }
       case "close": {
         await context.closeTab(params.index);
-        response.setIncludeSnapshot();
+        response.setIncludeSnapshot("full");
         return;
       }
       case "select": {
         if (params.index === void 0)
           throw new Error("Tab index is required");
         await context.selectTab(params.index);
-        response.setIncludeSnapshot();
+        response.setIncludeSnapshot("full");
         return;
       }
     }

package/lib/worker/testInfo.js

@@ -107,11 +107,17 @@ class TestInfoImpl {
       return import_path.default.join(this.project.snapshotDir, relativeTestFilePath + "-snapshots");
     })();
     this._attachmentsPush = this.attachments.push.bind(this.attachments);
-    this.attachments.push = (...attachments) => {
+    const attachmentsPush = (...attachments) => {
       for (const a of attachments)
         this._attach(a, this._parentStep()?.stepId);
       return this.attachments.length;
     };
+    Object.defineProperty(this.attachments, "push", {
+      value: attachmentsPush,
+      writable: true,
+      enumerable: false,
+      configurable: true
+    });
     this._tracing = new import_testTracing.TestTracing(this, workerParams.artifactsDir);
     this.skip = (0, import_transform.wrapFunctionWithLocation)((location, ...args) => this._modifier("skip", location, args));
     this.fixme = (0, import_transform.wrapFunctionWithLocation)((location, ...args) => this._modifier("fixme", location, args));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright",
-  "version": "1.57.0-alpha-2025-10-13",
+  "version": "1.57.0-alpha-2025-10-15",
   "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-13"
+    "playwright-core": "1.57.0-alpha-2025-10-15"
   },
   "optionalDependencies": {
     "fsevents": "2.3.2"