CKTIS / JavaScript
Window — el contexto del documento en el navegador
Window ofrece a la página interfaces del navegador para consultar información sobre píxeles, relacionar ventanas y escuchar eventos de tamaño y navegación. Descubre en qué se diferencian Window y WindowProxy y por qué se restringe el acceso entre orígenes.
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
window.devicePixelRatio; window.self; window.parent; window.origin; window.addEventListener("resize", handler); window.addEventListener("popstate", handler); window.addEventListener("hashchange", handler);Window es el objeto global de un documento del navegador, no parte de ECMAScript. El acceso mediante window pasa por un WindowProxy que transmite las operaciones al Window actual. Estas interfaces no están disponibles como window en los workers; tener Node 24 en un repositorio no demuestra compatibilidad con el navegador.
Window.self (window.self) apunta al mismo WindowProxy que window. Window.parent apunta a la ventana padre del marco o a sí misma en un documento de nivel superior. Esa referencia no autoriza a leer el DOM del padre: el acceso entre orígenes está restringido. Window.origin devuelve el origen serializado del entorno global: normalmente esquema, host y puerto opcional. Un origen opaco da la cadena "null", no el valor null. No es una URL completa ni un secreto de autenticación.
Window.devicePixelRatio es la relación entre el tamaño de un píxel CSS y el de uno del dispositivo, útil para escalar un mapa de bits de canvas. No des por hecho que vale 1 o que es un entero: depende del entorno de visualización y del zoom de la página. CSSOM View, no ECMAScript, especifica sus detalles.
Window.resize, Window.popstate y Window.hashchange nombran eventos, no métodos. Usa addEventListener; las propiedades de gestión son onresize, onpopstate y onhashchange. resize indica un cambio de tamaño del área visible. popstate acompaña ciertos cambios de entrada activa del historial, como al retroceder o avanzar; event.state da su estado. hashchange indica un cambio de fragmento de URL y ofrece oldURL y newURL. history.pushState() y history.replaceState() no emiten por sí solos ninguno de esos dos eventos de navegación, aunque cambien el fragmento.
El ejemplo comprueba de forma determinista self y el registro de tres escuchas. Un Event sintético no cambia el tamaño de la ventana, la URL ni el historial, y carece de los campos propios de PopStateEvent o HashChangeEvent. isTrusted vale false; no se prueba la navegación real.
Ejemplos
(() => {
console.log(`self: ${window.self === window}`);
for (const type of ["resize", "popstate", "hashchange"]) {
window.addEventListener(type, (event) => {
console.log(`${event.type}: ${event.isTrusted}`);
}, { once: true });
window.dispatchEvent(new Event(type));
}
})();Resultado
self: true resize: false popstate: false hashchange: false
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
- HTML Standard
- HTML Standard — APIs related to navigation and session history
- HTML Standard — Web application APIs
- HTML Standard — Loading web pages
- HTML Standard — Images
- HTML Standard — Browsers
- Official reference — developer.mozilla.org: Window / devicePixelRatio
- Official reference — developer.mozilla.org: Window / resize_event
- Official reference — developer.mozilla.org: Window / popstate_event
- Official reference — developer.mozilla.org: API / Window