CKTIS / JavaScript
Rechercher un élément par ID et vérifier l’état du document
`getElementById()` vérifie si un élément est présent dans l’arbre du document. `readyState` indique une phase de chargement, pas la présence d’un élément précis.
Version : Current web platform; runtime support varies
Syntaxe
document.getElementById(id); // Element | null
document.readyState; // "loading" | "interactive" | "complete"document.getElementById(id) parcourt l’arbre actuel de ce document. Passe la valeur exacte de id, en respectant la casse et sans ajouter le préfixe # d’un sélecteur CSS. La méthode renvoie un Element ou null. En cas de doublon, elle renvoie le premier élément correspondant dans l’ordre de l’arbre, mais les ID doivent être uniques dans un document HTML. Vérifie le résultat : lire une propriété de null déclenche une TypeError.
document.readyState est une propriété en lecture seule, pas une méthode. Lors du chargement normal d’une page, "loading" indique que l’analyse du document est en cours et "interactive" qu’elle est terminée. À "complete", les ressources qui retardent l’événement load de la fenêtre ont fini de se charger et cet événement est sur le point de se déclencher. Un changement d’état déclenche readystatechange sur le document. DOMContentLoaded se déclenche après le passage à "interactive", une fois que les scripts classiques avec defer se sont exécutés et que le navigateur a lancé l’évaluation des scripts de module sans async prévus pour s’exécuter après l’analyse. L’événement ne garantit pas que le code qui suit un await au niveau supérieur d’un module a déjà été exécuté. Il n’attend pas directement les images.
Si l’initialisation a seulement besoin du DOM issu de l’analyse, teste document.readyState === "loading" : si le test est vrai, ajoute au document un écouteur de DOMContentLoaded avec { once: true } ; sinon, lance immédiatement l’initialisation. "interactive" ne garantit pas que DOMContentLoaded a déjà eu lieu. Même à "complete", la recherche peut renvoyer null, par exemple si l’application ajoute l’élément plus tard. Le standard DOM définit getElementById(), et le standard HTML définit readyState. Ces deux membres relèvent des API Web, pas d’ECMAScript ; un environnement sans DOM de navigateur peut ne pas les fournir.
Exemples
<!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>Résultat
complete true true true
Enregistre l’exemple dans un fichier HTML, ouvre-le dans un navigateur et vérifie le résultat dans la console. Le nouveau document est déjà à l’état `complete`, mais la recherche ne trouve `status` qu’après l’insertion. `Status` ne correspond toujours pas.
Leçons associées
- JavaScript · Leçon 39 · Intermédiaire · Version : 3