Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Cercare un elemento per ID e controllare lo stato del documento

`getElementById()` verifica se un elemento è nell’albero del documento. `readyState` indica la fase di caricamento, non la presenza di uno specifico elemento.

Versione: Current web platform; runtime support varies

Sintassi

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

document.getElementById(id) cerca nell’albero attuale di quel documento. Passa il valore esatto di id, rispettando maiuscole e minuscole, senza aggiungere il prefisso # dei selettori CSS. Il metodo restituisce un Element oppure null. In caso di ID duplicati restituisce la prima corrispondenza nell’ordine dell’albero, ma gli ID devono essere univoci nel documento HTML. Controlla il risultato: leggere una proprietà di null genera un TypeError.

document.readyState è una proprietà di sola lettura, non un metodo. Durante il normale caricamento di una pagina, "loading" indica che l’analisi del documento è in corso e "interactive" che è terminata. Con "complete", le risorse che ritardano l’evento load della finestra sono state caricate, appena prima che l’evento si verifichi. Un cambio di stato attiva readystatechange sul documento. DOMContentLoaded si verifica dopo il passaggio a "interactive", una volta eseguiti gli script classici con defer e dopo che il browser ha avviato la valutazione degli script di modulo senza async previsti per l’esecuzione dopo l’analisi. L’evento non garantisce che sia già stato eseguito il codice successivo a un await al livello più esterno di un modulo. Non attende direttamente le immagini.

Se per l’inizializzazione basta il DOM già analizzato, verifica document.readyState === "loading": se la condizione è vera, registra sul documento un listener per DOMContentLoaded con { once: true }; altrimenti avvia subito l’inizializzazione. "interactive" non garantisce che DOMContentLoaded si sia già verificato. Anche con "complete" la ricerca può restituire null, ad esempio se l’app inserisce l’elemento più tardi. Lo standard DOM definisce getElementById() e lo standard HTML definisce readyState. Entrambi fanno parte delle API Web, non di ECMAScript; un ambiente senza il DOM del browser potrebbe non fornirli.

Esempi

<!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>

Risultato

complete
true
true
true

Salva l’esempio come file HTML, aprilo in un browser e controlla il risultato nella console. Il nuovo documento è già nello stato `complete`, ma la ricerca trova `status` solo dopo l’inserimento. `Status` continua a non corrispondere.

Lezioni correlate

  • JavaScript · Lezione 39 · Intermedio · Versione: 3

Fonti