Disponibilidade de material de apoio

Esta cópia do catálogo contém as orientações embutidas abaixo, mas não inclui os seguintes caminhos de suporte. São pré-requisitos externos, não arquivos agrupados:

• <support-root>/references/config.md
• <support-root>/references/page-objects.md
• <support-root>/references/assertions.md
• <support-root>/references/fixtures.md
• <support-root>/templates/BaseTest.java
• <support-root>/templates/BasePage.java
• src/test/resources/junit-platform.properties

Solicite o material de apoio original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças aplicáveis e pré-requisitos de execução. Não execute um comando ou afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Playwright Java – Automação de Testes Avançada

Visão Geral

Esta habilidade produz código de teste Playwright Java de qualidade de produção e nível empresarial. Ela impõe o Modelo de Objeto de Página (POM), estratégias de localizador rigorosas, execução paralela segura para threads e integração completa de relatórios Allure. Destina-se a Java 17+ e Playwright 1.44+.

Arquivos de referência de suporte estão disponíveis para tópicos mais aprofundados:

Quando Usar Esta Habilidade

• Use ao criar um novo projeto Playwright Java do zero
• Use ao escrever classes de Objeto de Página ou classes de teste JUnit 5
• Use quando o usuário perguntar sobre testes entre navegadores, execução paralela ou relatórios Allure
• Use ao corrigir testes instáveis ou substituir Thread.sleep() por esperas adequadas
• Use ao configurar o Playwright em pipelines CI/CD (GitHub Actions, Jenkins, Docker)
• Use ao combinar chamadas de API e asserções de UI em um único teste (testes híbridos)
• Use quando o usuário mencionar "padrão POM", "BrowserContext", "Playwright fixtures" ou "traces"

Como Funciona

Etapa 1: Decida a Abordagem

Use esta matriz para escolher o padrão correto antes de escrever qualquer código:

Etapa 2: Crie a Estrutura do Projeto

Sempre use este layout ao criar um novo projeto:

src/
├── test/
│   ├── java/com/company/tests/
│   │   ├── base/
│   │   │   ├── BaseTest.java        ← templates/BaseTest.java
│   │   │   └── BasePage.java        ← templates/BasePage.java
│   │   ├── pages/
│   │   │   └── LoginPage.java
│   │   ├── tests/
│   │   │   └── LoginTest.java
│   │   ├── utils/
│   │   │   ├── TestDataFactory.java
│   │   │   └── WaitUtils.java
│   │   └── config/
│   │       └── ConfigReader.java
│   └── resources/
│       ├── test.properties
│       ├── junit-platform.properties
│       └── testdata/users.json
pom.xml

Etapa 3: Configure o BaseTest Seguro para Threads

public class BaseTest {
    protected static ThreadLocal<Playwright>     playwrightTL = new ThreadLocal<>();
    protected static ThreadLocal<Browser>        browserTL    = new ThreadLocal<>();
    protected static ThreadLocal<BrowserContext> contextTL    = new ThreadLocal<>();
    protected static ThreadLocal<Page>           pageTL       = new ThreadLocal<>();

    protected Page page() { return pageTL.get(); }

    @BeforeEach
    void setUp() {
        Playwright playwright = Playwright.create();

…