Implicit wait in Selenium: What it is & How to use it

Tempo estimado de leitura: 5 minutos

Principais Conclusões

• Uma espera implícita informa ao WebDriver para consultar o DOM por um certo período de tempo ao tentar encontrar um elemento.
• É uma configuração global, aplicada a todas as chamadas `findElement`/`findElements`.
• Pode desacelerar os testes se definido muito alto.
• Use-o com moderação; esperas explícitas são frequentemente preferidas para condições específicas.
• O tempo de espera implícito padrão é 0.

O que é Espera Implícita no Selenium?

No Selenium WebDriver, uma espera implícita é um mecanismo que instrui o WebDriver a esperar um determinado período de tempo antes de lançar uma exceção `NoSuchElementException` se não conseguir encontrar um elemento imediatamente. É como dizer ao WebDriver: “Ei, antes de desistir de encontrar este elemento, espere até X segundos, verificando repetidamente se ele aparece no DOM.”

Essa espera é aplicada globalmente, o que significa que, uma vez definida, ela se aplica a todas as chamadas subsequentes para localizar elementos (`findElement` e `findElements`) durante a vida útil da instância do WebDriver naquela sessão.

Como Funciona a Espera Implícita?

Quando você define um tempo de espera implícito (por exemplo, 10 segundos), e então tenta encontrar um elemento usando `driver.findElement(By.id(“myElement”))`:

1. O WebDriver tenta localizar o elemento no DOM imediatamente.
2. Se o elemento for encontrado, ele é retornado e o script continua.
3. Se o elemento não for encontrado imediatamente, o WebDriver não falha instantaneamente. Em vez disso, ele continua consultando o DOM em intervalos regulares (a frequência exata é interna ao driver) pela duração especificada (10 segundos no nosso exemplo).
4. Se o elemento aparecer no DOM dentro desses 10 segundos, o WebDriver o retorna assim que ele é encontrado.
5. Se o elemento ainda não for encontrado após 10 segundos, o WebDriver finalmente lançará uma exceção `NoSuchElementException`.

Como Definir a Espera Implícita no Selenium (Exemplo Java)

Definir a espera implícita é simples e geralmente feito logo após instanciar o WebDriver. Aqui está como fazer isso em Java:

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import java.time.Duration;

public class ImplicitWaitExample {
    public static void main(String[] args) {
        // Configure o caminho para o seu ChromeDriver
        System.setProperty("webdriver.chrome.driver", "/path/to/chromedriver");

        WebDriver driver = new ChromeDriver();

        // Defina a espera implícita para 10 segundos
        driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10));

        try {
            driver.get("https://example.com");

            // Qualquer chamada findElement/findElements agora esperará até 10 segundos
            // WebElement element = driver.findElement(By.id("someId"));
            // System.out.println("Elemento encontrado!");

        } finally {
            // Feche o navegador
            driver.quit();
        }
    }
}

Neste exemplo, `driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10));` define a espera implícita global para 10 segundos.

Prós e Contras da Espera Implícita

Prós:

• Simples de implementar: Requer apenas uma linha de código para definir globalmente.
• Código mais limpo (às vezes): Evita a necessidade de adicionar esperas explícitas em torno de cada chamada `findElement` para o caso básico de esperar que um elemento exista.

Contras:

• Pode mascarar problemas: Pode ocultar problemas de carregamento lento ou problemas de desempenho real da aplicação.
• Desacelera os testes: Se um elemento realmente não existir, o teste sempre esperará pelo tempo limite completo antes de falhar, tornando os testes mais lentos. Isso é especialmente problemático ao verificar a ausência de um elemento.
• Aplica-se apenas à existência de elementos: A espera implícita verifica apenas se um elemento está presente no DOM. Ela não espera que um elemento seja visível, clicável ou em um estado específico.
• Configuração Global: Sua natureza global significa que você não pode ajustar facilmente o tempo de espera para diferentes elementos ou condições dentro do mesmo script sem redefini-lo.

Quando *Não* Usar a Espera Implícita

• Ao verificar a ausência de um elemento: Usar `findElements` para verificar se uma lista está vazia será desnecessariamente lento se uma espera implícita estiver definida. O WebDriver esperará pelo tempo limite total mesmo que o elemento claramente não exista.
• Quando você precisa esperar por condições específicas: Se você precisa esperar que um elemento seja clicável, visível, contenha texto específico ou qualquer condição além de apenas estar presente no DOM, a espera implícita não ajudará. Você precisará de esperas explícitas.
• Em frameworks complexos ou ao usar esperas explícitas extensivamente: Misturar esperas implícitas e explícitas pode levar a comportamentos imprevisíveis e tempos de espera mais longos do que o esperado. Geralmente é recomendado escolher uma estratégia de espera (preferencialmente explícita) e usá-la consistentemente.

Espera Implícita vs. Espera Explícita vs. Espera Fluente

• Espera Implícita:
  • Escopo: Global (para a sessão do WebDriver).
  • Condição: Apenas para existência de elementos no DOM.
  • Uso: Definido uma vez, aplica-se a todas as buscas de elementos.
• Espera Explícita (`WebDriverWait`):
  • Escopo: Local (aplicado onde você o instancia).
  • Condição: Espera por `ExpectedConditions` específicas (visibilidade, clicabilidade, presença de texto, etc.).
  • Uso: Usado para condições específicas em pontos específicos do seu script. Mais flexível e preferido para a maioria dos cenários de espera.
• Espera Fluente (`FluentWait`):
  • Escopo: Local.
  • Condição: Espera por condições personalizadas ou `ExpectedConditions`.
  • Uso: Uma forma mais avançada de espera explícita que permite configurar o intervalo de sondagem e ignorar exceções específicas durante a espera. Útil para cenários complexos de AJAX ou carregamento dinâmico.

Em resumo, enquanto a espera implícita oferece uma solução simples para o problema comum de elementos que não carregam instantaneamente, suas limitações e natureza global muitas vezes tornam as esperas explícitas uma escolha mais robusta e confiável para a automação moderna da web.

Perguntas frequentes

Qual é o valor padrão para a espera implícita?

O valor padrão para a espera implícita no Selenium WebDriver é 0 segundos. Isso significa que, por padrão, o WebDriver não esperará se não encontrar um elemento imediatamente e lançará uma `NoSuchElementException`.

Posso usar esperas implícitas e explícitas juntas?

Embora tecnicamente possível, não é recomendado misturar esperas implícitas e explícitas. Fazer isso pode levar a comportamentos de espera imprevisíveis e tempos de espera combinados que podem exceder o esperado. A melhor prática é desativar a espera implícita (definindo-a como 0) se você planeja usar esperas explícitas extensivamente.

A espera implícita se aplica a `findElements`?

Sim, a espera implícita se aplica tanto a `findElement` quanto a `findElements`. No entanto, o comportamento difere ligeiramente. Para `findElement`, ele espera até o tempo limite antes de lançar `NoSuchElementException`. Para `findElements`, ele espera até o tempo limite; se nenhum elemento for encontrado, ele retorna uma lista vazia em vez de lançar uma exceção. Se um ou mais elementos forem encontrados antes do tempo limite, ele os retorna imediatamente.

Por que minha espera implícita não está funcionando?

Pode haver várias razões:

• A espera pode não ser longa o suficiente para o elemento aparecer.
• O localizador de elemento que você está usando (`By.id`, `By.cssSelector`, etc.) pode estar incorreto.
• O elemento pode estar dentro de um iframe, exigindo que você mude para o iframe primeiro.
• A espera implícita só espera que o elemento esteja presente no DOM, não que seja visível ou interagível. Se você precisar dessas condições, use uma espera explícita com as `ExpectedConditions` apropriadas.
• Você pode estar misturando esperas implícitas e explícitas, causando comportamento inesperado.