CKTIS / JavaScript
Window — kontekst dokumenta v brskalniku
Window strani omogoča uporabo vmesnikov brskalnika za podatke o slikovnih pikah, razmerja med okni ter dogodke ob spremembi velikosti ali navigaciji. Spoznaj razliko med Window in WindowProxy ter zakaj je dostop med različnimi izvori omejen.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
window.devicePixelRatio; window.self; window.parent; window.origin; window.addEventListener("resize", handler); window.addEventListener("popstate", handler); window.addEventListener("hashchange", handler);Window je globalni objekt dokumenta v brskalniku in ni del ECMAScripta. Dostop prek window uporablja WindowProxy, ki operacije posreduje trenutnemu Window. V workerjih ti vmesniki niso na voljo kot window; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku.
Window.self (window.self) kaže na isti WindowProxy kot window. Window.parent kaže na nadrejeno okno okvirja, pri dokumentu na najvišji ravni pa na okno samo. Sklic na nadrejeno okno ne omogoča branja njegovega DOM-a: dostop med različnimi izvori je omejen. Window.origin vrne serializirani izvor globalnega okolja, navadno shemo, gostitelja in po potrebi vrata. Neprosojen izvor vrne niz "null", ne vrednosti null. To ni popoln URL niti skrivnost za overjanje.
Window.devicePixelRatio je razmerje med velikostjo slikovne pike CSS in slikovne pike naprave, uporabno pri skaliranju bitne slike canvasa. Ne predpostavljaj 1 ali celega števila: rezultat je odvisen od okolja prikaza in povečave strani. Podrobnosti določa CSSOM View, ne ECMAScript.
Window.resize, Window.popstate in Window.hashchange so imena dogodkov, ne metod. Uporabi addEventListener; ustrezne lastnosti za obravnavo dogodkov so onresize, onpopstate in onhashchange. resize označi spremembo velikosti vidnega območja. popstate spremlja nekatere spremembe aktivnega vnosa v zgodovini, denimo pri prehodu Nazaj/Naprej; event.state poda njegovo stanje. hashchange označi spremembo fragmenta URL-ja in poda oldURL in newURL. Klica history.pushState() in history.replaceState() sama ne sprožita nobenega od teh dveh navigacijskih dogodkov, tudi če spremenita fragment.
Primer deterministično preveri self in registracijo treh poslušalcev. Sintetični Event ne spremeni velikosti okna, URL-ja ali zgodovine in nima posebnih polj PopStateEvent ali HashChangeEvent. isTrusted ima vrednost false; primer ne preverja dejanske navigacije.
Primeri
(() => {
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));
}
})();Rezultat
self: true resize: false popstate: false hashchange: false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- 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