Add SPA session validation and buglist, update migration docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

node_modules/playwright/lib/plugins/webServerPlugin.js

@@ -115,17 +115,42 @@ class WebServerPlugin {
     });
     this._killProcess = gracefullyClose;
     debugWebServer(`Process started`);
-    launchedProcess.stderr.on("data", (data) => {
-      if (debugWebServer.enabled || (this._options.stderr === "pipe" || !this._options.stderr))
-        this._reporter.onStdErr?.(prefixOutputLines(data.toString(), this._options.name));
-    });
+    if (this._options.wait?.stdout || this._options.wait?.stderr)
+      this._waitForStdioPromise = new import_utils.ManualPromise();
+    const stdioWaitCollectors = {
+      stdout: this._options.wait?.stdout ? "" : void 0,
+      stderr: this._options.wait?.stderr ? "" : void 0
+    };
     launchedProcess.stdout.on("data", (data) => {
       if (debugWebServer.enabled || this._options.stdout === "pipe")
         this._reporter.onStdOut?.(prefixOutputLines(data.toString(), this._options.name));
     });
+    launchedProcess.stderr.on("data", (data) => {
+      if (debugWebServer.enabled || (this._options.stderr === "pipe" || !this._options.stderr))
+        this._reporter.onStdErr?.(prefixOutputLines(data.toString(), this._options.name));
+    });
+    const resolveStdioPromise = () => {
+      stdioWaitCollectors.stdout = void 0;
+      stdioWaitCollectors.stderr = void 0;
+      this._waitForStdioPromise?.resolve();
+    };
+    for (const stdio of ["stdout", "stderr"]) {
+      launchedProcess[stdio].on("data", (data) => {
+        if (!this._options.wait?.[stdio] || stdioWaitCollectors[stdio] === void 0)
+          return;
+        stdioWaitCollectors[stdio] += data.toString();
+        this._options.wait[stdio].lastIndex = 0;
+        const result = this._options.wait[stdio].exec(stdioWaitCollectors[stdio]);
+        if (result) {
+          for (const [key, value] of Object.entries(result.groups || {}))
+            process.env[key.toUpperCase()] = value;
+          resolveStdioPromise();
+        }
+      });
+    }
   }
   async _waitForProcess() {
-    if (!this._isAvailableCallback) {
+    if (!this._isAvailableCallback && !this._waitForStdioPromise) {
       this._processExitedPromise.catch(() => {
       });
       return;
@@ -133,10 +158,13 @@ class WebServerPlugin {
     debugWebServer(`Waiting for availability...`);
     const launchTimeout = this._options.timeout || 60 * 1e3;
     const cancellationToken = { canceled: false };
-    const { timedOut } = await Promise.race([
-      (0, import_utils.raceAgainstDeadline)(() => waitFor(this._isAvailableCallback, cancellationToken), (0, import_utils.monotonicTime)() + launchTimeout),
-      this._processExitedPromise
-    ]);
+    const deadline = (0, import_utils.monotonicTime)() + launchTimeout;
+    const racingPromises = [this._processExitedPromise];
+    if (this._isAvailableCallback)
+      racingPromises.push((0, import_utils.raceAgainstDeadline)(() => waitFor(this._isAvailableCallback, cancellationToken), deadline));
+    if (this._waitForStdioPromise)
+      racingPromises.push((0, import_utils.raceAgainstDeadline)(() => this._waitForStdioPromise, deadline));
+    const { timedOut } = await Promise.race(racingPromises);
     cancellationToken.canceled = true;
     if (timedOut)
       throw new Error(`Timed out waiting ${launchTimeout}ms from config.webServer.`);