O que playwright-dev faz?
Explica como desenvolver o Playwright — adicionar APIs, ferramentas MCP, comandos CLI e dependências de terceiros.
Introdução
Esta skill orienta desenvolvedores sobre como contribuir com o Playwright, incluindo:
- Adicionar novas APIs ao núcleo do Playwright
- Criar ferramentas baseadas no Model Context Protocol (MCP)
- Implementar comandos de linha de comando (CLI)
- Gerenciar dependências de fornecedores (vendor dependencies)
Pré-requisitos
- Node.js 18 ou superior
- Git
- Conhecimento básico de TypeScript e automação de navegador
Adicionar uma nova API
- Identifique o local apropriado no código-fonte (
packages/playwright-core/src/). - Siga o padrão de nomenclatura e estrutura de classes existente.
- Adicione testes unitários e de integração.
- Documente a nova API no guia de referência.
Criar ferramentas MCP
Ferramentas MCP permitem que agentes de IA interajam com o Playwright. Para criar uma:
- Defina o schema da ferramenta em
packages/mcp/. - Implemente o handler correspondente.
- Teste a ferramenta com um cliente MCP.
Comandos CLI
Para adicionar um novo comando CLI, modifique o arquivo packages/cli/src/commands.ts e registre o comando no parser de argumentos.
Dependências de Fornecedores
Ao adicionar dependências de terceiros, use o diretório vendor/ e atualize o manifesto de dependências (package.json) conforme necessário.
Testes
Execute npx playwright test para validar alterações.
Para mais detalhes, consulte a documentação oficial do Playwright.