CKTIS / JavaScript
Buscar un elemento por ID y reaccionar a la visibilidad del documento
Busca un elemento con `getElementById()`, consulta la visibilidad mediante `document.hidden` y actualiza la interfaz al recibir `visibilitychange`.
Versión: Current web platform; runtime support varies
Sintaxis
// Browser DOM and HTML APIs; support depends on the browser, not on the ECMAScript edition.
document.getElementById(id) // Element | null
// Read-only visibility properties:
document.hidden // boolean
document.visibilityState // "hidden" | "visible"
// Register and later remove the same listener:
document.addEventListener("visibilitychange", handler)
document.removeEventListener("visibilitychange", handler)document.getElementById(id) recibe el valor del ID sin el prefijo # y distingue mayúsculas de minúsculas. Devuelve un Element coincidente en el árbol del documento o null si no lo encuentra. Los ID deben ser únicos; si hay duplicados, devuelve el primero según el orden del árbol. Busca el elemento después de insertarlo y comprueba el resultado antes de leer sus propiedades: leer una propiedad de null provoca un TypeError.
document.hidden es un booleano de solo lectura, equivalente a document.visibilityState === "hidden". El estado del documento es "hidden" o "visible" y puede cambiar, por ejemplo, al cambiar de pestaña. No indica si un elemento concreto está en el área visible ni si la página tiene el foco. HTMLElement.hidden se refiere a un solo elemento y no cambia el estado de visibilidad del documento.
El navegador emite visibilitychange en document después del cambio de estado. Es un Event no cancelable que no incluye el nuevo estado; léelo en el documento desde el controlador. Registra el controlador y llámalo una vez para inicializar la interfaz. Al desmontar un componente, elimina el listener del mismo documento con la misma función y el mismo valor de capture.
Pausa el trabajo innecesario mientras el documento esté oculto, pero no uses ese estado como prueba de que se ha abandonado la página, de la atención del usuario ni de que exista una autorización. Estas API son de la plataforma web, no de ECMAScript 2024. Un entorno sin DOM de navegador puede no ofrecer document, y la compatibilidad depende del entorno de ejecución.
Ejemplos
(() => {
function mount(document) {
const id = "cktis-page-visibility-status";
const status = document.createElement("p");
status.id = id;
document.body.append(status);
function render(event) {
const element = document.getElementById(id);
if (element === null) return;
element.textContent = document.hidden ? "hidden" : "visible";
if (event) console.log(element.textContent);
}
document.addEventListener("visibilitychange", render);
render();
console.log("ready");
}
if (typeof document !== "undefined") {
mount(document);
return;
}
// Node.js fixture: model only the document operations used above.
class TestDocument extends EventTarget {
#elements = [];
#hidden = false;
body = { append: (element) => this.#elements.push(element) };
createElement(tagName) {
return { tagName, id: "", textContent: "" };
}
getElementById(id) {
return this.#elements.find((element) => element.id === id) ?? null;
}
get hidden() {
return this.#hidden;
}
setHidden(hidden) {
if (this.#hidden === hidden) return;
this.#hidden = hidden;
this.dispatchEvent(new Event("visibilitychange"));
}
}
const testDocument = new TestDocument();
mount(testDocument);
testDocument.setHidden(true);
testDocument.setHidden(false);
})();Resultado
ready hidden visible
Pega el código una vez en la consola de una pestaña nueva y activa con `about:blank`. Comprueba que aparece `ready`, cambia de pestaña, espera un instante y vuelve. Si el navegador notifica ambas transiciones, la consola mostrará `hidden` y después `visible`, y el párrafo volverá a mostrar `visible`. Recarga la pestaña para reiniciar el ejemplo. Para comprobar el controlador en Node.js, guarda el código como `main.js` y ejecuta `node main.js`; un documento de prueba simula ambas transiciones.
Lecciones relacionadas
- JavaScript · Lección 13 · Avanzado · Versión: 4