CKTIS / JavaScript
Document.body: acceder al elemento body del documento
Document.body es una propiedad de la API web a la que se accede como document.body. Devuelve un elemento body, un elemento frameset heredado o null. Al asignarle un valor, se reemplaza el elemento entero, no solo su contenido.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
document.body
document.body = newBodyDocument.body es una propiedad de la interfaz Document y se utiliza como document.body. Devuelve el primer hijo directo del elemento raíz del documento que sea un elemento body o frameset en el espacio de nombres HTML. Si no hay ningún hijo que cumpla esa condición, devuelve null. El propio elemento raíz no tiene por qué ser un elemento html. No devuelve texto ni una copia del elemento.
Ten en cuenta que el resultado puede ser null antes de usarlo, por ejemplo, si el analizador aún no ha creado el elemento body. Esta es una API web definida por el HTML Standard, no una característica de ECMAScript en sí. La versión de Node del repositorio no demuestra que esta API del navegador esté disponible.
La asignación document.body = newBody reemplaza el elemento existente y su subárbol; no copia el contenido anterior. Asignar el mismo elemento no produce cambios. Si falta el elemento body, el nuevo se añade al elemento raíz. Si falta el elemento raíz, o se asigna null o un elemento div, se produce una DOMException HierarchyRequestError: se aceptan los elementos body y frameset.
El ejemplo utiliza un documento independiente. Muestra cómo reemplazar el elemento y separar el anterior sin modificar la página que se está mostrando.
Ejemplos
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);Resultado
true After true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.