Playwright 1.59: agentové testování API — průvodce

# Playwright 1.59: agentové testování se stává standardem — rozbor klíčových API

Vydání Playwright 1.59 fixuje přechod od manuálního nastavování testů k agentním workflowům. Nové nástroje pro vizualizaci, sdílený přístup k relacím a integraci CLI odstraňují mezeru mezi generováním testů AI a jejich praktickým použitím. Probereme, jak mohou techničtí lídové implementovat tyto funkce již do současných pipelineů.

Screencast API: od screenshotů k vizuálním důkazům

Nové page.screencast API nahrazuje fragmentární screenshoty při selhání testů celistvými video potvrzeními. Klíčový rozdíl — vestavěná anotace akcí a kapitoly pro strukturování dlouhých scénářů. Není to jen nahrávka obrazovky, ale kontextualizovaný report o provedení.

Příklad použití pro kritický E2E flow:

await page.screencast.start({ path: 'checkout.webm' });
await page.screencast.showActions({ position: 'top-right' });
await page.locator('#add-to-cart').click();
await page.locator('#checkout').click();
await expect(page.locator('.order-confirmation')).toBeVisible();
await page.screencast.stop();

Při integraci s AI vizí kolbék onFrame umožňuje předávat snímky do vision modelů:

await page.screencast.start({
  onFrame: ({ data }) => sendToVisionModel(data),
  size: { width: 800, height: 600 },
});

To řeší úkol vizuální validace bez pixelových porovnání. Pro CI se doporučuje přidávat kapitoly s popisem fází:

await page.screencast.showChapter('Authentication', {
  description: 'Test login process',
  duration: 1000,
});
// kroky přihlášení
await page.screencast.showChapter('Payment', {
  description: 'Credit card validation',
});

Video s kapitolami zrychluje analýzu selhání 3–4krát ve srovnání s textovými logy.

Browser Bind API: synchronizace mezi nástroji

Funkce browser.bind() vytváří WebSocket spojení pro sdílený přístup k jedné prohlížečové relaci. To eliminuje duplikování autentizace při přepínání mezi manuálním testováním a automatizací.

Základní scénář:

const { endpoint } = await browser.bind('auth-session', {
  workspaceDir: '/project',
});

Připojení z CLI:

playwright-cli attach auth-session
playwright-cli -s auth-session snapshot

Praktická použití:

• Debug AI agentů v reálném čase bez zastavení procesu
• Sdílení autorizovaných relací mezi QA a vývojáři
• Integrace s MCP servery pro hybridní workflowy (např. agent generuje test, tým provádí úpravy)

Kritické pro týmy používající self-healing testy: agent může opravit scénář kontrolou změn přes připojenou relaci.

Dashboard a CLI nástroje: debug bez GUI

Příkaz playwright-cli show spouští dashboard s live monitorováním všech připojených relací. Pro agentní workflowy byly přidány dva klíčové režimy:

• CLI Debugger (--debug=cli): krok za krokem debug přes terminál

```

npx playwright test --debug=cli

playwright-cli --session tw-87b59e step-over

```

Umožňuje agentům analyzovat selhání bez GUI, inspektováním DOM na každém kroku.

• Trace Analysis (npx playwright trace): programový parsování traceů

- Extrakce síťových požadavků a časování

- Automatická generace bug reportů s uvedením momentu selhání

- Integrace se systémy analýzy (např. Grafana)

Tyto nástroje jsou kritické pro headless prostředí CI, kde tradiční metody debugu nejsou dostupné.

Co je důležité: klíčové závěry pro technické lídry

• Vizuální potvrzení nahrazují logy: 30sekundové video s anotacemi akcí zvyšuje rychlost diagnostiky 4krát
• Sdílené relace šetří čas: eliminace opakované autentizace snižuje overhead o 15–20 % v testovacích pipelinech
• CLI-first přístup: integrace s terminálem činí agentní workflowy životaschopnými v produkčních prostředích
• Přímé propojení s AI: předávání snímků do vision modelů a automatická generace oprav přes healer agenty
• Průhlednost pro stakeholdery: video reporty nahrazují technické detaily srozumitelnými důkazy

Jak implementovat do stávajících procesů

Startovní strategie pro týmy:

• Začněte se Screencast API pro kritické scénáře (objednávka, platba). Přidejte kapitoly pro klíčové fáze — to dá okamžitý efekt v diagnostice.

• Nastavte Browser Bind pro sdílené relace:

```

# V setup skriptu

await browser.bind('auth-state', { storageState: 'state.json' });

```

Připojujte se z terminálu pro manuální kontrolu bez opakovaného přihlášení.

• Aktivujte dashboard přes PLAYWRIGHT_DASHBOARD=1 v CI. To dá vizuální kontrolu nad paralelními spuštěními.

• Integrujte CLI Debugger do pipeline self-healing:

```

# V skriptu healer agenta

if (testFailed) {

await runCLI(playwright-cli attach ${session} fix);

}

```

Aktualizace na 1.59 vyžaduje minimální změny v kódu, ale mění paradigmu testování: QA inženýr přestává být „psačem testů“ a stává se verifikátorem agentních řešení. První výsledky se objeví do týdne po implementaci Screencast API — tým ocení zkrácení času na analýzu selhání.

— Editorial Team