CKTIS / JavaScript
Window — kontext dokumentu v prohlížeči
Window zpřístupňuje stránce rozhraní prohlížeče pro informace o pixelech, vztahy mezi okny a události změny velikosti a navigace. Zjisti, jak se liší Window od WindowProxy a proč je přístup mezi různými originy omezený.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
window.devicePixelRatio; window.self; window.parent; window.origin; window.addEventListener("resize", handler); window.addEventListener("popstate", handler); window.addEventListener("hashchange", handler);Window je globální objekt dokumentu v prohlížeči, nikoli součást ECMAScriptu. Přístup přes window využívá WindowProxy, který předává operace aktuálnímu Window. Ve workerech tato rozhraní nejsou dostupná jako window; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížeči.
Window.self (window.self) odkazuje na stejný WindowProxy jako window. Window.parent odkazuje na nadřazené okno rámce, u dokumentu nejvyšší úrovně na okno samotné. Získání odkazu na nadřazené okno neopravňuje ke čtení jeho DOM: přístup mezi různými originy je omezený. Window.origin vrací serializovaný origin globálního prostředí, obvykle schéma, hostitele a volitelný port. Neprůhledný origin dává řetězec "null", ne hodnotu null. Nejde o úplnou URL ani o autentizační tajemství.
Window.devicePixelRatio je poměr velikosti pixelu CSS k velikosti pixelu zařízení, užitečný třeba při změně měřítka bitmapy canvasu. Nepředpokládej 1 ani celé číslo: výsledek závisí na prostředí zobrazení a přiblížení stránky. Podrobnosti určuje CSSOM View, nikoli ECMAScript.
Window.resize, Window.popstate a Window.hashchange označují události, ne metody. Použij addEventListener; odpovídající vlastnosti obsluhy jsou onresize, onpopstate a onhashchange. resize hlásí změnu velikosti oblasti zobrazení. popstate doprovází některé změny aktivní položky historie, třeba při přechodu Zpět/Vpřed; event.state poskytuje její stav. hashchange hlásí změnu fragmentu URL a poskytuje oldURL a newURL. Samotná volání history.pushState() a history.replaceState() nevyvolají žádnou z těchto dvou navigačních událostí, ani když změní fragment.
Příklad deterministicky ověřuje self a registraci tří posluchačů. Syntetický Event nemění velikost okna, URL ani historii a nemá pole specifická pro PopStateEvent nebo HashChangeEvent. isTrusted má hodnotu false; příklad netestuje skutečnou navigaci.
Příklady
(() => {
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));
}
})();Výsledek
self: true resize: false popstate: false hashchange: false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
Zdroje
- 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