playwright-core 1.57.0-alpha-2025-10-27 → 1.57.0-alpha-2025-10-29

package/lib/server/page.js

@@ -667,7 +667,7 @@ class Page extends import_instrumentation.SdkObject {
   }
   async snapshotForAI(progress, options) {
     const snapshot = await snapshotFrameForAI(progress, this.mainFrame(), options);
-    return snapshot.join("\n");
+    return snapshot.lines.join("\n");
   }
 }
 class Worker extends import_instrumentation.SdkObject {
@@ -808,7 +808,7 @@ class FrameThrottler {
   }
 }
 async function snapshotFrameForAI(progress, frame, options) {
-  const snapshot = await frame.retryWithProgressAndTimeouts(progress, [1e3, 2e3, 4e3, 8e3], async (continuePolling) => {
+  const { snapshot, iframeRefs, isIncremental } = await frame.retryWithProgressAndTimeouts(progress, [1e3, 2e3, 4e3, 8e3], async (continuePolling) => {
     try {
       const context = await progress.race(frame._utilityContext());
       const injectedScript = await progress.race(context.injectedScript());
@@ -816,8 +816,8 @@ async function snapshotFrameForAI(progress, frame, options) {
         const node = injected.document.body;
         if (!node)
           return true;
-        return injected.ariaSnapshot(node, { mode: "ai", ...options2 });
-      }, { refPrefix: frame.seq ? "f" + frame.seq : "", incremental: options.mode === "incremental" && !frame.parentFrame(), track: options.track }));
+        return injected.incrementalAriaSnapshot(node, { mode: "ai", ...options2 });
+      }, { refPrefix: frame.seq ? "f" + frame.seq : "", incremental: options.mode === "incremental", track: options.track }));
       if (snapshotOrRetry === true)
         return continuePolling;
       return snapshotOrRetry;
@@ -829,29 +829,44 @@ async function snapshotFrameForAI(progress, frame, options) {
   });
   const lines = snapshot.split("\n");
   const result = [];
+  if (isIncremental) {
+    result.push(...lines);
+    for (const ref of iframeRefs) {
+      const childSnapshot = await snapshotFrameRefForAI(progress, frame, ref, options);
+      if (!childSnapshot.lines.length)
+        continue;
+      if (childSnapshot.isIncremental)
+        result.push(...childSnapshot.lines);
+      else
+        result.push("- <changed> iframe [ref=" + ref + "]:", ...childSnapshot.lines.map((l) => "  " + l));
+    }
+    return { lines: result, isIncremental };
+  }
   for (const line of lines) {
-    const match = line.match(/^(\s*)-(?: <changed>)? iframe (?:\[active\] )?\[ref=([^\]]*)\]/);
+    const match = line.match(/^(\s*)- iframe (?:\[active\] )?\[ref=([^\]]*)\]/);
     if (!match) {
       result.push(line);
       continue;
     }
     const leadingSpace = match[1];
     const ref = match[2];
-    const frameSelector = `aria-ref=${ref} >> internal:control=enter-frame`;
-    const frameBodySelector = `${frameSelector} >> body`;
-    const child = await progress.race(frame.selectors.resolveFrameForSelector(frameBodySelector, { strict: true }));
-    if (!child) {
-      result.push(line);
-      continue;
-    }
-    try {
-      const childSnapshot = await snapshotFrameForAI(progress, child.frame, options);
-      result.push(line + ":", ...childSnapshot.map((l) => leadingSpace + "  " + l));
-    } catch {
-      result.push(line);
-    }
+    const childSnapshot = await snapshotFrameRefForAI(progress, frame, ref, options);
+    result.push(childSnapshot.lines.length ? line + ":" : line);
+    result.push(...childSnapshot.lines.map((l) => leadingSpace + "  " + l));
+  }
+  return { lines: result, isIncremental };
+}
+async function snapshotFrameRefForAI(progress, parentFrame, frameRef, options) {
+  const frameSelector = `aria-ref=${frameRef} >> internal:control=enter-frame`;
+  const frameBodySelector = `${frameSelector} >> body`;
+  const child = await progress.race(parentFrame.selectors.resolveFrameForSelector(frameBodySelector, { strict: true }));
+  if (!child)
+    return { lines: [], isIncremental: false };
+  try {
+    return await snapshotFrameForAI(progress, child.frame, options);
+  } catch {
+    return { lines: [], isIncremental: false };
   }
-  return result;
 }
 function ensureArrayLimit(array, limit) {
   if (array.length > limit)

package/lib/server/registry/index.js

@@ -1003,7 +1003,7 @@ Run "${buildPlaywrightCLICommand(sdkLanguage, "install " + name)}"` : "";
     if (import_os.default.platform() === "linux")
       return await (0, import_dependencies2.installDependenciesLinux)(targets, dryRun);
   }
-  async install(executablesToInstall, forceReinstall) {
+  async install(executablesToInstall, options) {
     const executables = this._dedupe(executablesToInstall);
     await import_fs.default.promises.mkdir(registryDirectory, { recursive: true });
     const lockfilePath = import_path.default.join(registryDirectory, "__dirlock");
@@ -1031,7 +1031,7 @@ Run "${buildPlaywrightCLICommand(sdkLanguage, "install " + name)}"` : "";
         if (!executable._install)
           throw new Error(`ERROR: Playwright does not support installing ${executable.name}`);
         const { embedderName } = (0, import_userAgent.getEmbedderName)();
-        if (!(0, import_utils.getAsBooleanFromENV)("CI") && !executable._isHermeticInstallation && !forceReinstall && executable.executablePath(embedderName)) {
+        if (!(0, import_utils.getAsBooleanFromENV)("CI") && !executable._isHermeticInstallation && !options?.force && executable.executablePath(embedderName)) {
           const command = buildPlaywrightCLICommand(embedderName, "install --force " + executable.name);
           process.stderr.write("\n" + (0, import_ascii.wrapInASCIIBox)([
             `ATTENTION: "${executable.name}" is already installed on the system!`,
@@ -1275,6 +1275,47 @@ ${e.stack}`);
       await import_fs.default.promises.unlink(linkPath).catch((e) => {
       });
   }
+  _defaultBrowsersToInstall(options) {
+    let executables = this.defaultExecutables();
+    if (options.shell === "no")
+      executables = executables.filter((e) => e.name !== "chromium-headless-shell");
+    if (options.shell === "only")
+      executables = executables.filter((e) => e.name !== "chromium");
+    return executables;
+  }
+  suggestedBrowsersToInstall() {
+    return this.executables().filter((e) => e.installType !== "none" && e.type !== "tool").map((e) => e.name).join(", ");
+  }
+  resolveBrowsers(aliases, options) {
+    if (aliases.length === 0)
+      return this._defaultBrowsersToInstall(options);
+    const faultyArguments = [];
+    const executables = [];
+    const handleArgument = (arg) => {
+      const executable = this.findExecutable(arg);
+      if (!executable || executable.installType === "none")
+        faultyArguments.push(arg);
+      else
+        executables.push(executable);
+      if (executable?.browserName === "chromium")
+        executables.push(this.findExecutable("ffmpeg"));
+    };
+    for (const alias of aliases) {
+      if (alias === "chromium") {
+        if (options.shell !== "only")
+          handleArgument("chromium");
+        if (options.shell !== "no")
+          handleArgument("chromium-headless-shell");
+      } else {
+        handleArgument(alias);
+      }
+    }
+    if (process.platform === "win32")
+      executables.push(this.findExecutable("winldd"));
+    if (faultyArguments.length)
+      throw new Error(`Invalid installation targets: ${faultyArguments.map((name) => `'${name}'`).join(", ")}. Expecting one of: ${this.suggestedBrowsersToInstall()}`);
+    return executables;
+  }
 }
 function browserDirectoryToMarkerFilePath(browserDirectory) {
   return import_path.default.join(browserDirectory, "INSTALLATION_COMPLETE");
@@ -1307,11 +1348,7 @@ async function installBrowsersForNpmInstall(browsers) {
       throw new Error(`Cannot install ${browserName}`);
     executables.push(executable);
   }
-  await registry.install(
-    executables,
-    false
-    /* forceReinstall */
-  );
+  await registry.install(executables);
 }
 function findChromiumChannelBestEffort(sdkLanguage) {
   let channel = null;