Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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