playwright 1.56.0-alpha-2025-09-22 → 1.56.0-alpha-2025-09-23

package/lib/mcp/browser/response.js

@@ -27,7 +27,7 @@ class Response {
     this._result = [];
     this._code = [];
     this._images = [];
-    this._includeSnapshot = false;
+    this._includeSnapshot = "none";
     this._includeTabs = false;
     this._context = context;
     this.toolName = toolName;
@@ -58,14 +58,14 @@ class Response {
   images() {
     return this._images;
   }
-  setIncludeSnapshot() {
-    this._includeSnapshot = true;
+  setIncludeSnapshot(full) {
+    this._includeSnapshot = full ?? "partial";
   }
   setIncludeTabs() {
     this._includeTabs = true;
   }
   async finish() {
-    if (this._includeSnapshot && this._context.currentTab())
+    if (this._includeSnapshot !== "none" && this._context.currentTab())
       this._tabSnapshot = await this._context.currentTabOrDie().captureSnapshot();
     for (const tab of this._context.tabs())
       await tab.updateTitle();
@@ -87,13 +87,13 @@ ${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));
       response.push("");
     } else if (this._tabSnapshot) {
-      response.push(renderTabSnapshot(this._tabSnapshot));
+      response.push(renderTabSnapshot(this._tabSnapshot, this._includeSnapshot === "full"));
       response.push("");
     }
     const content = [
@@ -117,7 +117,7 @@ ${this._code.join("\n")}
     }
   }
 }
-function renderTabSnapshot(tabSnapshot) {
+function renderTabSnapshot(tabSnapshot, fullSnapshot) {
   const lines = [];
   if (tabSnapshot.consoleMessages.length) {
     lines.push(`### New console messages`);
@@ -138,10 +138,15 @@ function renderTabSnapshot(tabSnapshot) {
   lines.push(`### Page state`);
   lines.push(`- Page URL: ${tabSnapshot.url}`);
   lines.push(`- Page Title: ${tabSnapshot.title}`);
-  lines.push(`- Page Snapshot:`);
-  lines.push("```yaml");
-  lines.push(tabSnapshot.ariaSnapshot);
-  lines.push("```");
+  if (!fullSnapshot && tabSnapshot.formattedAriaSnapshotDiff) {
+    lines.push(`- Page Snapshot Diff:`);
+    lines.push(tabSnapshot.formattedAriaSnapshotDiff);
+  } else {
+    lines.push(`- Page Snapshot:`);
+    lines.push("```yaml");
+    lines.push(tabSnapshot.ariaSnapshot);
+    lines.push("```");
+  }
   return lines.join("\n");
 }
 function renderTabsMarkdown(tabs, force = false) {

package/lib/mcp/browser/sessionLog.js

@@ -67,7 +67,7 @@ class SessionLog {
     code = code.trim();
     if (isUpdate) {
       const lastEntry = this._pendingEntries[this._pendingEntries.length - 1];
-      if (lastEntry.userAction?.name === action.name) {
+      if (lastEntry?.userAction?.name === action.name) {
         lastEntry.userAction = action;
         lastEntry.code = code;
         return;

package/lib/mcp/browser/tab.js

@@ -25,6 +25,7 @@ __export(tab_exports, {
 module.exports = __toCommonJS(tab_exports);
 var import_events = require("events");
 var import_utils = require("playwright-core/lib/utils");
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var import_utils2 = require("./tools/utils");
 var import_log = require("../log");
 const TabEvents = {
@@ -44,7 +45,11 @@ class Tab extends import_events.EventEmitter {
     this._onPageClose = onPageClose;
     page.on("console", (event) => this._handleConsoleMessage(messageToConsoleMessage(event)));
     page.on("pageerror", (error) => this._handleConsoleMessage(pageErrorToConsoleMessage(error)));
-    page.on("request", (request) => this._requests.set(request, null));
+    page.on("request", (request) => {
+      this._requests.set(request, null);
+      if (request.frame() === page.mainFrame() && request.isNavigationRequest())
+        this._willNavigateMainFrameToNewDocument();
+    });
     page.on("response", (response) => this._requests.set(response.request(), response));
     page.on("close", () => this._onClose());
     page.on("filechooser", (chooser) => {
@@ -62,10 +67,27 @@ class Tab extends import_events.EventEmitter {
     page.setDefaultNavigationTimeout(this.context.config.timeouts.navigation);
     page.setDefaultTimeout(this.context.config.timeouts.action);
     page[tabSymbol] = this;
+    void this._initialize();
   }
   static forPage(page) {
     return page[tabSymbol];
   }
+  async _initialize() {
+    const messages = await this.page.consoleMessages().catch(() => []);
+    for (const message of messages)
+      this._handleConsoleMessage(messageToConsoleMessage(message));
+    const errors = await this.page.pageErrors().catch(() => []);
+    for (const error of errors)
+      this._handleConsoleMessage(pageErrorToConsoleMessage(error));
+    const requests = await this.page.requests().catch(() => []);
+    for (const request of requests) {
+      this._requests.set(request, null);
+      void request.response().catch(() => null).then((response) => {
+        if (response)
+          this._requests.set(request, response);
+      });
+    }
+  }
   modalStates() {
     return this._modalStates;
   }
@@ -110,6 +132,9 @@ class Tab extends import_events.EventEmitter {
     this._clearCollectedArtifacts();
     this._onPageClose(this);
   }
+  _willNavigateMainFrameToNewDocument() {
+    this._lastAriaSnapshot = void 0;
+  }
   async updateTitle() {
     await this._raceAgainstModalStates(async () => {
       this._lastTitle = await (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.title());
@@ -126,6 +151,7 @@ class Tab extends import_events.EventEmitter {
   }
   async navigate(url) {
     this._clearCollectedArtifacts();
+    this._willNavigateMainFrameToNewDocument();
     const downloadEvent = (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.waitForEvent("download").catch(import_log.logUnhandledError));
     try {
       await this.page.goto(url, { waitUntil: "domcontentloaded" });
@@ -159,6 +185,7 @@ class Tab extends import_events.EventEmitter {
         url: this.page.url(),
         title: await this.page.title(),
         ariaSnapshot: snapshot,
+        formattedAriaSnapshotDiff: this._lastAriaSnapshot ? generateAriaSnapshotDiff(this._lastAriaSnapshot, snapshot) : void 0,
         modalStates: [],
         consoleMessages: [],
         downloads: this._downloads
@@ -167,6 +194,7 @@ class Tab extends import_events.EventEmitter {
     if (tabSnapshot) {
       tabSnapshot.consoleMessages = this._recentConsoleMessages;
       this._recentConsoleMessages = [];
+      this._lastAriaSnapshot = tabSnapshot.ariaSnapshot;
     }
     return tabSnapshot ?? {
       url: this.page.url(),
@@ -248,6 +276,23 @@ function renderModalStates(context, modalStates) {
   return result;
 }
 const tabSymbol = Symbol("tabSymbol");
+function generateAriaSnapshotDiff(oldSnapshot, newSnapshot) {
+  const diffs = (0, import_utils.diffAriaSnapshots)(import_utilsBundle.yaml, oldSnapshot, newSnapshot);
+  if (diffs === "equal")
+    return "<no changes>";
+  if (diffs === "different")
+    return;
+  if (diffs.length > 3 || diffs.some((diff) => diff.newSource.split("\n").length > 100)) {
+    return;
+  }
+  const lines = [`The following refs have changed`];
+  for (const diff of diffs)
+    lines.push("", "```yaml", diff.newSource.trimEnd(), "```");
+  const combined = lines.join("\n");
+  if (combined.length >= newSnapshot.length)
+    return;
+  return combined;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Tab,

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

@@ -47,7 +47,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/package.json

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