Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

`document.getElementById()` et `document.body` : quelle différence ?

Utilisez `getElementById()` pour rechercher un élément par son identifiant et `document.body` pour accéder au corps du document, avec ou sans identifiant.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

document.getElementById(id)
document.body
document.body = newBody

document.getElementById(id) recherche dans l’arbre de ce document et renvoie un Element ou null. Passez la valeur exacte de id, par exemple "note", et non un sélecteur CSS comme "#note". La recherche est sensible à la casse. Les identifiants doivent être uniques ; en cas de doublon, la méthode renvoie le premier élément correspondant dans l’ordre de l’arbre. Elle ne trouve pas les éléments qui n’y sont pas encore insérés.

Lisez document.body sans parenthèses. Cette propriété renvoie le premier enfant direct de l’élément HTML racine html qui soit un élément HTML body ou l’ancien élément HTML frameset, ou null à défaut. document.getElementById("body") recherche l’identifiant body, et non la balise. Il peut renvoyer un autre élément ou null même si document.body existe.

Une affectation à document.body peut remplacer le nœud du corps existant et tout son sous-arbre. En l’absence de corps, le nouvel élément est ajouté à l’élément racine du document. Affecter null ou un élément autre qu’un élément HTML body ou frameset, ou effectuer l’affectation en l’absence d’élément racine, déclenche une DOMException nommée HierarchyRequestError.

Pendant l’analyse de la page, null peut signifier que le nœud n’a pas encore été créé. Pour du HTML statique, accédez-y après l’analyse, par exemple dans un gestionnaire DOMContentLoaded enregistré avant l’événement, et vérifiez tout de même le résultat avant de l’utiliser. Ces API relèvent de la plateforme web, pas d’ECMAScript 2024 ; un web worker standard ne peut pas accéder au document de la page.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOM lookup example</title>
</head>
<body>
  <script>
    (() => {
      const doc = document.implementation.createHTMLDocument("DOM demo");
      const body = doc.body;
      console.log(`Before setting an ID: ${doc.getElementById("body")}`);

      body.id = "body";
      console.log(`Same node: ${doc.getElementById("body") === body}`);
      console.log(`Wrong case: ${doc.getElementById("Body")}`);

      const item = doc.createElement("p");
      item.id = "note";
      console.log(`Before insertion: ${doc.getElementById("note")}`);
      body.appendChild(item);
      console.log(`After insertion: ${doc.getElementById("note") === item}`);
    })();
  </script>
</body>
</html>

Résultat

Before setting an ID: null
Same node: true
Wrong case: null
Before insertion: null
After insertion: true

Enregistrez l’exemple dans un fichier `.html`, ouvrez-le dans un navigateur et vérifiez les messages dans la console. Le document séparé possède déjà un élément `body`, mais sans identifiant. Après attribution de l’identifiant, les deux accès renvoient le même nœud. L’élément `p` n’est trouvé qu’après son insertion.

Leçons associées

  • JavaScript · Leçon 6 · Avancé · Version : 4

Sources