Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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 = newBody

Document.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.

Fuentes