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

CKTIS / JavaScript

`document.body` et `document.documentElement` : quelle différence ?

`document.body` donne accès à l’élément qui contient le contenu de la page, tandis que `document.documentElement` donne accès à la racine du document. Les deux propriétés peuvent renvoyer `null`.

Version : Current web platform; runtime support varies

Syntaxe

document.body
 document.documentElement
 document.body = newBody

document.documentElement renvoie l’élément racine du document, ou null s’il n’y en a pas. Dans une page HTML ordinaire, c’est <html> ; dans un document XML, la racine peut porter un autre nom. La propriété est en lecture seule, mais on peut modifier l’élément renvoyé, par exemple en définissant son attribut lang.

document.body renvoie le premier enfant direct de la racine <html> qui est un élément <body> ou un ancien élément <frameset>. Ces trois noms désignent des éléments de l’espace de noms HTML. En l’absence d’un enfant correspondant, ou si la racine n’est pas un élément HTML <html>, le résultat est null. Dans une page HTML ordinaire, ajoutez le contenu à <body>, pas directement à <html>.

Affecter un nouvel élément à document.body remplace le corps existant et son sous-arbre au lieu d’y ajouter du contenu. Si le corps est absent, le mutateur ajoute l’élément fourni à la racine. Affecter null ou un élément autre qu’un <body> ou un <frameset> HTML, ou tenter une insertion sans racine, déclenche une DOMException nommée HierarchyRequestError.

Le standard HTML définit document.body, tandis que le standard DOM définit document.documentElement. Aucune de ces propriétés ne fait partie d’ECMAScript 2024. Un environnement sans DOM de page peut ne pas fournir la variable globale document. Pendant l’analyse du HTML, un script peut voir la racine avant la création de <body>. Vérifiez que le résultat n’est pas null avant de l’utiliser ; sur une page ordinaire, vous pouvez attendre DOMContentLoaded si l’analyse est encore en cours.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document body and root</title>
</head>
<body>
  <script>
    {
      const doc = document.implementation.createHTMLDocument();
      const root = doc.documentElement;
      const body = doc.body;

      console.log(`${root.localName} > ${body.localName}`);
      console.log(body.parentElement === root);

      body.remove();
      console.log(doc.body === null);
      console.log(doc.documentElement === root);
    }
  </script>
</body>
</html>

Résultat

html > body
true
true
true

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console. Le script crée un document HTML distinct, affiche les noms des éléments et vérifie le lien parent-enfant. Après la suppression de `<body>`, `doc.body` renvoie `null` et la racine reste le même objet. La page ouverte n’est pas modifiée.

Leçons associées

  • JavaScript · Leçon 32 · Intermédiaire · Version : 3

Sources