Comando
WaitElement()
Pausa o script até que o elemento HTML identificado pelo seletor CSS fique interagível (visível e habilitado) na página. É o comando de sincronização mais usado para aguardar carregamentos dinâmicos.
WaitElement(selector, timeout [, appId])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
selector | Sim | Seletor do elemento aguardado. Utilize a janela de configuração do comando no DevStudio para obter os seletores. |
timeout | Sim | Tempo máximo em segundos. |
appId | Não | Identificador da instância de browser. |
Exemplos
// Aguardar formulário de login aparecer:
WaitElement('#formLogin', 30)
// Aguardar resultado de pesquisa:
WebClick('#btnBuscar')
WaitElement('#resultados table', 60)
// Aguardar spinner de carregamento sumir e botão aparecer:
WaitElement('#btnConfirmar:not([disabled])', 30)
// Aguardar após troca de tab:
ChangeTab(1)
WaitElement('#conteudoAba', 20)Observações
Verifica se o elemento existe no DOM E está interagível (visível + não desabilitado). Lança exceção se o timeout expirar. É o método preferido para sincronização entre ações — use sempre antes de interagir com elementos após carregamentos dinâmicos.