playwright 1.56.0-beta-1759435110000 → 1.57.0-alpha-2025-10-03

package/lib/agents/generator.md

@@ -46,6 +46,7 @@ application behavior.
   - Test title must match the scenario name
   - Includes a comment with the step text before each step execution. Do not duplicate comments if step requires
     multiple actions.
+  - Always use best practices from the log when generating tests.
 
    <example-generation>
    For following plan:
@@ -79,18 +80,6 @@ application behavior.
    ```
    </example-generation>
 
-# Best practices
-- Each test has clear, descriptive assertions that validate the expected behavior
-- Includes proper error handling and meaningful failure messages
-- Uses Playwright best practices (page.waitForLoadState, expect.toBeVisible, etc.)
-- Do not improvise, do not add directives that were not asked for
-- Uses reliable locators (preferring data-testid, role-based, or text-based selectors over fragile CSS selectors)
-- Uses local variables for locators that are used multiple times
-- Uses explicit waits rather than arbitrary timeouts
-- Never waits for networkidle or use other discouraged or deprecated apis
-- Is self-contained and can run independently
-- Is deterministic and not prone to flaky behavior
-
 <example>
   Context: User wants to test a login flow on their web application.
   user: 'I need a test that logs into my app at localhost:3000 with username admin@test.com and password 123456, then

package/lib/mcp/sdk/http.js

@@ -67,11 +67,12 @@ function httpAddressToString(address) {
     resolvedHost = "localhost";
   return `http://${resolvedHost}:${resolvedPort}`;
 }
-async function installHttpTransport(httpServer, serverBackendFactory, allowedHosts) {
+async function installHttpTransport(httpServer, serverBackendFactory, unguessableUrl, allowedHosts) {
   const url = httpAddressToString(httpServer.address());
   const host = new URL(url).host;
   allowedHosts = (allowedHosts || [host]).map((h) => h.toLowerCase());
   const allowAnyHost = allowedHosts.includes("*");
+  const pathPrefix = unguessableUrl ? `/${import_crypto.default.randomUUID()}` : "";
   const sseSessions = /* @__PURE__ */ new Map();
   const streamableSessions = /* @__PURE__ */ new Map();
   httpServer.on("request", async (req, res) => {
@@ -86,7 +87,12 @@ async function installHttpTransport(httpServer, serverBackendFactory, allowedHos
         return res.end("Access is only allowed at " + allowedHosts.join(", "));
       }
     }
-    const url2 = new URL(`http://localhost${req.url}`);
+    if (!req.url?.startsWith(pathPrefix)) {
+      res.statusCode = 404;
+      return res.end("Not found");
+    }
+    const path = req.url?.slice(pathPrefix.length);
+    const url2 = new URL(`http://localhost${path}`);
     if (url2.pathname === "/killkillkill" && req.method === "GET") {
       res.statusCode = 200;
       res.end("Killing process");
@@ -98,6 +104,7 @@ async function installHttpTransport(httpServer, serverBackendFactory, allowedHos
     else
       await handleStreamable(serverBackendFactory, req, res, streamableSessions);
   });
+  return `${url}${pathPrefix}`;
 }
 async function handleSSE(serverBackendFactory, req, res, url, sessions) {
   if (req.method === "POST") {

package/lib/mcp/sdk/mdb.js

@@ -153,8 +153,7 @@ async function runOnPauseBackendLoop(backend, introMessage) {
     create: () => wrappedBackend
   };
   const httpServer = await mcpHttp.startHttpServer({ port: 0 });
-  await mcpHttp.installHttpTransport(httpServer, factory);
-  const url = mcpHttp.httpAddressToString(httpServer.address());
+  const url = await mcpHttp.installHttpTransport(httpServer, factory, true);
   const client = new mcpBundle.Client({ name: "Pushing client", version: "0.0.0" });
   client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
   const transport = new mcpBundle.StreamableHTTPClientTransport(new URL(process.env.PLAYWRIGHT_DEBUGGER_MCP));
@@ -175,8 +174,7 @@ async function runOnPauseBackendLoop(backend, introMessage) {
 }
 async function startAsHttp(backendFactory, options) {
   const httpServer = await mcpHttp.startHttpServer(options);
-  await mcpHttp.installHttpTransport(httpServer, backendFactory);
-  return mcpHttp.httpAddressToString(httpServer.address());
+  return await mcpHttp.installHttpTransport(httpServer, backendFactory, true);
 }
 class ServerBackendWithCloseListener {
   constructor(backend) {

package/lib/mcp/sdk/server.js

@@ -138,8 +138,7 @@ async function start(serverBackendFactory, options) {
     return;
   }
   const httpServer = await (0, import_http.startHttpServer)(options);
-  const url = (0, import_http.httpAddressToString)(httpServer.address());
-  await (0, import_http.installHttpTransport)(httpServer, serverBackendFactory, options.allowedHosts);
+  const url = await (0, import_http.installHttpTransport)(httpServer, serverBackendFactory, false, options.allowedHosts);
   const mcpConfig = { mcpServers: {} };
   mcpConfig.mcpServers[serverBackendFactory.nameInConfig] = {
     url: `${url}/mcp`

package/lib/mcp/test/testContext.js

@@ -65,6 +65,7 @@ class GeneratorJournal {
 \`\`\`ts
 ${step.code}
 \`\`\``).join("\n\n"));
+    result.push(bestPracticesMarkdown);
     return result.join("\n\n");
   }
 }
@@ -156,6 +157,18 @@ class TestContext {
   async close() {
   }
 }
+const bestPracticesMarkdown = `
+# Best practices
+- Do not improvise, do not add directives that were not asked for
+- Use clear, descriptive assertions to validate the expected behavior
+- Use reliable locators from this log
+- Use local variables for locators that are used multiple times
+- Use Playwright waiting assertions and best practices from this log
+- NEVER! use page.waitForLoadState()
+- NEVER! use page.waitForNavigation()
+- NEVER! use page.waitForTimeout()
+- NEVER! use page.evaluate()
+`;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   GeneratorJournal,

package/package.json

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