Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Procurar um elemento por ID e verificar o estado do documento

`getElementById()` verifica se um elemento está na árvore do documento. `readyState` indica a fase de carregamento, não a presença de um elemento específico.

Versão: Current web platform; runtime support varies

Sintaxe

document.getElementById(id); // Element | null
document.readyState; // "loading" | "interactive" | "complete"

document.getElementById(id) pesquisa na árvore atual desse documento. Passa o valor exato de id, distinguindo maiúsculas de minúsculas, sem acrescentar o prefixo # dos seletores CSS. O método devolve um Element ou null. Se houver IDs repetidos, devolve a primeira correspondência na ordem da árvore, mas os IDs devem ser únicos num documento HTML. Verifica o resultado: ler uma propriedade de null lança um TypeError.

document.readyState é uma propriedade só de leitura, não um método. Durante o carregamento normal de uma página, "loading" indica que a análise do documento está em curso e "interactive" que terminou. Em "complete", os recursos que atrasam o evento load da janela já foram carregados e o evento está prestes a ser disparado. Uma mudança de estado dispara readystatechange no documento. DOMContentLoaded ocorre depois da transição para "interactive", depois de serem executados os scripts clássicos com defer e de o navegador iniciar a avaliação dos scripts de módulo sem async previstos para execução após a análise. O evento não garante que o código a seguir a um await no nível superior de um módulo já tenha sido executado. Não espera diretamente pelas imagens.

Se a inicialização só precisar do DOM já analisado, verifica document.readyState === "loading": se for verdadeiro, regista no documento um ouvinte de DOMContentLoaded com { once: true }; caso contrário, inicia de imediato. "interactive" não garante que DOMContentLoaded já tenha ocorrido. Mesmo em "complete", a pesquisa pode devolver null, por exemplo se a aplicação inserir o elemento mais tarde. A norma DOM define getElementById() e a norma HTML define readyState. Ambos fazem parte das APIs Web, não de ECMAScript; um ambiente sem o DOM do navegador pode não os disponibilizar.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document readiness and ID lookup</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument();
    const item = doc.createElement("p");
    item.id = "status";

    console.log(doc.readyState);
    console.log(doc.getElementById("status") === null);
    doc.body.append(item);
    console.log(doc.getElementById("status") === item);
    console.log(doc.getElementById("Status") === null);
  </script>
</body>
</html>

Resultado

complete
true
true
true

Guarda o exemplo num ficheiro HTML, abre-o num navegador e verifica o resultado na consola. O novo documento já está em `complete`, mas só é possível encontrar `status` depois de o inserir. `Status` continua a não corresponder.

Lições relacionadas

  • JavaScript · Lição 39 · Intermédio · Versão: 3

Fontes