
Framework de automação de navegador com uma única API para Chromium, Firefox e WebKit. Suporta testes web, raspagem de dados, capturas de tela e interceptação de rede.
Playwright é um framework para automação e testes web. Ele controla Chromium, Firefox e WebKit com uma única API — nos seus testes, nos seus scripts e como ferramenta para agentes de IA.
Escolha o caminho que se adequa ao seu fluxo de trabalho:
| Ideal para | Instalação | |
|---|---|---|
| Playwright Test | Testes de ponta a ponta | npm init playwright@latest |
| Playwright CLI | Agentes de programação (Claude Code, Copilot) | npm i -g @playwright/cli@latest |
| Playwright MCP | Agentes de IA e automação orientada por LLM | npx @playwright/mcp@latest |
| Playwright Library | Scripts de automação de navegador | npm i playwright |
| Extensão do VS Code | Criação e depuração de testes no VS Code | Instalar a partir do Marketplace |
Playwright Test é um executor de testes completo, criado para testes de ponta a ponta. Ele executa testes em Chromium, Firefox e WebKit com isolamento total do navegador, espera automática e asserções web-first.
npm init playwright@latest
Ou adicione manualmente:
npm i -D @playwright/test
npx playwright install
import { test, expect } from '@playwright/test';
test('has title', async ({ page }) => {
await page.goto('https://playwright.dev/');
await expect(page).toHaveTitle(/Playwright/);
});
test('get started link', async ({ page }) => {
await page.goto('https://playwright.dev/');
await page.getByRole('link', { name: 'Get started' }).click();
await expect(page.getByRole('heading', { name: 'Installation' })).toBeVisible();
});
npx playwright test
Os testes são executados em paralelo em todos os navegadores configurados, em modo headless por padrão. Cada teste recebe um contexto de navegador novo — isolamento total com sobrecarga quase nula.
Espera automática e asserções web-first. Sem timeouts artificiais. O Playwright aguarda que os elementos estejam acionáveis, e as asserções são repetidas automaticamente até que as condições sejam atendidas.
Localizadores. Encontre elementos com localizadores resilientes que espelham a forma como os usuários veem a página:
page.getByRole('button', { name: 'Submit' })
page.getByLabel('Email')
page.getByPlaceholder('Search...')
page.getByTestId('login-form')
Isolamento de testes. Cada teste é executado em seu próprio contexto de navegador — equivalente a um perfil de navegador novo. Salve o estado de autenticação uma vez e reutilize-o entre os testes:
// Save state after login
await page.context().storageState({ path: 'auth.json' });
// Reuse in other tests
test.use({ storageState: 'auth.json' });
Rastreamento. Capture traces de execução, capturas de tela e vídeos em caso de falha. Inspecione cada ação, snapshot do DOM, requisição de rede e mensagem do console no Trace Viewer:
// playwright.config.ts
export default defineConfig({
use: {
trace: 'on-first-retry',
},
});
npx playwright show-trace trace.zip
Paralelismo. Os testes são executados em paralelo por padrão em todos os navegadores configurados.
Documentação completa de testes
Playwright CLI é uma interface de linha de comando para automação de navegador projetada para agentes de codificação. É mais eficiente em tokens do que o MCP — os comandos evitam carregar grandes esquemas de ferramentas e árvores de acessibilidade no contexto do modelo.
npm install -g @playwright/cli@latest
Opcionalmente, instale skills para uma integração mais rica com o agente:
playwright-cli install --skills
Aponte seu agente de codificação para uma tarefa:
Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli.
Take screenshots for all successful and failing scenarios.
Ou execute comandos diretamente:
playwright-cli open https://demo.playwright.dev/todomvc/ --headed
playwright-cli type "Buy groceries"
playwright-cli press Enter
playwright-cli screenshot
Use playwright-cli show para abrir um painel visual com pré-visualizações de screencast ao vivo de todas as sessões de navegador em execução. Clique em qualquer sessão para ampliar e assumir o controle remoto.
playwright-cli show
Documentação completa da CLI | GitHub
O servidor Playwright MCP oferece aos agentes de IA controle total do navegador por meio do Model Context Protocol. Os agentes interagem com as páginas usando snapshots de acessibilidade estruturados — sem necessidade de modelos de visão ou capturas de tela.
Adicione ao seu cliente MCP (VS Code, Cursor, Claude Desktop, Windsurf, etc.):
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
Instalação com um clique para VS Code:
Para Claude Code:
claude mcp add playwright npx @playwright/mcp@latest
Peça ao seu assistente de IA para interagir com qualquer página web:
Navigate to https://demo.playwright.dev/todomvc and add a few todo items.
O agente vê a página como uma árvore de acessibilidade estruturada:
- heading "todos" [level=1]
- textbox "What needs to be done?" [ref=e5]
- listitem:
- checkbox "Toggle Todo" [ref=e10]
- text: "Buy groceries"
Ele usa refs de elementos como e5 e e10 para clicar, digitar e interagir — de forma determinística e sem ambiguidade visual. As ferramentas abrangem navegação, preenchimento de formulários, capturas de tela, simulação de rede, gerenciamento de armazenamento e muito mais.
Documentação completa do MCP | GitHub