Ver o botão no snapshot não garante que seja possível clicar. O navegador precisa de um alvo correto, estável e habilitado que o ponteiro alcance. Se falhar, leia o primeiro erro útil e confira o que deveria mudar na página.
Confira visibilidade, estado e destino do ponteiro
Verifique se o localizador aponta para um único controle na seção certa. Um botão visível pode estar desativado. Uma caixa, um carregamento ou um aviso pode cobrir um botão habilitado. Se houver interceptação, confira o que recebe o ponteiro e resolva pelo fluxo autorizado. Permissões e desafios obrigatórios ficam com o operador.
Reproduza três casos em uma página
O exercício tem um botão coberto, um desativado e um fora da tela. Tabbit CLI usou localizadores por função compatíveis com Playwright em 1000 × 580. O primeiro estava visível e habilitado, mas o ponteiro atingia a camada. O clique expirou com intercepts pointer events e o estado ficou waiting. Após Dismiss overlay, um novo clique confirmou.
Cumpra o requisito do botão desativado
O segundo estava visível e sob o ponteiro, mas enabled era falso. O clique expirou com element is not enabled e ficou waiting. Enable action o habilitou e o clique seguinte confirmou. Em um site real, cumpra a condição prevista ou pare. Alterar a propriedade pode pular o fluxo que você precisa verificar.
Fora da tela é diferente de oculto
O terceiro estava habilitado a 1.340 pixels CSS do topo, fora da janela de 580 pixels. O localizador rolou e retornou Offscreen action: confirmed. Uma coordenada da captura não alcança um controle fora da tela. Para um controle oculto, talvez seja necessário abrir menu ou painel.
| Etapa | Resultado esperado |
|---|---|
| Covered | intercepts pointer events → waiting → confirmed |
| Disabled | element is not enabled → waiting → confirmed |
| Offscreen | scroll → confirmed |
Atualize a observação antes de localizar de novo
Após renderização, navegação, diálogo ou rolagem, faça novo snapshot ou captura. Restrinja rótulos iguais à seção ou linha. Confira estado e ação. Depois do clique, verifique texto, URL ou registro. Em caso de dúvida, leia antes de tentar de novo, sobretudo se houver gravação.
| Etapa | Resultado esperado |
|---|---|
| 1 | role + accessible name |
| 2 | click + state |
| 3 | confirmed marker |
O que usuários relatam
No r/QualityAssurance, uma pessoa achou um alvo único sob o ponteiro, mas clique e leitura de atributo expiraram. Vale checar sessão e tempo antes de culpar a camada. No r/selenium, outra pessoa usando Playwright não distinguia oculto de fora da tela. O exercício separa os casos.
Devo forçar o clique?
Primeiro identifique por que o clique normal falha. Forçar pode pular verificações e esconder um problema real. Confirme o resultado esperado depois.
Perguntas frequentes
Devo forçar o clique?
Primeiro identifique por que o clique normal falha. Forçar pode pular verificações e esconder um problema real. Confirme o resultado esperado depois.
Por que um botão visível não pode ser clicado?
Verifique se o localizador aponta para um único controle na seção certa. Um botão visível pode estar desativado. Uma caixa, um carregamento ou um aviso pode cobrir um botão habilitado. Se houver interceptação, confira o que recebe o ponteiro e resolva pelo fluxo autorizado. Permissões e desafios obrigatórios ficam com o operador.
Como resolver uma interceptação?
O exercício tem um botão coberto, um desativado e um fora da tela. Tabbit CLI usou localizadores por função compatíveis com Playwright em 1000 × 580. O primeiro estava visível e habilitado, mas o ponteiro atingia a camada. O clique expirou com intercepts pointer events e o estado ficou waiting. Após Dismiss overlay, um novo clique confirmou.
O que conferir se o botão está desativado?
O segundo estava visível e sob o ponteiro, mas enabled era falso. O clique expirou com element is not enabled e ficou waiting. Enable action o habilitou e o clique seguinte confirmou. Em um site real, cumpra a condição prevista ou pare. Alterar a propriedade pode pular o fluxo que você precisa verificar.
O localizador pode clicar fora da tela?
O terceiro estava habilitado a 1.340 pixels CSS do topo, fora da janela de 580 pixels. O localizador rolou e retornou Offscreen action: confirmed. Uma coordenada da captura não alcança um controle fora da tela. Para um controle oculto, talvez seja necessário abrir menu ou painel.