CKTIS / JavaScript
Window — der Dokumentkontext im Browser
Window stellt einer Seite Browser-Schnittstellen für Pixelinformationen, Beziehungen zwischen Fenstern sowie Größenänderungs- und Navigationsereignisse bereit. Erfahre, wie sich Window und WindowProxy unterscheiden und warum der Zugriff zwischen verschiedenen Origins eingeschränkt bleibt.
Version: 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 ist das globale Objekt eines Browserdokuments und kein Teil von ECMAScript. Der Zugriff über window läuft über einen WindowProxy, der Operationen an das aktuelle Window weiterleitet. In Workern sind diese Schnittstellen nicht als window verfügbar; Node 24 im Repository belegt keine Browserunterstützung.
Window.self (window.self) verweist auf denselben WindowProxy wie window. Window.parent verweist auf das übergeordnete Fenster eines Frames, bei einem Dokument auf oberster Ebene auf das Fenster selbst. Diese Referenz erlaubt nicht, das DOM des Elternfensters zu lesen: Der Zugriff zwischen verschiedenen Origins ist eingeschränkt. Window.origin liefert den serialisierten Origin der globalen Umgebung, meist Schema, Host und optionalen Port. Ein opaker Origin ergibt den String "null", nicht den Wert null. Das ist weder eine vollständige URL noch ein Authentifizierungsgeheimnis.
Window.devicePixelRatio ist das Verhältnis der Größe eines CSS-Pixels zur Größe eines Gerätepixels, etwa zum Skalieren einer Canvas-Bitmap. Geh weder von 1 noch von einer Ganzzahl aus: Der Wert hängt von der Anzeigeumgebung und dem Seitenzoom ab. Die Details stehen in CSSOM View, nicht in ECMAScript.
Window.resize, Window.popstate und Window.hashchange sind Ereignisse, keine Methoden. Nutze addEventListener; die Handler-Eigenschaften lauten onresize, onpopstate und onhashchange. resize meldet eine Größenänderung des Viewports. popstate begleitet bestimmte Wechsel des aktiven Verlaufseintrags, etwa beim Vor- und Zurückgehen; event.state liefert dessen Zustand. hashchange meldet einen Wechsel des URL-Fragments und liefert oldURL und newURL. history.pushState() und history.replaceState() lösen selbst keines der beiden Navigationsereignisse aus, auch bei einem Fragmentwechsel.
Das Beispiel prüft self und drei Listener-Registrierungen deterministisch. Ein synthetisches Event ändert weder Fenstergröße noch URL oder Verlauf und hat keine speziellen Felder von PopStateEvent oder HashChangeEvent. isTrusted ist false; echte Navigation wird nicht getestet.
Beispiele
(() => {
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));
}
})();Ergebnis
self: true resize: false popstate: false hashchange: false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- 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