Referência da API Playwright

O Playwright oferece uma API moderna e assíncrona. Aqui estão os comandos fundamentais para sua automação no Mbbrowser.

1. Localização Inteligente (Locators)

O Playwright recomenda o uso de locadores que reflitam como o usuário vê a página.

// Localizar por texto visível
await page.getByText('Entrar').click();

// Localizar por papel (role)
await page.getByRole('button', { name: 'Enviar' }).click();

// Localizar por Placeholder (útil em formulários)
await page.getByPlaceholder('Seu e-mail').fill('user@exemplo.com');

2. Auto-Wait e Ações

Você não precisa verificar se o botão existe antes de clicar; o Playwright faz isso por você.

// Clicar
await page.locator('#submit-btn').click();

// Preencher campo (fill limpa o campo antes de digitar)
await page.locator('[name="username"]').fill('migratorybird');

// Marcar Checkbox
await page.locator('#terms-check').check();

3. Interceptação de Rede

Poderosa função para bloquear anúncios ou modificar respostas de APIs para testes.

// Bloquear todas as requisições de imagens para economizar tráfego do proxy
await page.route('**/*.{png,jpg,jpeg}', route => route.abort());

4. Gerenciamento de Cookies

Embora o Mbbrowser gerencie cookies automaticamente, você pode injetar ou extrair programaticamente.

// Obter todos os cookies da sessão atual
const cookies = await context.cookies();

// Injetar um cookie específico
await context.addCookies([{
  name: 'session_token',
  value: 'abc123xyz',
  domain: '.exemplo.com',
  path: '/'
}]);

5. Navegação e Esperas de Estado

// Navegar com tempo limite de 60 segundos
await page.goto('https://exemplo.com', { timeout: 60000 });

// Esperar até que a rede esteja ociosa (útil para sites pesados)
await page.waitForLoadState('networkidle');

---

IMPORTANT

Ao usar connectOverCDP, o Playwright assume o controle do Browser Context padrão do Mbbrowser. Isso significa que as configurações de fuso horário, geolocalização e impressões digitais aplicadas no painel do Mbbrowser serão respeitadas automaticamente pelo Playwright.