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

CKTIS / JavaScript

Buscar un elemento por ID y consultar el estado del documento

`getElementById()` comprueba si un elemento está en el árbol del documento. `readyState` indica la fase de carga, no la presencia de un elemento concreto.

Versión: Current web platform; runtime support varies

Sintaxis

document.getElementById(id); // Element | null
document.readyState; // "loading" | "interactive" | "complete"

document.getElementById(id) busca en el árbol actual de ese documento. Pasa el valor exacto de id, respetando mayúsculas y minúsculas y sin añadir el prefijo # de los selectores CSS. El método devuelve un Element o null. Si hay ID repetidos, devuelve la primera coincidencia en el orden del árbol, pero los ID deben ser únicos en un documento HTML. Comprueba el resultado: leer una propiedad de null lanza un TypeError.

document.readyState es una propiedad de solo lectura, no un método. Durante la carga normal de una página, "loading" indica que el análisis del documento sigue en curso e "interactive" indica que ha terminado. En "complete" ya se han cargado los recursos que retrasan el evento load de la ventana, justo antes de que se dispare. Cada cambio de estado dispara readystatechange en el documento. DOMContentLoaded se dispara tras pasar a "interactive", una vez que se han ejecutado los scripts clásicos con defer y el navegador ha iniciado la evaluación de los scripts de módulo sin async previstos para ejecutarse después del análisis. El evento no garantiza que se haya ejecutado el código posterior a un await en el nivel superior de un módulo. No espera directamente a las imágenes.

Si la inicialización solo necesita el DOM ya analizado, comprueba document.readyState === "loading": si se cumple, registra en el documento un escuchador de DOMContentLoaded con { once: true }; si no, inicia el código de inmediato. "interactive" no garantiza que DOMContentLoaded ya se haya disparado. Incluso en "complete", la búsqueda puede devolver null, por ejemplo si la aplicación inserta el elemento más tarde. El estándar DOM define getElementById() y el estándar HTML define readyState. Ambos miembros son parte de las API web, no de ECMAScript; un entorno sin el DOM del navegador puede no ofrecerlos.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document readiness and ID lookup</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument();
    const item = doc.createElement("p");
    item.id = "status";

    console.log(doc.readyState);
    console.log(doc.getElementById("status") === null);
    doc.body.append(item);
    console.log(doc.getElementById("status") === item);
    console.log(doc.getElementById("Status") === null);
  </script>
</body>
</html>

Resultado

complete
true
true
true

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y comprueba el resultado en la consola. El nuevo documento ya está en `complete`, pero la búsqueda solo encuentra `status` tras insertarlo. `Status` sigue sin coincidir.

Lecciones relacionadas

  • JavaScript · Lección 39 · Intermedio · Versión: 3

Fuentes