CKTIS / JavaScript
Recherche par ID, élément racine et corps du document
`getElementById()` recherche un élément par son identifiant, `documentElement` donne l’élément racine et `body` donne accès au corps HTML du document. Les trois peuvent renvoyer `null` pour des raisons différentes.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
doc.getElementById(id) // id: string; returns Element or null
doc.documentElement // read-only; returns Element or null
doc.body // returns HTMLBodyElement, HTMLFrameSetElement, or null
doc.body = newBody // assigns an HTML body or frameset elementdoc.getElementById(id) cherche dans l’arbre du document doc. Passez la valeur exacte de id sans ajouter de préfixe # : ce n’est pas un sélecteur CSS, et la casse compte. La méthode renvoie un Element correspondant ou null. Les identifiants doivent être uniques ; en cas de doublon, le premier élément dans l’ordre de l’arbre l’emporte. La recherche ignore les nœuds détachés et ne pénètre pas dans les arbres du Shadow DOM.
doc.documentElement est en lecture seule : cette propriété renvoie l’élément racine (<html> dans un document HTML ; en XML, la racine peut être différente) ou null s’il n’y en a pas. doc.body renvoie le premier enfant direct de <html> qui est un <body> ou un <frameset> obsolète, ou null à défaut. Lisez les deux propriétés sans parenthèses.
Contrairement à documentElement, body peut recevoir une nouvelle valeur pour remplacer l’élément existant. Ses enfants ne sont pas transférés vers le nouvel élément. Affecter null ou un HTMLElement qui n’est ni un <body> ni un <frameset> déclenche HierarchyRequestError. Si l’élément n’implémente pas HTMLElement, comme dans le cas d’un élément SVG, la conversion Web IDL déclenche un TypeError avant l’appel du setter. Affecter un <body> ou un <frameset> valide déclenche aussi HierarchyRequestError si le document n’a pas d’élément racine.
Pendant l’analyse du HTML, le corps ou l’élément recherché peut ne pas encore exister. Si le code dépend du balisage de la page, attendez DOMContentLoaded lorsque document.readyState === "loading" ; sinon, exécutez-le immédiatement. Vérifiez que le résultat n’est pas null avant de l’utiliser : lire directement une propriété de null déclenche un TypeError. Ces API sont définies par les standards DOM et HTML, et non par ECMAScript. La mention d’ECMAScript 2024 ne renseigne pas sur leur disponibilité ; un environnement JavaScript ne fournit pas nécessairement document.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document lookup demo</title>
</head>
<body>
<script>
const doc = document.implementation.createHTMLDocument("Demo");
const panel = doc.createElement("section");
panel.id = "Panel";
console.log(doc.documentElement.localName);
console.log(doc.body.localName);
console.log(doc.getElementById("Panel"));
doc.body.appendChild(panel);
console.log(doc.getElementById("Panel") === panel);
console.log(doc.getElementById("panel"));
</script>
</body>
</html>Résultat
html body null true null
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console de développement. Le document HTML séparé possède déjà `html` et `body` et ne modifie pas la page qui exécute le script. `Panel` n’est trouvé qu’après l’insertion ; `panel` ne correspond pas à cause de la casse.
Leçons associées
- JavaScript · Leçon 37 · Avancé · Version : 4