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

CKTIS / JavaScript

Búsqueda por ID, elemento raíz y cuerpo del documento

Usa `getElementById()` para buscar por ID, `documentElement` para obtener el elemento raíz y `body` para acceder al cuerpo HTML del documento. Las tres operaciones pueden devolver `null` por motivos distintos.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

doc.getElementById(id) // id: string; returns Element or null
 doc.documentElement // read-only; returns Element or null
 doc.body // returns HTMLBodyElement, HTMLFrameSetElement, or null
 doc.body = newBody // assigns an HTML body or frameset element

doc.getElementById(id) busca en el árbol del documento doc. Pasa el valor exacto de id sin añadir el prefijo #: no es un selector CSS y distingue entre mayúsculas y minúsculas. El método devuelve un Element coincidente o null. Los identificadores deben ser únicos; si hay duplicados, se devuelve el primer elemento en el orden del árbol. La búsqueda no incluye nodos desconectados ni entra en los árboles del Shadow DOM.

doc.documentElement es de solo lectura: devuelve el elemento raíz (<html> en un documento HTML; en XML puede ser otro) o null si no existe. doc.body devuelve el primer hijo directo de <html> que sea un <body> o un <frameset> obsoleto, o null si no hay ninguno. Lee ambas propiedades sin paréntesis.

A diferencia de documentElement, body admite una asignación que reemplaza el elemento existente. Sus hijos no se trasladan al nuevo elemento. Asignar null o un HTMLElement que no sea ni <body> ni <frameset> lanza HierarchyRequestError. Si el elemento no implementa HTMLElement, como ocurre con un elemento SVG, la conversión de Web IDL lanza un TypeError antes de que se ejecute el setter. Asignar un <body> o un <frameset> válido también lanza HierarchyRequestError si el documento no tiene elemento raíz.

Durante el análisis del HTML, puede que el cuerpo o el elemento buscado todavía no exista. Si el código depende del marcado de la página, espera a DOMContentLoaded cuando document.readyState === "loading"; si no está en ese estado, ejecútalo de inmediato. Comprueba que el resultado no sea null antes de usarlo: leer directamente una propiedad de null lanza un TypeError. Estas API están definidas por los estándares DOM y HTML, no por ECMAScript. La mención de ECMAScript 2024 no indica si están disponibles; no des por hecho que un entorno JavaScript proporciona document.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document lookup demo</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument("Demo");
    const panel = doc.createElement("section");
    panel.id = "Panel";

    console.log(doc.documentElement.localName);
    console.log(doc.body.localName);
    console.log(doc.getElementById("Panel"));

    doc.body.appendChild(panel);
    console.log(doc.getElementById("Panel") === panel);
    console.log(doc.getElementById("panel"));
  </script>
</body>
</html>

Resultado

html
body
null
true
null

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y revisa la consola de desarrollo. El documento HTML separado ya tiene `html` y `body` y no modifica la página que ejecuta el script. `Panel` solo se encuentra tras la inserción; `panel` no coincide por la diferencia entre mayúsculas y minúsculas.

Lecciones relacionadas

  • JavaScript · Lección 37 · Avanzado · Versión: 4

Fuentes