Playwright
O assistente no navegador
Imagine um assistente sentado no seu lugar, na frente do navegador. Ele abre a página, clica no botão, preenche o formulário e lê o que apareceu na tela. Ele não se cansa. Amanhã ele repete o mesmo roteiro. Se o botão sumiu ou o texto mudou, ele avisa: o teste falhou.
O Playwright é esse assistente. É uma ferramenta da Microsoft para teste de sistema: ela dirige o navegador de verdade e percorre a interface como um usuário, de ponta a ponta. Assim como o Selenium, o objetivo é conferir o que a pessoa vê, não só o JSON da API.
Em outras palavras: o Rest Assured pede o prato na cozinha. O Playwright senta na mesa e come com os olhos. Os dois se complementam. Um confere a API. O outro confere o botão, o campo e a mensagem de sucesso.
Esta aula usa o cadastro de livros do projeto hexagonal, em exemplos/hexagonal/frontend. A interface é uma aplicação Vue servida pelo Quarkus em http://localhost:8080. Por ela você cadastra, edita, exclui e lista livros. Os testes Java moram ao lado dos demais testes do módulo, em src/test/java/dev/ifrs/hexagonal/.
Resumo rápido: se você consegue descrever o teste em voz alta como “abra a home, clique em Novo livro, preencha, salve, então a linha deve aparecer”, você já entendeu o Playwright.
Por que usar o Playwright?
- Vários navegadores, uma API. Chromium (Chrome e Edge), Firefox e WebKit (Safari) entendem as mesmas chamadas.
- Espera automática. O assistente só clica quando o botão já está visível e habilitado. Você quase nunca precisa de
Thread.sleep. - Codegen. Um escriba observa o que você faz na tela e gera o Java.
- Vídeo e rastreio. Quando o teste falha, você assiste o filme da falha.
- Java com JUnit. Roda no mesmo
./mvnw testdos outros testes do módulo.
O que você precisa ter pronto
- Java 25, já fixado em
maven.compiler.releasenopom.xmldo hexagonal. - Maven 3.9 ou superior. O módulo traz
./mvnw, então não é obrigatório instalar o Maven na máquina. - Docker em execução. A anotação
@QuarkusTestsobe o Quarkus e o MySQL Dev Services sozinha. Para rodar os testes, você não precisa iniciar./mvnw quarkus:dev. Esse comando só entra na cena quando formos gravar com o Codegen.
O pom.xml do módulo já traz Playwright Java, Quarkus JUnit, Rest Assured e o plugin que chama o CLI. Você não adiciona dependência nenhuma para começar.
Na primeira vez em cada máquina, baixe os binários dos navegadores, na raiz do módulo hexagonal:
cd exemplos/hexagonal
./mvnw exec:java -e \
-D exec.mainClass=com.microsoft.playwright.CLI \
-D exec.args="install"
A gaveta limpa: anatomia
O assistente é montado em quatro peças, sempre nesta ordem. Vale gravar essa lista de cor.
| Peça | Analogia | O que faz |
|---|---|---|
Playwright | o motor | Liga o processo interno da ferramenta |
Browser | o navegador | Chromium, Firefox ou WebKit |
BrowserContext | a gaveta limpa | Cookies, armazenamento e sessão só daquele teste |
Page | a aba | Onde o assistente clica, digita e lê |
A gaveta limpa é a ideia que mais evita surpresa. Cada teste ganha um BrowserContext novo. O login, o cookie e o armazenamento do teste anterior não vazam para o próximo. É como esvaziar a gaveta antes de guardar outra coisa.
Tem um detalhe importante: a gaveta da sessão é limpa. O banco MySQL não é. Os testes de uma mesma classe compartilham o banco. Por isso, mais adiante, vamos apagar o ISBN de teste pela API antes de cada caso.
Espera automática
O assistente não aperta o botão enquanto o botão não está pronto. click() espera o elemento visível e habilitado. assertThat(...).isVisible() espera o texto aparecer. Essa espera é o oposto de Thread.sleep: em vez de adivinhar um tempo, o Playwright observa a tela.
Resumo rápido: se o teste “às vezes passa, às vezes falha”, desconfie de
Thread.sleep. A espera automática costuma ser a resposta.
O escriba: gravando o primeiro teste
A forma mais rápida de começar é gravar a interação, sem escrever código. O Codegen abre o navegador, observa o que você faz e gera o Java. Só depois de gravar é que vamos ler o código com calma.
Preparando a gravação
O Codegen precisa de uma aplicação no ar. O @QuarkusTest só sobe o backend durante os testes. Para esta sessão de gravação, suba o Quarkus na mão:
cd exemplos/hexagonal
./mvnw quarkus:dev
Com a aplicação em http://localhost:8080, abra o Codegen com saída em Java. Use outro terminal, na raiz do módulo hexagonal:
cd exemplos/hexagonal
./mvnw exec:java -e \
-D exec.mainClass=com.microsoft.playwright.CLI \
-D exec.args="codegen --target java http://localhost:8080"
Duas janelas aparecem lado a lado:
- O navegador, onde você interage normalmente (clica, digita, navega).
- O Playwright Inspector, o painel do escriba, que exibe o código Java em tempo real.

Figura 1. Codegen: navegador (esquerda) e Inspector (direita)
O que gravar
Vamos registrar o cadastro de um livro. No navegador, siga estes passos enquanto o Inspector gera o código:
- Clique em Novo livro.
- Preencha o ISBN com
156881111X. - Preencha o título com
Erdős on Graphs: His Legacy of Unsolved Problems. - Preencha o autor com
Fan Chung, Ronald L. Graham. - Preencha o ano com
1999. - Clique em Salvar.
- Verifique que a linha com o ISBN aparece na tabela. Use o botão de assertiva do Inspector, descrito logo abaixo.
Cada clique e cada texto digitado vira uma linha de Java no Inspector.
O fluxo da gravação
- Inicie. Assim que o Codegen abre, ele já está gravando (ícone vermelho ativo no Inspector).
- Interaja. Clique em botões, preencha formulários e navegue. Cada ação vira uma linha.
- Adicione assertivas. Use os botões da barra do Inspector.
- Pause se precisar. Clique no botão vermelho para pausar ou retomar.
- Copie. Clique em Copy no Inspector. Guarde o resultado. Vamos ler o código na próxima seção.
Assertivas durante a gravação
O Inspector tem três botões para criar assertivas sem escrever código:
| Botão | Método gerado | O que verifica |
|---|---|---|
| Assert visibility | assertThat(locator).isVisible() | O elemento está visível na tela |
| Assert text | assertThat(locator).hasText(...) | O elemento contém o texto esperado |
| Assert value | assertThat(locator).hasValue(...) | Um campo de formulário tem o valor esperado |
Como usar: clique no botão da assertiva desejada e, em seguida, clique sobre o elemento na página. A linha entra sozinha no código.
Para o cadastro de livros, use Assert visibility sobre a linha da tabela que contém o ISBN 156881111X.
Opções úteis da linha de comando
| Opção | Exemplo | Descrição |
|---|---|---|
--browser | --browser firefox | Navegador alvo (chromium, firefox, webkit) |
--output | --output src/test/java/CadastroLivroGravado.java | Salva direto em arquivo |
--target | --target java | Linguagem de saída |
--device | --device "iPhone 13" | Emula um aparelho móvel |
--lang | --lang "pt-BR" | Idioma do navegador |
Para salvar a gravação direto no projeto:
cd exemplos/hexagonal
./mvnw exec:java -e \
-D exec.mainClass=com.microsoft.playwright.CLI \
-D exec.args="codegen --target java --output src/test/java/dev/ifrs/hexagonal/CadastroLivroGravado.java http://localhost:8080"
Entendendo o código gerado
Depois de gravar, o Inspector exibe um arquivo Java completo. Antes de evoluir para testes mais complexos, vale entender o que cada parte faz.
O trecho abaixo corresponde ao fluxo gravado: cadastro de um livro e verificação na tabela.
import com.microsoft.playwright.*;
import com.microsoft.playwright.options.*;
import static com.microsoft.playwright.options.AriaRole.*;
import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;
public class CadastroLivroGravado {
public static void main(String[] args) {
try (Playwright playwright = Playwright.create()) {
Browser browser = playwright.chromium().launch(
new BrowserType.LaunchOptions().setHeadless(false)
);
BrowserContext context = browser.newContext();
Page page = context.newPage();
page.navigate("http://localhost:8080");
page.getByRole(BUTTON, new Page.GetByRoleOptions().setName("Novo livro")).click();
page.getByRole(TEXTBOX, new Page.GetByRoleOptions().setName("ISBN-")).fill("156881111X");
page.getByRole(TEXTBOX, new Page.GetByRoleOptions().setName("Título")).fill(
"Erdős on Graphs: His Legacy of Unsolved Problems"
);
page.getByRole(TEXTBOX, new Page.GetByRoleOptions().setName("Autor")).fill(
"Fan Chung, Ronald L. Graham"
);
page.getByRole(SPINBUTTON, new Page.GetByRoleOptions().setName("Ano de publicação"))
.fill("1999");
page.getByRole(BUTTON, new Page.GetByRoleOptions().setName("Salvar")).click();
assertThat(
page.getByRole(ROW).filter(
new Locator.FilterOptions().setHasText("156881111X"))
).isVisible();
}
}
}
Leia como uma frase: “Abra a home, clique em Novo livro, preencha ISBN, título, autor e ano, clique em Salvar, então a linha com esse ISBN deve estar visível.”
| Trecho | O que faz |
|---|---|
Playwright.create() | Liga o motor |
playwright.chromium().launch(...) | Abre o Chromium (visível com setHeadless(false)) |
browser.newContext() | Abre a gaveta limpa |
context.newPage() | Abre a aba |
page.navigate(url) | Vai até a URL |
page.getByRole(...).click() | Acha o elemento pelo papel ARIA e clica |
page.getByRole(...).fill(...) | Acha o campo e preenche |
assertThat(...).isVisible() | Confere visibilidade, com espera automática |
try (Playwright playwright = ...) | Garante que tudo seja fechado no fim |
O try with resources é o que desliga o motor no final. Sem ele, o processo do Playwright pode ficar órfão na máquina.
Seletores que falam a língua da tela
O Codegen prioriza seletores semânticos: o que o usuário enxerga, não o CSS escondido no HTML. Isso deixa o teste mais firme quando o layout muda de cor ou de classe, mas o botão continua se chamando Salvar.
| Ordem | Método | Exemplo em Java |
|---|---|---|
| 1ª | getByRole() | page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Salvar")) |
| 2ª | getByText() | page.getByText("Nenhum livro cadastrado") |
| 3ª | getByLabel() | page.getByLabel("Título") |
| 4ª | getByPlaceholder() | page.getByPlaceholder("Ex.: 1-56881-111-X") |
| 5ª | getByTestId() | page.getByTestId("btn-salvar") |
| Último recurso | locator() (CSS) | page.locator("#isbn") |
No cadastro de livros, o Codegen escolheu getByRole para botões, campos de texto e linhas da tabela porque a interface Vue expõe papéis ARIA nesses elementos. Comece sempre por getByRole. Só desça até o CSS se o resto não alcançar o elemento.
Resumo rápido: se o teste quebra porque alguém mudou uma classe CSS, o seletor era frágil. Se quebra porque o botão Salvar mudou de nome, o seletor estava falando a língua da tela, e a mudança era real.
Do main para o JUnit
O Codegen gera um main() executável. Para a disciplina, queremos o teste dentro do Maven, com relatório JUnit XML, e com o Quarkus subindo sozinho. Duas anotações substituem a abertura e o fechamento manuais:
@QuarkusTest(deio.quarkus.test.junit) sobe o Quarkus e o MySQL Dev Services antes de qualquer teste, na porta configurada porquarkus.http.test-port=8080.@UsePlaywright(decom.microsoft.playwright.junit) gerenciaPlaywright,BrowsereBrowserContext, e injeta umPagenovo a cada método@Test. Cada teste recebe a gaveta limpa.
A classe de teste fica reduzida ao essencial:
package dev.ifrs.hexagonal;
import com.microsoft.playwright.Locator;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.junit.UsePlaywright;
import com.microsoft.playwright.options.AriaRole;
import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;
import io.quarkus.test.junit.QuarkusTest;
import org.junit.jupiter.api.Test;
@QuarkusTest
@UsePlaywright
public class BooksE2ETest {
@Test
void cadastraLivro(Page page) {
page.navigate("http://localhost:8080/");
page.getByRole(AriaRole.BUTTON,
new Page.GetByRoleOptions().setName("Novo livro")).click();
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("ISBN-")).fill("156881111X");
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("Título")).fill(
"Erdős on Graphs: His Legacy of Unsolved Problems");
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("Autor")).fill(
"Fan Chung, Ronald L. Graham");
page.getByRole(AriaRole.SPINBUTTON,
new Page.GetByRoleOptions().setName("Ano de publicação")).fill("1999");
page.getByRole(AriaRole.BUTTON,
new Page.GetByRoleOptions().setName("Salvar")).click();
assertThat(
page.getByRole(AriaRole.ROW).filter(
new Locator.FilterOptions().setHasText("156881111X"))
).isVisible();
}
}
| Elemento | Função |
|---|---|
@QuarkusTest | Sobe o Quarkus e o MySQL em http://localhost:8080 |
@UsePlaywright | Liga o assistente, abre o Chromium (invisível) e cria a gaveta por método |
Page page no @Test | A aba chega injetada. Você só usa. |
@Test | O JUnit 5 reconhece o método como caso de teste |
Se quiser acompanhar com os olhos (modo visível, útil para depurar na sua máquina), forneça uma OptionsFactory em @UsePlaywright:
import com.microsoft.playwright.junit.Options;
import com.microsoft.playwright.junit.OptionsFactory;
@QuarkusTest
@UsePlaywright(BooksE2ETest.HeadedOptions.class)
public class BooksE2ETest {
public static class HeadedOptions implements OptionsFactory {
@Override
public Options getOptions() {
return new Options().setHeadless(false);
}
}
// ... métodos @Test ...
}
setHeadless(false) deixa a janela visível. O padrão, sem essa fábrica, é o modo invisível, mais rápido e adequado à integração contínua.
Execute com ./mvnw test na raiz do módulo hexagonal. O relatório XML aparece em target/surefire-reports/.
Integração com Maven
O Maven Surefire gera relatórios no formato XML do JUnit depois de mvn test. Esses arquivos são o padrão que Jenkins, GitHub Actions e GitLab CI sabem importar.
A classe BooksE2ETest entra no ciclo test padrão. O @QuarkusTest sobe o Quarkus e o MySQL sozinho:
cd exemplos/hexagonal
./mvnw test -Dtest=BooksE2ETest
Cada classe gera dois arquivos em target/surefire-reports/:
target/surefire-reports/
├── BooksE2ETest.txt
└── TEST-BooksE2ETest.xml
O XML segue o esquema do JUnit:
<?xml version="1.0" encoding="UTF-8"?>
<testsuite name="BooksE2ETest" tests="3" failures="0" errors="0" skipped="0" time="8.42">
<testcase name="cadastraLivro" classname="dev.ifrs.hexagonal.BooksE2ETest" time="3.15"/>
<testcase name="editaLivro" classname="dev.ifrs.hexagonal.BooksE2ETest" time="2.80"/>
<testcase name="excluiLivro" classname="dev.ifrs.hexagonal.BooksE2ETest" time="2.47"/>
</testsuite>
O projeto hexagonal também tem um perfil e2e no pom.xml. Atenção: esse perfil executa os testes Playwright em JavaScript que vivem em frontend/e2e/books.spec.js. Ele não roda os testes Java desta aula.
cd exemplos/hexagonal
./mvnw test # roda TODOS os testes Java
./mvnw verify -Pe2e # testes Java e Playwright em JavaScript do frontend
Para executar só os testes de ponta a ponta em Java:
./mvnw test -Dtest='Books*E2ETest,BooksMultiBrowserTest,PlayrightTest'
Vários navegadores ao mesmo tempo
O Playwright Java fala com Chromium, Firefox e WebKit com a mesma API. Usando @ParameterizedTest do JUnit 5, o mesmo cenário roda nos três. Com @Execution(ExecutionMode.CONCURRENT), os três andam juntos e o tempo total cai.
Por que cada invocação cria o seu Playwright
A classe Playwright não pode ser compartilhada entre threads. Ela guarda processo e estado internos que falham quando duas threads chamam ao mesmo tempo. A abordagem antiga (um Playwright estático em @BeforeAll) impede o uso de CONCURRENT.
A solução é simples: cada invocação do teste parametrizado cria e fecha o seu próprio Playwright num try with resources. Como cada invocação roda na sua thread, não há estado compartilhado, e o paralelismo funciona com @QuarkusTest.
ISBNs diferentes por navegador evitam briga no banco compartilhado. Chromium, Firefox e WebKit gravam livros distintos.
A classe PlayrightTest combina dois estilos. O método test usa a Page injetada por @UsePlaywright (Chromium com slowMo e vídeo). O método cadastraLivroEmCadaNavegador cria o próprio Playwright por invocação e roda em paralelo:
package dev.ifrs.hexagonal;
import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;
import com.microsoft.playwright.Browser;
import com.microsoft.playwright.BrowserContext;
import com.microsoft.playwright.BrowserType;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;
import com.microsoft.playwright.junit.Options;
import com.microsoft.playwright.junit.OptionsFactory;
import com.microsoft.playwright.junit.UsePlaywright;
import com.microsoft.playwright.options.AriaRole;
import io.quarkus.test.junit.QuarkusTest;
import java.nio.file.Paths;
import java.util.stream.Stream;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.parallel.Execution;
import org.junit.jupiter.api.parallel.ExecutionMode;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.MethodSource;
@QuarkusTest
@UsePlaywright(PlayrightTest.WithVideo.class)
public class PlayrightTest {
static Stream<String> navegadores() {
return Stream.of("chromium", "firefox", "webkit");
}
@Test
void test(Page page) {
page.navigate("http://localhost:8080/");
page.getByRole(AriaRole.BUTTON,
new Page.GetByRoleOptions().setName("Novo livro")).click();
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("ISBN-")).fill("6587958494");
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("Título")).fill("Estatistica Basica");
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("Autor")).fill("Rodrigo");
page.getByRole(AriaRole.BUTTON,
new Page.GetByRoleOptions().setName("Salvar")).click();
assertThat(page.locator("tbody")).containsText("6587958494");
}
@ParameterizedTest(name = "cadastraLivro [{0}]")
@MethodSource("navegadores")
@Execution(ExecutionMode.CONCURRENT)
void cadastraLivroEmCadaNavegador(String nomeNavegador) {
String isbn = switch (nomeNavegador) {
case "firefox" -> "0201634554";
case "webkit" -> "0596007124";
default -> "0306406152";
};
try (Playwright pw = Playwright.create()) {
BrowserType tipo = switch (nomeNavegador) {
case "firefox" -> pw.firefox();
case "webkit" -> pw.webkit();
default -> pw.chromium();
};
try (Browser browser = tipo.launch(
new BrowserType.LaunchOptions().setSlowMo(300));
BrowserContext context = browser.newContext(
new Browser.NewContextOptions()
.setRecordVideoDir(
Paths.get("target/videos/" + nomeNavegador)))) {
Page page = context.newPage();
page.navigate("http://localhost:8080/");
page.getByRole(AriaRole.BUTTON,
new Page.GetByRoleOptions().setName("Novo livro")).click();
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("ISBN-")).fill(isbn);
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("Título")).fill("Estatistica Basica");
page.getByRole(AriaRole.TEXTBOX,
new Page.GetByRoleOptions().setName("Autor")).fill("Rodrigo");
page.getByRole(AriaRole.BUTTON,
new Page.GetByRoleOptions().setName("Salvar")).click();
assertThat(page.locator("tbody")).containsText(isbn);
}
}
}
public static class WithVideo implements OptionsFactory {
@Override
public Options getOptions() {
return new Options()
.setLaunchOptions(new BrowserType.LaunchOptions().setSlowMo(300))
.setContextOptions(new Browser.NewContextOptions()
.setRecordVideoDir(Paths.get("target/videos/chromium")));
}
}
}
| Elemento | Por que é assim |
|---|---|
try (Playwright pw = Playwright.create()) dentro do método | Playwright não pode ser compartilhado entre threads |
@Execution(ExecutionMode.CONCURRENT) | O JUnit 5 roda as três invocações em paralelo |
| ISBN diferente por navegador | O banco é compartilhado. ISBNs distintos evitam conflito de chave |
setSlowMo(300) | Desacelera cada ação em 300 ms para o vídeo ficar legível |
setRecordVideoDir("target/videos/" + nomeNavegador) | Cada navegador grava no seu subdiretório |
O arquivo src/test/resources/junit-platform.properties liga o motor paralelo:
junit.jupiter.execution.parallel.enabled=true
junit.jupiter.execution.parallel.mode.default=same_thread
junit.jupiter.execution.parallel.config.strategy=fixed
junit.jupiter.execution.parallel.config.fixed.parallelism=3
| Propriedade | Valor | Efeito |
|---|---|---|
parallel.enabled | true | Liga o motor paralelo do JUnit |
mode.default | same_thread | Testes sem anotação ficam na thread corrente (seguro para @QuarkusTest) |
config.strategy | fixed | Número fixo de threads |
config.fixed.parallelism | 3 | Uma thread por navegador no teste parametrizado |
Antes da primeira execução, instale Firefox e WebKit se ainda não tiver feito: ./mvnw exec:java -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install firefox webkit".
Gravação de vídeo
A gravação de vídeo ajuda a investigar falhas que não se reproduzem com facilidade na mão. O Playwright salva um arquivo .webm por contexto, no diretório informado.
Quando o BrowserContext é gerenciado por @UsePlaywright, a configuração de vídeo vai numa OptionsFactory. Criar a classe não basta. Quem liga a fábrica ao teste é o argumento de @UsePlaywright: o nome da classe de teste, um ponto, e o nome da fábrica.
@QuarkusTest
@UsePlaywright(VideoLivroTest.ComVideo.class)
public class VideoLivroTest {
public static class ComVideo implements OptionsFactory {
@Override
public Options getOptions() {
return new Options()
.setLaunchOptions(new BrowserType.LaunchOptions().setSlowMo(300))
.setContextOptions(new Browser.NewContextOptions()
.setRecordVideoDir(Paths.get("target/videos/chromium")));
}
}
@Test
void cadastraLivro(Page page) {
page.navigate("http://localhost:8080/");
// o Page injetado já grava, porque a fábrica foi passada na anotação
}
}
ComVideo descreve o filme. @UsePlaywright(VideoLivroTest.ComVideo.class) manda o JUnit usar essa descrição em cada @Test. Sem o argumento, @UsePlaywright sozinho abre o Chromium invisível e não grava nada.
| Opção | Método | Efeito |
|---|---|---|
slowMo(300) | setLaunchOptions | Coloca 300 ms entre cada ação |
setRecordVideoDir(...) | setContextOptions | Diretório onde o .webm será gravado |
O ponto que mais pega: o arquivo .webm só é escrito depois que o contexto fecha. A integração JUnit faz isso ao terminar cada @Test. Se você abrir a pasta no meio do teste, o filme ainda não está lá.
No teste parametrizado, Browser e BrowserContext são criados na mão, num try with resources aninhado. Cada navegador grava no seu subdiretório. O contexto precisa fechar antes do browser para o arquivo terminar certo no disco.
Depois de PlayrightTest, a pasta fica assim:
target/videos/
├── chromium/
│ ├── a3f9b2c1d4e5f6a7.webm
│ └── b1c2d3e4f5a6b7c8.webm
├── firefox/
│ └── c4d5e6f7a8b9c0d1.webm
└── webkit/
└── d7e8f9a0b1c2d3e4.webm
O nome do arquivo é gerado pela ferramenta. Para associar um vídeo a um teste específico, use page.video().path() logo antes de fechar o contexto.
Exercícios de fixação
Agora é a sua vez na livraria. O objetivo desta seção é ganhar confiança no cadastro de livros: os dois primeiros exercícios são curtos de propósito. Você escreve os testes. O enunciado não entrega a solução pronta.
Trabalhe no módulo exemplos/hexagonal. Crie uma classe nova chamada LivrosFixacaoTest em src/test/java/dev/ifrs/hexagonal/. Não copie BooksE2ETest. A ideia é montar a classe com as próprias mãos.
Preparação
Na classe:
- Anote com
@QuarkusTeste@UsePlaywright. - Use o ISBN
0134685991em todos os cenários desta seção (é um ISBN válido e diferente do exemplo da aula). - No
@BeforeEach, apague esse ISBN comgiven().delete("/books/{isbn}", "0134685991");para os testes não dependerem da ordem.
Rode só a sua classe:
cd exemplos/hexagonal
./mvnw test -Dtest=LivrosFixacaoTest
Dicas que valem para todos os exercícios:
- O
Pagechega como parâmetro do@Test. - Prefira
getByRolepara achar botão, campo e linha. assertThat(locator).isVisible()espera o elemento aparecer.- Para diálogo, registre
page.onDialog(...)antes do clique.
Exercício 1: o botão está lá
Revise a anatomia e a espera automática. Escreva um teste que:
- Navegue até
http://localhost:8080/. - Confira que o botão Novo livro está visível.
Se esse teste passar, o assistente já está ligado, a aplicação subiu e você achou o primeiro elemento pela língua da tela.
Exercício 2: o formulário abre
Revise getByRole e click. A partir da home:
- Clique em Novo livro.
- Confira que os campos ISBN, Título, Autor e Ano de publicação estão visíveis.
O rótulo do ISBN na tela é ISBN-10. O Codegen costuma achar esse campo com getByRole e o nome começando em ISBN-.
Exercício 3: o fluxo feliz
Revise fill, getByRole e assertThat. Cadastre um livro com o ISBN 0134685991 (escolha título, autor e ano). Depois de Salvar, valide:
- A linha da tabela que contém esse ISBN está visível.
- O elemento com
role=statustem o textoLivro criado com sucesso.
Exercício 4: ISBN travado
Revise POST /books e isDisabled. Crie o livro com POST /books (status 201). Abra a home, clique em Editar na linha desse ISBN e confira que o campo ISBN está desabilitado.
Dica: assertThat(locator).isDisabled() espera o campo ficar travado. O ISBN não pode mudar depois do cadastro. É exatamente isso que a tela promete no texto de ajuda do formulário.
Exercício 5: recusar a exclusão
Revise onDialog. Com o livro já existente (condição prévia via REST):
- Registre
page.onDialog(dialog -> dialog.dismiss());antes de clicar. - Clique em Excluir na linha do ISBN.
- Confira que a linha permanece visível.
Recusar o diálogo é o caminho que a aula mostrou menos. Se este teste passar, você entendeu a ordem: escutar primeiro, clicar depois.
Exercício 6: desafio
Revise exclusão, mensagem de sucesso e not().isVisible(). Com o livro já existente:
- Aceite o diálogo com
dialog.accept(). - Confira que a linha do ISBN não está mais visível.
- Confira que o
role=statusdizLivro removido com sucesso.
Se os exercícios 1 a 6 passam, você percorreu a tela de ponta a ponta: abriu, preencheu, editou, recusou e confirmou. Esse é o assistente no navegador, no seu ritmo.
Exercício 7: gravar o filme
Revise a seção Gravação de vídeo. O exemplo cria a fábrica e, na linha de cima, passa essa fábrica para @UsePlaywright. Faça o mesmo numa classe sua, por exemplo VideoLivroTest.
- Crie uma
OptionsFactoryque grave emtarget/videos/exercicioe usesetSlowMo(300). - Anote a classe com
@UsePlaywright(VideoLivroTest.SuaFabrica.class), trocandoSuaFabricapelo nome que você escolheu. - Escreva um
@Testque cadastre o livro de ISBN0134685991pela tela. - Rode
./mvnw test -Dtest=VideoLivroTest. - Só depois que o teste terminar, abra o
.webmdessa pasta e confira que dá para ver o clique em Novo livro e o Salvar.
Se a pasta continuar vazia, a fábrica foi criada e não foi passada na anotação, ou você abriu o diretório antes de o contexto fechar.
Exercício 8: três navegadores ao mesmo tempo
Revise a seção Vários navegadores ao mesmo tempo. Crie a classe LivrosNavegadoresTest, separada da LivrosFixacaoTest. Um único cenário de cadastro deve rodar em Chromium, Firefox e WebKit ao mesmo tempo.
- Use
@ParameterizedTestcom uma fonte que devolva"chromium","firefox"e"webkit". - Marque o método com
@Execution(ExecutionMode.CONCURRENT). - Dentro do método, crie e feche um
Playwrightpróprio, numtrywith resources. Não reutilize oPageinjetado por@UsePlaywright. - Cada navegador cadastra um ISBN diferente. Não reuse
0134685991. - Confirme que a linha daquele ISBN aparece na tabela.
- Confira em
src/test/resources/junit-platform.propertiesque o paralelismo está ligado e que há três threads.
No relatório, você deve ver três casos passando, um por navegador, e não três execuções uma depois da outra por falta da anotação CONCURRENT.
Lista de tarefas
Dois testes numa página pública, fora do cadastro de livros. O alvo é https://demo.playwright.dev/todomvc. Não há Quarkus, Docker, ISBN nem API.
Crie a classe ListaTarefasTest num projeto que já tenha a dependência do Playwright. Anote com @UsePlaywright e não use @QuarkusTest. O Page chega como parâmetro do @Test. O enunciado não entrega a solução pronta.
O exercício 9 é curto, só para você reconhecer a tela. O exercício 10 vai um passo além do exercício 6: lá você confirma um diálogo e confere uma mensagem. Aqui você muda o estado de duas tarefas e confere três visões da mesma lista.
page.navigate("https://demo.playwright.dev/todomvc")abre a lista.- O campo de nova tarefa tem o placeholder
What needs to be done?.getByPlaceholderacha esse campo. fillescreve.press("Enter")confirma.- A caixa de seleção fica dentro da linha. Filtre a linha pelo texto e só então chame
getByRolepara o checkbox. - All, Active e Completed são links. Clear completed é um botão, e ele só aparece depois que alguma tarefa está concluída.
Exercício 9: a página abriu
Revise navigate e a espera automática. Escreva um teste que:
- Abra
https://demo.playwright.dev/todomvc. - Confira que o campo com o placeholder
What needs to be done?está visível.
Se esse teste passar, o assistente ligou, o navegador abriu e você achou o primeiro elemento pela língua da tela.
Exercício 10: concluída, filtro e limpeza
Revise filtro de linha, check e not().isVisible(). Na mesma página, num único teste:
- Cadastre
Comprar caféeEstudar Playwright. - Marque só
Comprar cafécomo concluída. - Abra o filtro Active.
Estudar Playwrightcontinua visível eComprar cafénão. - Abra o filtro Completed. Acontece o contrário.
- Volte para All e acione Clear completed.
- Confira que
Comprar cafésumiu eEstudar Playwrightpermanece.
Leia em voz alta: “Duas tarefas, uma concluída, cada filtro mostra só o que promete, e limpar as concluídas deixa apenas a que ainda está em aberto.”
Questões teóricas
Antes de seguir, confira seu entendimento sobre os conceitos. As questões abaixo não exigem código, apenas o domínio da teoria.
Referências
- Playwright Java. Documentação oficial.
- Codegen Java. Guia de gravação.
- Locators Java. Guia de seletores.
- Assertions Java. Referência.
- Parallel execution. JUnit Platform.
- Maven Surefire Plugin.

CC BY 4.0 DEED