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

CKTIS / JavaScript

Document.body — accéder à l’élément body du document

Document.body est une propriété d’API Web accessible avec document.body. Elle renvoie un élément body, un ancien élément frameset ou null. Une affectation remplace l’élément entier, et pas seulement son contenu.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

document.body
document.body = newBody

Document.body est une propriété de l’interface Document, accessible avec document.body. Elle renvoie le premier enfant direct de l’élément racine du document qui soit un élément body ou frameset dans l’espace de noms HTML. S’il n’y en a pas, elle renvoie null. L’élément racine lui-même n’est pas nécessairement un élément html. Elle ne renvoie ni du texte ni une copie de l’élément.

Tenez compte de la possibilité d’obtenir null avant d’utiliser le résultat, par exemple si l’analyseur n’a pas encore créé l’élément body. Il s’agit d’une API Web définie par le HTML Standard, et non d’une fonctionnalité d’ECMAScript lui-même. La version de Node du dépôt ne permet pas d’établir la disponibilité de cette API de navigateur.

L’affectation document.body = newBody remplace l’élément existant et son sous-arbre ; elle ne copie pas l’ancien contenu. Affecter le même élément ne change rien. Si l’élément body est absent, le nouvel élément est ajouté à l’élément racine. L’absence de l’élément racine, ou l’affectation de null ou d’un élément div, provoque une DOMException HierarchyRequestError : les éléments body et frameset sont acceptés.

L’exemple utilise un document distinct. Il montre le remplacement de l’élément et le détachement de l’ancien sans modifier la page affichée.

Exemples

const doc = document.implementation.createHTMLDocument("");
const original = doc.body;
original.textContent = "Before";

const replacement = doc.createElement("body");
replacement.textContent = "After";
doc.body = replacement;

console.log(doc.body === replacement);
console.log(doc.body.textContent);
console.log(original.parentNode === null);

Résultat

true
After
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources