Window

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Das Window-Interface repräsentiert ein Fenster, das ein DOM-Dokument enthält; die document-Eigenschaft verweist auf das im Fenster geladene DOM-Dokument.

Ein Fenster für ein bestimmtes Dokument kann mithilfe der document.defaultView-Eigenschaft abgerufen werden.

Eine globale Variable, window, die das Fenster repräsentiert, in dem das Skript ausgeführt wird, wird JavaScript-Code zur Verfügung gestellt.

Das Window-Interface beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächen-Fensters in Verbindung stehen. Dennoch ist das Window-Interface ein geeigneter Ort, um diese Elemente zu inkludieren, die global verfügbar sein müssen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.

In einem Browser mit Registerkarten wird jede Registerkarte durch ein eigenes Window-Objekt repräsentiert; das globale window, das vom JavaScript-Code innerhalb einer gegebenen Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Dennoch gibt es selbst in einem Browser mit Registerkarten einige Eigenschaften und Methoden, die auf das gesamte Fenster, das die Registerkarte enthält, angewendet werden, wie z. B. resizeTo() und innerHeight. Im Allgemeinen gilt: Alles, was sich nicht sinnvoll auf eine Registerkarte beziehen lässt, bezieht sich stattdessen auf das Fenster.

EventTarget Window

Instanzeigenschaften

Dieses Interface erbt Eigenschaften von der EventTarget-Schnittstelle.

Beachten Sie, dass Eigenschaften, die Objekte sind (z. B. zum Überschreiben des Prototyps von eingebauten Elementen), in einem separaten Abschnitt unten aufgeführt sind.

Window.caches Schreibgeschützt Sicherer Kontext

Gibt das CacheStorage-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Assets zur Offline-Verwendung und das Erzeugen benutzerdefinierter Antworten auf Anfragen.

Window.clientInformation Schreibgeschützt

Ein Alias für Window.navigator.

Window.closed Schreibgeschützt

Diese Eigenschaft zeigt an, ob das aktuelle Fenster geschlossen ist oder nicht.

Window.cookieStore Schreibgeschützt Sicherer Kontext

Gibt eine Referenz auf das CookieStore-Objekt für den aktuellen Dokumentkontext zurück.

Window.credentialless Schreibgeschützt Experimentell

Gibt einen Boolean-Wert zurück, der angibt, ob das aktuelle Dokument in einem credentialless <iframe> geladen wurde. Siehe IFrame credentialless für weitere Details.

Window.crossOriginIsolated Schreibgeschützt

Gibt einen Boolean-Wert zurück, der angibt, ob die Website in einem State der Cross-Origin-Isolation ist.

Window.crypto Schreibgeschützt

Gibt das Crypto-Objekt zurück, das mit dem globalen Objekt verbunden ist.

Window.customElements Schreibgeschützt

Gibt eine Referenz auf das CustomElementRegistry-Objekt zurück, das zur Registrierung neuer benutzerdefinierter Elemente und zum Abrufen von Informationen über bereits registrierte benutzerdefinierte Elemente verwendet werden kann.

Window.devicePixelRatio Schreibgeschützt

Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln im aktuellen Display zurück.

Window.document Schreibgeschützt

Gibt eine Referenz auf das Dokument zurück, das das Fenster enthält.

Window.documentPictureInPicture Schreibgeschützt Experimentell Sicherer Kontext

Gibt eine Referenz auf das Document Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.

Window.fence Schreibgeschützt Experimentell

Gibt eine Fence-Objektinstanz für den aktuellen Dokumentkontext zurück. Nur für Dokumente verfügbar, die in ein <fencedframe> eingebettet sind.

Window.frameElement Schreibgeschützt

Gibt das Element zurück, in dem das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.

Window.frames Schreibgeschützt

Gibt ein Array der Unterfenster im aktuellen Fenster zurück.

Window.fullScreen Nicht standardisiert

Diese Eigenschaft gibt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.

Window.history Schreibgeschützt

Gibt eine Referenz auf das Verlauf-Objekt zurück.

Window.indexedDB Schreibgeschützt

Bietet eine Mechanismus für Anwendungen, um asynchron auf Fähigkeiten von indizierten Datenbanken zuzugreifen; gibt ein IDBFactory-Objekt zurück.

Window.innerHeight Schreibgeschützt

Erhält die Höhe des Inhaltsbereichs des Browserfensters einschließlich, falls gerendert, des horizontalen Rollbalkens.

Window.innerWidth Schreibgeschützt

Erhält die Breite des Inhaltsbereichs des Browserfensters einschließlich, falls gerendert, des vertikalen Rollbalkens.

Window.isSecureContext Schreibgeschützt

Gibt einen Boolean zurück, der angibt, ob der aktuelle Kontext sicher (true) ist oder nicht (false).

Window.launchQueue Schreibgeschützt Experimentell

Wenn eine Progressive Web App (PWA) mit einem launch_handler-client_mode-Wert von focus-existing, navigate-new oder navigate-existing gestartet wird, bietet die launchQueue Zugriff auf die LaunchQueue-Klasse, die es ermöglicht, für die PWA angepasste Start-Navigationsbehandlung zu implementieren.

Window.length Schreibgeschützt

Gibt die Anzahl der Frames im Fenster zurück. Siehe auch window.frames.

Window.localStorage Schreibgeschützt

Gibt eine Referenz auf das lokale Speicherobjekt zurück, das zum Speichern von Daten verwendet wird, die nur von der Herkunft abgerufen werden können, die es erstellt hat.

Window.location

Ruft den Speicherort oder die aktuelle URL des Fensterobjekts ab bzw. setzt diesen.

Window.locationbar Schreibgeschützt

Gibt das Locationbar-Objekt zurück.

Window.menubar Schreibgeschützt

Gibt das Menubar-Objekt zurück.

Window.mozInnerScreenX Schreibgeschützt Nicht standardisiert

Gibt die horizontale (X) Koordinate der oberen linken Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor, um dies bei Bedarf auf Bildschirm-Pixel anzupassen.

Window.mozInnerScreenY Schreibgeschützt Nicht standardisiert

Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel für einen Umrechnungsfaktor, um dies bei Bedarf auf Bildschirm-Pixel anzupassen.

Window.name

Ruft den Namen des Fensters ab bzw. setzt diesen.

Window.navigation Schreibgeschützt Experimentell

Gibt das mit dem aktuellen window assoziierte Navigation-Objekt zurück. Der Einstiegspunkt für die Navigation API.

Window.navigator Schreibgeschützt

Gibt eine Referenz auf das Navigator-Objekt zurück.

Window.opener

Gibt eine Referenz auf das Fenster zurück, das dieses aktuelle Fenster geöffnet hat.

Window.origin Schreibgeschützt

Gibt den Ursprung des globalen Objekts zurück, als Zeichenfolge serialisiert.

Window.originAgentCluster Schreibgeschützt

Gibt true zurück, wenn dieses Fenster zu einem nach Ursprung gruppierten Agenten-Cluster gehört.

Window.outerHeight Schreibgeschützt

Erhält die Höhe der Außenseite des Browserfensters.

Window.outerWidth Schreibgeschützt

Erhält die Breite der Außenseite des Browserfensters.

Window.pageXOffset Schreibgeschützt

Ein Alias für window.scrollX.

Window.pageYOffset Schreibgeschützt

Ein Alias für window.scrollY.

Window.parent Schreibgeschützt

Gibt eine Referenz auf das übergeordnete Fenster oder Unterrahmen des aktuellen Fensters zurück.

Window.performance Schreibgeschützt

Gibt ein Performance-Objekt zurück, das die timing- und navigation-Attribute enthält, die jeweils ein Objekt mit leistungsbezogenen Daten sind. Siehe auch Using Navigation Timing für zusätzliche Informationen und Beispiele.

Window.personalbar Schreibgeschützt

Gibt das Personalbar-Objekt zurück.

Window.scheduler Schreibgeschützt

Gibt das Scheduler-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dies ist der Einstiegspunkt für die Nutzung der Prioritized Task Scheduling API.

Window.screen Schreibgeschützt

Gibt eine Referenz auf das mit dem Fenster verbundene Bildschirmobjekt zurück.

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Browser-Viewports des Nutzers zur linken Seite des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Browser-Viewports des Nutzers zur oberen Seite des Bildschirms zurück.

Window.scrollbars Schreibgeschützt

Gibt das Scrollbars-Objekt zurück.

Window.scrollMaxX Nicht standardisiert Schreibgeschützt

Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus der Viewport-Breite.

Window.scrollMaxY Nicht standardisiert Schreibgeschützt

Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus der Viewport-Höhe).

Window.scrollX Schreibgeschützt

Gibt die Anzahl der Pixel zurück, die das Dokument bereits horizontal gescrollt wurde.

Window.scrollY Schreibgeschützt

Gibt die Anzahl der Pixel zurück, die das Dokument bereits vertikal gescrollt wurde.

Window.self Schreibgeschützt

Gibt eine Objektreferenz auf das Fensterobjekt selbst zurück.

Window.sessionStorage

Gibt eine Referenz auf das Sitzungsspeicherobjekt zurück, das zum Speichern von Daten verwendet wird, die nur von der Herkunft abgerufen werden können, die es erstellt hat.

Window.sharedStorage Schreibgeschützt Experimentell Sicherer Kontext

Gibt das WindowSharedStorage-Objekt für die aktuelle Herkunft zurück. Dies ist der Haupteinstiegspunkt, um Daten mithilfe der Shared Storage API in einen geteilten Speicher zu schreiben.

Window.speechSynthesis Schreibgeschützt

Gibt ein SpeechSynthesis-Objekt zurück, das den Einstiegspunkt für die Verwendung der Web Speech API-Sprachsynthesefunktionalität darstellt.

Window.statusbar Schreibgeschützt

Gibt das Statusleiste-Objekt zurück.

Window.toolbar Schreibgeschützt

Gibt das Toolbar-Objekt zurück.

Window.top Schreibgeschützt

Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.

Window.trustedTypes Schreibgeschützt

Gibt das TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verbunden ist, und liefert den Einstiegspunkt für die Verwendung der Trusted Types API.

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport-Objekt zurück, das den visuellen Viewport für ein gegebenes Fenster repräsentiert.

Window.window Schreibgeschützt

Gibt eine Referenz auf das aktuelle Fenster zurück.

window[0], window[1] usw.

Gibt eine Referenz auf das window-Objekt in den Frames zurück. Siehe Window.frames für weitere Details.

Veraltete Eigenschaften

Window.event Veraltet Schreibgeschützt

Gibt das aktuelle Ereignis zurück, das das Ereignis ist, das gerade vom JavaScript-Code-Kontext verarbeitet wird, oder undefined, wenn momentan kein Ereignis verarbeitet wird. Das Event-Objekt, das direkt an Ereignishandler übergeben wird, sollte wann immer möglich stattdessen verwendet werden.

Window.external Veraltet Schreibgeschützt

Gibt ein Objekt mit Funktionen zum Hinzufügen externer Suchanbieter zum Browser zurück.

Window.orientation Veraltet Schreibgeschützt

Gibt die Orientierung in Grad (in 90-Grad-Schritten) des Viewports relativ zur natürlichen Orientierung des Geräts zurück.

Window.status Veraltet

Ruft den Text in der Statusleiste am unteren Rand des Browsers ab bzw. setzt diesen.

Instanzmethoden

Dieses Interface erbt Methoden von der EventTarget-Schnittstelle.

Window.atob()

Dekodiert einen String, der mit Base-64-Codierung kodiert wurde.

Window.alert()

Zeigt ein Dialogfeld mit einer Warnung an.

Window.blur() Veraltet

Entfernt den Fokus vom Fenster.

Window.btoa()

Erstellt einen Base-64-codierten ASCII-String aus einem String binärer Daten.

Window.cancelAnimationFrame()

Ermöglicht das Abbrechen eines zuvor mit Window.requestAnimationFrame geplanten Rückrufs.

Window.cancelIdleCallback()

Ermöglicht das Abbrechen eines zuvor mit Window.requestIdleCallback geplanten Rückrufs.

Window.clearInterval()

Bricht die wiederholte Ausführung ab, die mit Window.setInterval() festgelegt wurde.

Window.clearTimeout()

Bricht die verzögerte Ausführung ab, die mit Window.setTimeout() festgelegt wurde.

Window.close()

Schließt das aktuelle Fenster.

Window.confirm()

Zeigt ein Dialogfeld mit einer Nachricht an, auf die der Benutzer antworten muss.

Window.createImageBitmap()

Akzeptiert verschiedene Bildquellen und gibt eine Promise zurück, die auf ein ImageBitmap aufgelöst wird. Optional wird die Quelle auf das rechteckige Pixelstück, das an (sx, sy) mit der Breite sw und der Höhe sh beginnt, zugeschnitten.

Window.dump() Nicht standardisiert

Schreibt eine Nachricht in die Konsole.

Window.fetch()

Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.

Window.find() Nicht standardisiert

Sucht nach einem angegebenen String in einem Fenster.

Window.focus()

Setzt den Fokus auf das aktuelle Fenster.

Window.getComputedStyle()

Ruft den berechneten Stil für das angegebene Element ab. Der berechnete Stil gibt die berechneten Werte aller CSS-Eigenschaften des Elements an.

Window.getDefaultComputedStyle() Nicht standardisiert

Ruft den standardmäßig berechneten Stil für das angegebene Element ab und ignoriert dabei die Autoren-Stylesheets.

Window.getScreenDetails() Experimentell Sicherer Kontext

Gibt eine Promise zurück, die mit einem ScreenDetails-Objektinstanz erfüllt wird, das die Details aller Bildschirme darstellt, die dem Gerät des Nutzers zur Verfügung stehen.

Window.getSelection()

Gibt das Selektionsobjekt, das die ausgewählten Elemente repräsentiert, zurück.

Window.matchMedia()

Gibt ein MediaQueryList-Objekt zurück, das die angegebene Mediaquery-Zeichenfolge repräsentiert.

Window.moveBy()

Bewegt das aktuelle Fenster um einen angegebenen Betrag.

Window.moveTo()

Bewegt das Fenster zu den angegebenen Koordinaten.

Window.open()

Öffnet ein neues Fenster.

Window.postMessage()

Bietet eine sichere Möglichkeit, dass ein Fenster einem anderen Fenster eine Zeichenfolge von Daten sendet, die sich nicht im selben Domainbereich befinden muss wie das erste.

Window.print()

Öffnet das Druckdialogfeld, um das aktuelle Dokument zu drucken.

Window.prompt()

Gibt den vom Benutzer in einem Eingabedialogfeld eingegebenen Text zurück.

Window.queryLocalFonts() Experimentell Sicherer Kontext

Gibt eine Promise zurück, die mit einem Array von FontData-Objekten erfüllt wird, die die lokal verfügbaren Schriftarten darstellen.

Window.queueMicrotask()

Fügt eine Mikrotask-Warteschlange hinzu, die zu einem sicheren Zeitpunkt vor der Rückkehr der Steuerung zur Ereignisschleife des Browsers ausgeführt wird.

Window.reportError()

Meldet einen Fehler in einem Skript und emuliert eine nicht behandelbare Ausnahme.

Window.requestAnimationFrame()

Teilt dem Browser mit, dass eine Animation im Gange ist, und fordert den Browser auf, einen Neuaufbau des Fensters für den nächsten Animationsrahmen zu planen.

Window.requestIdleCallback()

Ermöglicht die Planung von Aufgaben während der Leerlaufzeiten eines Browsers.

Window.resizeBy()

Ändert die Größe des aktuellen Fensters um einen bestimmten Betrag.

Window.resizeTo()

Ändert die Größe des Fensters dynamisch.

Window.scroll()

Scrollt das Fenster an eine bestimmte Stelle im Dokument.

Window.scrollBy()

Scrollt das Dokument im Fenster um den angegebenen Betrag.

Window.scrollByLines() Nicht standardisiert

Scrollt das Dokument um die angegebene Anzahl von Zeilen.

Window.scrollByPages() Nicht standardisiert

Scrollt das aktuelle Dokument um die angegebene Anzahl von Seiten.

Window.scrollTo()

Scrollt zu einem bestimmten Satz von Koordinaten im Dokument.

Window.setInterval()

Plant eine Funktion, die jedes Mal ausgeführt wird, wenn eine gegebene Anzahl von Millisekunden verstreicht.

Window.setTimeout()

Plant eine Funktion, die nach einer bestimmten Zeitspanne ausgeführt wird.

Window.showDirectoryPicker() Experimentell Sicherer Kontext

Zeigt einen Verzeichnis-Picker an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.

Window.showOpenFilePicker() Experimentell Sicherer Kontext

Zeigt einen Dateiauswahl-Dialog an, der es dem Benutzer ermöglicht, eine Datei oder mehrere Dateien auszuwählen.

Window.showSaveFilePicker() Experimentell Sicherer Kontext

Zeigt einen Dialog zum Speichern von Dateien an, der es dem Benutzer ermöglicht, eine Datei zu speichern.

Window.sizeToContent() Nicht standardisiert

Passt das Fenster an seine Inhalte an.

Window.stop()

Diese Methode stoppt das Laden des Fensters.

Window.structuredClone()

Erstellt eine tiefe Kopie eines gegebenen Wertes mithilfe des strukturierten Klonalen Algorithmus.

Veraltete Methoden

Window.captureEvents() Veraltet

Registriert das Fenster zum Abfangen aller Ereignisse des angegebenen Typs.

Window.clearImmediate() Nicht standardisiert Veraltet

Bricht die wiederholte Ausführung ab, die mit setImmediate() festgelegt wurde.

Window.releaseEvents() Veraltet

Löst das Fenster aus der Erfassung von Ereignissen eines bestimmten Typs.

Window.requestFileSystem() Nicht standardisiert Veraltet

Ermöglicht es einer Website oder App, Zugriff auf ein sandboxed Dateisystem für ihren eigenen Gebrauch zu erhalten.

Window.setImmediate() Nicht standardisiert Veraltet

Führt eine Funktion aus, nachdem der Browser andere schwere Aufgaben abgeschlossen hat.

Window.setResizable() Nicht standardisiert Veraltet

Tut nichts (no-op). Wird aus Gründen der Abwärtskompatibilität mit Netscape 4.x beibehalten.

Window.showModalDialog() Nicht standardisiert Veraltet

Zeigt einen modalen Dialog an.

Window.webkitConvertPointFromNodeToPage() Nicht standardisiert Veraltet

Transformiert einen WebKitPoint vom Koordinatensystem des Knotens in das der Seite.

Window.webkitConvertPointFromPageToNode() Nicht standardisiert Veraltet

Transformiert einen WebKitPoint vom Koordinatensystem der Seite in das des Knotens.

Ereignisse

Hören Sie diese Ereignisse mit addEventListener() oder durch Zuordnung eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces ab. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse, die aus dem Document im Fensterobjekt stammen, blubbern.

error

Wird ausgelöst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann. Zum Beispiel, wenn ein Skript einen Ausführungsfehler hat oder ein Bild nicht gefunden werden kann oder ungültig ist.

languagechange

Wird im globalen Gültigkeitsbereich-Objekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.

resize

Wird ausgelöst, wenn das Fenster in der Größe verändert wurde.

storage

Wird ausgelöst, wenn ein Speicherbereich (localStorage oder sessionStorage) im Kontext eines anderen Dokuments verändert wurde.

Zwischenablage-Ereignisse

copy

Wird ausgelöst, wenn der Benutzer eine Kopier-Aktion über die Benutzeroberfläche des Browsers initiiert. Auch über die oncopy-Eigenschaft verfügbar.

cut

Wird ausgelöst, wenn der Benutzer eine Ausschneide-Aktion über die Benutzeroberfläche des Browsers initiiert. Auch über die oncut-Eigenschaft verfügbar.

paste

Wird ausgelöst, wenn der Benutzer eine Einfüge-Aktion über die Benutzeroberfläche des Browsers initiiert. Auch über die onpaste-Eigenschaft verfügbar.

Verbindungsereignisse

offline

Wird ausgelöst, wenn der Browser den Zugriff auf das Netzwerk verloren hat und der Wert von navigator.onLine auf false gewechselt ist.

online

Wird ausgelöst, wenn der Browser den Zugriff auf das Netzwerk erlangt hat und der Wert von navigator.onLine auf true gewechselt ist.

Geräteorientierungsereignisse

devicemotion Sicherer Kontext

Wird in regelmäßigen Abständen ausgelöst und zeigt die Menge der physischen Beschleunigungsstärke, die das Gerät erhält, und die Drehgeschwindigkeit an, wenn verfügbar.

deviceorientation Sicherer Kontext

Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen Orientierung des Geräts im Vergleich zum Erd-Koordinatenrahmen verfügbar sind.

deviceorientationabsolute Sicherer Kontext

Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen absoluten Orientierung des Geräts im Vergleich zum Erd-Koordinatenrahmen verfügbar sind.

Fokusereignisse

blur

Wird ausgelöst, wenn ein Element den Fokus verloren hat.

focus

Wird ausgelöst, wenn ein Element den Fokus erlangt hat.

Gamepad-Ereignisse

gamepadconnected

Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder das erste Mal eine Taste/ein Achse des Gamepads verwendet wird.

gamepaddisconnected

Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.

Verlaufsereignisse

hashchange

Wird ausgelöst, wenn sich der Fragmentbezeichner der URL geändert hat (der Teil der URL, der mit dem #-Symbol beginnt und folgt).

pagehide

Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während ein anderes Dokument aus dem Verlaufsverlauf der Sitzung geladen wird. Dies geschieht beispielsweise, wenn der Benutzer die Zurück-Taste klickt oder wenn er die Vorwärts-Taste klickt, um im Sitzungsgeschichtsverlauf voranzukommen.

pagereveal

Wird ausgelöst, wenn ein Dokument erstmals gerendert wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder bei der Aktivierung eines Dokuments (entweder aus dem back/forward cache (bfcache) oder prerender).

pageshow

Wird gesendet, wenn der Browser das Dokument aufgrund von Navigationsaufgaben sichtbar macht, einschließlich nicht nur, wenn die Seite erstmals geladen wird, sondern auch in Situationen, in denen der Benutzer nach dem Navigieren zu einer anderen Seite im selben Tab zur vorherigen Seite zurückkehrt.

pageswap

Wird ausgelöst, wenn ein Dokument kurz vor dem Entladen aufgrund einer Navigation steht.

popstate

Wird ausgelöst, wenn sich der aktive Verlaufseintrag ändert.

Lade- und Entlade-Ereignisse

beforeunload

Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen kurz vor dem Entladen stehen.

load

Wird ausgelöst, wenn die gesamte Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets-Bilder.

unload Veraltet

Wird ausgelöst, wenn das Dokument oder eine Kindressource entladen wird.

Manifest-Ereignisse

appinstalled

Wird ausgelöst, wenn der Browser eine Seite erfolgreich als Anwendung installiert hat.

beforeinstallprompt

Wird ausgelöst, wenn ein Benutzer kurz davor steht, aufgefordert zu werden, eine Webanwendung zu installieren.

Messaging-Ereignisse

message

Wird ausgelöst, wenn das Fenster eine Nachricht erhält, beispielsweise durch einen Aufruf von Window.postMessage() aus einem anderen Durchsuchungskontext.

messageerror

Wird ausgelöst, wenn ein Window-Objekt eine Nachricht erhält, die nicht deserialisiert werden kann.

Druckereignisse

afterprint

Wird ausgelöst, nachdem das zugehörige Dokument begonnen hat zu drucken oder die Druckvorschau geschlossen wurde.

beforeprint

Wird ausgelöst, wenn das zugehörige Dokument kurz vor dem Drucken oder der Vorschau gedruckt wird.

Promise-Abgelehnte Ereignisse

rejectionhandled

Wird jedes Mal gesendet, wenn ein JavaScript Promise abgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, um die Ablehnung zu erfassen oder nicht.

unhandledrejection

Wird gesendet, wenn ein JavaScript Promise abgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung zu erfassen.

Scrollereignisse

scrollsnapchange Experimentell

Wird am Scroll-Container am Ende eines Scroll-Vorgangs ausgelöst, wenn ein neues Scrollsnap-Ziel ausgewählt wurde.

scrollsnapchanging Experimentell

Wird am Scroll-Container ausgelöst, wenn der Browser bestimmt, dass ein neues Scrollsnap-Ziel bevorsteht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.

Veraltete Ereignisse

orientationchange Veraltet

Wird ausgelöst, wenn sich die Orientierung des Geräts geändert hat.

vrdisplayactivate Veraltet Nicht standardisiert

Wird ausgelöst, wenn ein Display präsentiert werden kann.

vrdisplayconnect Veraltet Nicht standardisiert

Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.

vrdisplaydisconnect Veraltet Nicht standardisiert

Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.

vrdisplaydeactivate Veraltet Nicht standardisiert

Wird ausgelöst, wenn ein Display nicht mehr präsentiert werden kann.

vrdisplaypresentchange Veraltet Nicht standardisiert

Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert — d.h. vom Präsentieren zum Nicht-Präsentieren oder umgekehrt.

Gebubbelte Ereignisse

Schnittstellen

Ereignisse im Fenster lauschen

HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu lauschen:

  • Fügen Sie dem Element mit der Methode EventTarget.addEventListener einen Ereignis-Listener hinzu.
  • Weisen Sie dem oneventname-Eigenschaft des Elements in JavaScript einen Ereignis-Handler zu.
  • Fügen Sie dem Element im HTML ein Prefix-Attribut on hinzu.

Um Ereignissen auf Window-Objekten zu lauschen, können in der Regel nur die ersten beiden Methoden verwendet werden, da es kein entsprechendes HTML-Element für Window gibt. Es gibt jedoch eine spezifische Gruppe von Ereignissen, deren Listener dem <body> (oder dem veralteten <frameset>) Element hinzugefügt werden können, das dem Dokument des Window gehört, indem die zweite oder dritte Methode verwendet wird. Diese Ereignisse sind:

  • afterprint
  • beforeprint
  • beforeunload
  • blur
  • error
  • focus
  • hashchange
  • languagechange
  • load
  • message
  • messageerror
  • offline
  • online
  • pagehide
  • pagereveal
  • pageshow
  • pageswap
  • popstate
  • rejectionhandled
  • resize
  • scroll
  • storage
  • unhandledrejection
  • unload

Das bedeutet, dass die folgenden strikt gleichwertig sind:

js
window.onresize = (e) => console.log(e.currentTarget);
document.body.onresize = (e) => console.log(e.currentTarget);
html
<body onresize="console.log(event.currentTarget)"></body>

In allen drei Fällen sehen Sie das Window-Objekt, das als currentTarget protokolliert wird.

Spezifikationen

Specification
HTML
# the-window-object

Browser-Kompatibilität