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 = newBodyDocument.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.