CKTIS / JavaScript
Diferencia entre `document.body` y `document.documentElement`
Usa `document.body` para acceder al elemento que contiene el contenido de la página y `document.documentElement` para acceder al elemento raíz del documento. Ambas propiedades pueden devolver `null`.
Versión: Current web platform; runtime support varies
Sintaxis
document.body
document.documentElement
document.body = newBodydocument.documentElement devuelve el elemento raíz del documento, o null si no existe. En una página HTML normal es <html>; en un documento XML, la raíz puede tener otro nombre. La propiedad es de solo lectura, pero puedes modificar el elemento devuelto, por ejemplo, estableciendo su atributo lang.
document.body devuelve el primer hijo directo de la raíz <html> que sea un <body> o un <frameset> obsoleto. Los tres nombres se refieren a elementos del espacio de nombres HTML. Si no hay un hijo que cumpla esa condición o la raíz no es un elemento HTML <html>, devuelve null. En una página HTML normal, añade el contenido a <body>, no directamente a <html>.
Asignar un elemento nuevo a document.body reemplaza el cuerpo existente y su subárbol en vez de añadirle contenido. Si no hay cuerpo, el setter añade el elemento proporcionado a la raíz. Asignar null o un elemento que no sea un <body> o un <frameset> de HTML, o intentar insertar un elemento cuando no hay raíz, lanza una DOMException llamada HierarchyRequestError.
El estándar HTML define document.body y el estándar DOM define document.documentElement. Ninguna de estas propiedades forma parte de ECMAScript 2024. Un entorno sin DOM de página puede no ofrecer el objeto global document. Durante el análisis del HTML, un script puede ver la raíz antes de que se cree <body>. Comprueba que el resultado no sea null antes de usarlo; en una página normal puedes esperar a DOMContentLoaded si el análisis sigue en curso.
Ejemplos
<!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>Resultado
html > body true true true
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola. El script crea un documento HTML independiente, muestra los nombres de los elementos y comprueba la relación padre-hijo. Tras eliminar `<body>`, `doc.body` devuelve `null` y la raíz sigue siendo el mismo objeto. La página abierta no cambia.
Lecciones relacionadas
- JavaScript · Lección 32 · Intermedio · Versión: 3