CKTIS / JavaScript
`document.getElementById()` frente a `document.body`
Usa `getElementById()` para buscar un elemento por su identificador y `document.body` para acceder al cuerpo del documento, tenga o no un identificador.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
document.getElementById(id)
document.body
document.body = newBodydocument.getElementById(id) busca en el árbol de ese documento y devuelve un Element o null. Pasa el valor exacto de id, por ejemplo "note", no un selector CSS como "#note". La búsqueda distingue mayúsculas y minúsculas. Los identificadores deben ser únicos; si hay duplicados, se devuelve la primera coincidencia en el orden del árbol. No se encuentran los elementos que aún no se han insertado en él.
Lee document.body sin paréntesis. Devuelve el primer hijo directo del elemento HTML raíz html que sea un elemento HTML body o un elemento HTML obsoleto frameset, o null si no hay ninguno. document.getElementById("body") busca el identificador body, no la etiqueta; puede devolver otro elemento o null aunque exista document.body.
Asignar un valor a document.body puede sustituir todo el nodo del cuerpo y su subárbol. Si no hay cuerpo, el nuevo elemento se añade al elemento raíz del documento. Asignar null o un elemento que no sea un elemento HTML body o frameset, o asignar cuando el documento no tiene elemento raíz, lanza una DOMException llamada HierarchyRequestError.
Durante el análisis de la página, null puede indicar que el nodo aún no se ha creado. Con HTML estático, accede al nodo después del análisis, por ejemplo en un manejador de DOMContentLoaded registrado antes del evento, y aun así comprueba el resultado antes de usarlo. Estas API son de la plataforma web, no de ECMAScript 2024; un web worker estándar no puede acceder al document de la página.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM lookup example</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument("DOM demo");
const body = doc.body;
console.log(`Before setting an ID: ${doc.getElementById("body")}`);
body.id = "body";
console.log(`Same node: ${doc.getElementById("body") === body}`);
console.log(`Wrong case: ${doc.getElementById("Body")}`);
const item = doc.createElement("p");
item.id = "note";
console.log(`Before insertion: ${doc.getElementById("note")}`);
body.appendChild(item);
console.log(`After insertion: ${doc.getElementById("note") === item}`);
})();
</script>
</body>
</html>Resultado
Before setting an ID: null Same node: true Wrong case: null Before insertion: null After insertion: true
Guarda el ejemplo como archivo `.html`, ábrelo en un navegador y comprueba los mensajes en la consola. El documento separado ya tiene un elemento `body`, pero sin identificador. Tras asignarle uno, las dos formas de acceso devuelven el mismo nodo. El elemento `p` solo se encuentra después de insertarlo.
Lecciones relacionadas
- JavaScript · Lección 6 · Avanzado · Versión: 4