CKTIS / JavaScript
Window — kontext dokumentu v prehliadači
Window sprístupňuje stránke rozhrania prehliadača pre informácie o pixeloch, vzťahy medzi oknami a udalosti zmeny veľkosti a navigácie. Zisti, ako sa Window líši od WindowProxy a prečo je prístup medzi rôznymi originmi obmedzený.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
window.devicePixelRatio; window.self; window.parent; window.origin; window.addEventListener("resize", handler); window.addEventListener("popstate", handler); window.addEventListener("hashchange", handler);Window je globálny objekt dokumentu v prehliadači, nie súčasť ECMAScriptu. Prístup cez window používa WindowProxy, ktorý odovzdáva operácie aktuálnemu Window. Vo workeroch tieto rozhrania nie sú dostupné ako window; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadači.
Window.self (window.self) odkazuje na ten istý WindowProxy ako window. Window.parent odkazuje na nadradené okno rámca, pri dokumente najvyššej úrovne na samotné okno. Získanie odkazu na nadradené okno neoprávňuje čítať jeho DOM: prístup medzi rôznymi originmi je obmedzený. Window.origin vracia serializovaný origin globálneho prostredia, zvyčajne schému, hostiteľa a voliteľný port. Nepriehľadný origin dáva reťazec "null", nie hodnotu null. Nie je to úplná URL ani autentifikačné tajomstvo.
Window.devicePixelRatio je pomer veľkosti CSS pixela k veľkosti pixela zariadenia, užitočný napríklad pri zmene mierky bitmapy canvasu. Nepredpokladaj 1 ani celé číslo: výsledok závisí od prostredia zobrazenia a priblíženia stránky. Podrobnosti určuje CSSOM View, nie ECMAScript.
Window.resize, Window.popstate a Window.hashchange označujú udalosti, nie metódy. Použi addEventListener; zodpovedajúce vlastnosti obsluhy sú onresize, onpopstate a onhashchange. resize hlási zmenu veľkosti zobrazovacej oblasti. popstate sprevádza niektoré zmeny aktívnej položky histórie, napríklad pri prechode Späť/Vpred; event.state poskytuje jej stav. hashchange hlási zmenu fragmentu URL a poskytuje oldURL a newURL. Samotné volania history.pushState() a history.replaceState() nevyvolajú ani jednu z týchto navigačných udalostí, aj keď zmenia fragment.
Príklad deterministicky overuje self a registráciu troch poslucháčov. Syntetický Event nemení veľkosť okna, URL ani históriu a nemá polia špecifické pre PopStateEvent alebo HashChangeEvent. isTrusted má hodnotu false; príklad netestuje skutočnú navigáciu.
Prí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ýsledok
self: true resize: false popstate: false hashchange: false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
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