CKTIS / JavaScript
document.getElementById — buscar un elemento por su ID
document.getElementById(elementId) devuelve el elemento con el ID indicado o null. La búsqueda distingue entre mayúsculas y minúsculas y recorre los descendientes del documento.
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.getElementById(elementId)document.getElementById(elementId) es un método del DOM, no forma parte de ECMAScript en sí. Pasa un valor id, como "status", sin el prefijo #: el argumento no es un selector CSS. El resultado es un Element o null. La búsqueda distingue entre mayúsculas y minúsculas; un identificador vacío no coincide con ningún elemento.
El método busca entre los descendientes del documento. No encontrará un elemento desconectado. Si hay IDs duplicados, devuelve el primer elemento según el orden del árbol, que no tiene por qué ser el primero que se creó. Comprueba que el resultado no sea null antes de usarlo; realiza la búsqueda solo después de añadir el elemento objetivo al documento.
getElementById también está disponible en DocumentFragment, pero no en objetos Element ordinarios. La búsqueda en el documento no entra en los árboles de sombra. El ejemplo requiere un entorno DOM de navegador; una versión de Node.js por sí sola no demuestra que esta API esté disponible.
Ejemplos
{
const document = globalThis.document.implementation.createHTMLDocument("");
const item = document.createElement("div");
item.id = "status";
console.log(document.getElementById("status") === null);
document.body.appendChild(item);
console.log(document.getElementById("status") === item);
console.log(document.getElementById("Status") === null);
item.remove();
console.log(document.getElementById("status") === null);
}Resultado
true true true 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.