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

CKTIS / JavaScript

Document.getElementById() y documentElement: búsqueda por ID y elemento raíz

`getElementById()` busca un elemento por su ID exacto, mientras que `documentElement` da el elemento raíz del documento. Ambos pueden devolver `null`, pero por motivos distintos.

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

Sintaxis

doc.getElementById(id) // Element or null
doc.documentElement    // Element or null; read-only

doc.getElementById(id) busca en el árbol actual de doc. Pasa el ID tal cual, por ejemplo 'Panel', sin añadir el prefijo # de un selector CSS. La búsqueda distingue mayúsculas de minúsculas y devuelve un Element o null si no hay coincidencia. Los ID de HTML deben ser únicos dentro de su árbol. Si hay duplicados, se devuelve la primera coincidencia en el orden del árbol.

La búsqueda no incluye elementos que no se hayan insertado en ese árbol ni elementos dentro de árboles de shadow DOM. Si el código se ejecuta antes de la inserción, el resultado puede ser null; compruébalo antes de acceder a una propiedad. Una llamada posterior repite la búsqueda, pero una referencia guardada no cambia al retirar el elemento.

doc.documentElement es una propiedad de solo lectura, no un método. Da el elemento raíz con independencia de su ID: html en un documento HTML típico, o el elemento que haga de raíz en XML. No es el propio nodo Document ni body. Si no hay elemento raíz, su valor es null.

Ambos miembros forman parte de la API DOM de la Web, no de ECMAScript 2024. Que un entorno admita JavaScript no garantiza por sí solo que disponga de document.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document ID lookup and root element</title>
</head>
<body>
  <script>
    (() => {
      const doc = document.implementation.createHTMLDocument('Demo');
      const panel = doc.createElement('div');
      panel.id = 'Panel';

      console.log(doc.documentElement.localName);
      console.log(doc.getElementById('Panel'));
      doc.body.appendChild(panel);
      console.log(doc.getElementById('Panel') === panel);
      console.log(doc.getElementById('panel'));
      console.log(new Document().documentElement);
    })();
  </script>
</body>
</html>

Resultado

html
null
true
null
null

Guarda el ejemplo como archivo `.html`, ábrelo en un navegador y consulta los resultados en la consola de desarrollo. El ejemplo crea un documento HTML aparte y no modifica la página actual. `'Panel'` solo se encuentra tras insertarlo, `'panel'` no coincide y un `Document` nuevo y vacío no tiene elemento raíz.

Lecciones relacionadas

  • JavaScript · Lección 19 · Avanzado · Versión: 4
  • JavaScript · Lección 33 · Avanzado · Versión: 4

Fuentes