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

CKTIS / JavaScript

Document — acceso al documento de una página

Document representa un documento DOM. El objeto document permite buscar elementos, leer la raíz del documento y usar propiedades de la página relacionadas con el título, el foco y la visibilidad. Es una interfaz de la plataforma web, no una parte del propio ECMAScript.

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(id)
document.documentElement
document.body
document.title
document.activeElement
document.hidden
document.addEventListener("visibilitychange", handler)

Document representa un documento DOM; en un script de página, document hace referencia al documento actual. No es ni window ni el elemento raíz. Es una interfaz de la plataforma web: la disponibilidad de JavaScript por sí sola, también en Node 24, no demuestra que sea compatible.

Document.getElementById(id) devuelve el primer elemento coincidente según el orden del árbol, o null. Pasa el identificador sin # y comprueba el resultado antes de usarlo. Document.documentElement identifica el elemento raíz o vale null. En una página HTML típica, es el elemento html. Document.body proporciona el elemento body o frameset, pero puede valer null, por ejemplo, antes de que lo cree el analizador. Document.title permite leer o cambiar el título del documento.

Document.activeElement identifica el elemento asociado al foco; no tiene por qué ser un campo de texto. Cuando el foco está dentro de un documento incrustado o de un árbol de sombra, puede identificar el elemento contenedor o el host, respectivamente, en lugar del elemento más profundo. Document.hidden es un valor booleano que indica si el documento está oculto, no si carece de foco. Document.visibilitychange designa el evento visibilitychange, no un método: gestiónalo con document.addEventListener("visibilitychange", handler) y lee document.hidden dentro del controlador.

El ejemplo crea un documento HTML separado, por lo que no modifica la página abierta y produce valores predecibles. No prueba el foco ni la visibilidad, que dependen del entorno. La cobertura de las fuentes es limitada: el DOM Standard proporcionado define el núcleo de Document, pero no todas las extensiones HTML enumeradas sobre el título, el cuerpo, el foco y la visibilidad. Aquí no se han establecido las versiones mínimas de los navegadores.

Ejemplos

const demo = document.implementation.createHTMLDocument("Document demo");
const item = demo.createElement("p");
item.id = "message";
item.textContent = "Hello, DOM";
demo.body.appendChild(item);

console.log(demo.documentElement.localName);
console.log(demo.body.localName);
console.log(demo.title);
console.log(demo.getElementById("message").textContent);
console.log(demo.getElementById("missing") === null);

Resultado

html
body
Document demo
Hello, DOM
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.

Fuentes