Window

Baseline

Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Juli 2015 browserbergreifend verfgbar.

* Einige Teile dieser Funktion werden mglicherweise unterschiedlich gut untersttzt.

Vollstndige Kompatibilitt anzeigen
Mehr erfahren

Die Window-Schnittstelle reprsentiert ein Fenster, das ein DOM-Dokument enthlt. Die Eigenschaft document verweist auf das in diesem Fenster geladene DOM-Dokument.

Das Fenster eines bestimmten Dokuments kann ber die Eigenschaft document.defaultView abgerufen werden.

Die globale Variable window, die das Fenster reprsentiert, in dem das Skript ausgefhrt wird, ist fr JavaScript-Code verfgbar.

Die Window-Schnittstelle enthlt zahlreiche Funktionen, Namespaces, Objekte und Konstruktoren, die nicht unbedingt unmittelbar mit dem Konzept eines Fensters der Benutzeroberflche zusammenhngen. Sie ist jedoch ein geeigneter Ort fr Elemente, die global verfgbar sein mssen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.

In einem Browser mit Tabs wird jeder Tab durch ein eigenes Window-Objekt reprsentiert. Das globale window, auf das JavaScript-Code innerhalb eines Tabs zugreift, reprsentiert stets diesen Tab. Allerdings beziehen sich manche Eigenschaften und Methoden auch in einem Browser mit Tabs weiterhin auf das bergeordnete Fenster, das den Tab enthlt, etwa resizeTo() und innerHeight. Grundstzlich gilt: Was sich nicht sinnvoll auf einen Tab beziehen lsst, bezieht sich stattdessen auf das Fenster.

EventTarget Window

Instanzeigenschaften

Diese Schnittstelle erbt Eigenschaften von der Schnittstelle EventTarget.

Beachten Sie, dass Eigenschaften, die Objekte sind (beispielsweise zum berschreiben des Prototyps integrierter Elemente), weiter unten in einem eigenen Abschnitt aufgefhrt sind.

Window.caches Schreibgeschtzt Sicherer Kontext

Gibt das dem aktuellen Kontext zugeordnete CacheStorage-Objekt zurck. Dieses Objekt ermglicht unter anderem das Speichern von Ressourcen fr die Offline-Nutzung und das Erzeugen benutzerdefinierter Antworten auf Anfragen.

Window.clientInformation Schreibgeschtzt

Ein Alias fr Window.navigator.

Window.closed Schreibgeschtzt

Diese Eigenschaft gibt an, ob das aktuelle Fenster geschlossen ist.

Window.cookieStore Schreibgeschtzt Sicherer Kontext

Gibt eine Referenz auf das CookieStore-Objekt fr den aktuellen Dokumentkontext zurck.

Window.crashReport Schreibgeschtzt Sicherer Kontext

Gibt ein CrashReportContext-Objekt zurck, mit dem beliebige Daten fr den aktuellen Browsing-Kontext der obersten Ebene aufgezeichnet werden knnen. Bei einem Browserabsturz werden diese Daten einem CrashReport hinzugefgt und an einen Reporting-Endpunkt gesendet.

Window.credentialless Schreibgeschtzt

Gibt einen booleschen Wert zurck, der angibt, ob das aktuelle Dokument in einem credentialless <iframe> geladen wurde. Weitere Informationen finden Sie unter IFrame credentialless.

Window.crossOriginIsolated Schreibgeschtzt

Gibt einen booleschen Wert zurck, der angibt, ob sich die Website in einem Zustand der Cross-Origin-Isolation befindet.

Window.crypto Schreibgeschtzt

Gibt das dem globalen Objekt zugeordnete Crypto-Objekt zurck.

Window.customElements Schreibgeschtzt

Gibt eine Referenz auf das CustomElementRegistry-Objekt zurck, mit dem neue benutzerdefinierte Elemente registriert und Informationen ber bereits registrierte benutzerdefinierte Elemente abgerufen werden knnen.

Window.devicePixelRatio Schreibgeschtzt

Gibt das Verhltnis zwischen physischen Pixeln und gerteunabhngigen Pixeln auf dem aktuellen Bildschirm zurck.

Window.document Schreibgeschtzt

Gibt eine Referenz auf das Dokument zurck, das das Fenster enthlt.

Window.documentPictureInPicture Schreibgeschtzt Sicherer Kontext

Gibt eine Referenz auf das Document-Picture-in-Picture-Fenster fr den aktuellen Dokumentkontext zurck.

Window.fence Schreibgeschtzt

Gibt eine Fence-Objektinstanz fr den aktuellen Dokumentkontext zurck. Nur fr Dokumente verfgbar, die in ein <fencedframe> eingebettet sind.

Window.frameElement Schreibgeschtzt

Gibt das Element zurck, in das das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.

Window.frames Schreibgeschtzt

Gibt ein Array der Unterframes im aktuellen Fenster zurck.

Window.fullScreen

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

Window.history Schreibgeschtzt

Gibt eine Referenz auf das Verlaufsobjekt zurck.

Window.indexedDB Schreibgeschtzt

Stellt einen Mechanismus bereit, mit dem Anwendungen asynchron auf die Funktionen indexierter Datenbanken zugreifen knnen; gibt ein IDBFactory-Objekt zurck.

Window.innerHeight Schreibgeschtzt

Gibt die Hhe des Inhaltsbereichs des Browserfensters einschlielich der horizontalen Bildlaufleiste zurck, sofern diese angezeigt wird.

Window.innerWidth Schreibgeschtzt

Gibt die Breite des Inhaltsbereichs des Browserfensters einschlielich der vertikalen Bildlaufleiste zurck, sofern diese angezeigt wird.

Window.isSecureContext Schreibgeschtzt

Gibt einen booleschen Wert zurck, der angibt, ob der aktuelle Kontext sicher (true) ist oder nicht (false).

Window.launchQueue Schreibgeschtzt

Wenn eine Progressive Web App (PWA) mit einem client_mode-Wert von focus-existing, navigate-new oder navigate-existing fr launch_handler gestartet wird, bietet launchQueue Zugriff auf die Klasse LaunchQueue. Damit lsst sich fr die PWA eine benutzerdefinierte Navigation beim Start implementieren.

Window.length Schreibgeschtzt

Gibt die Anzahl der Frames im Fenster zurck. Siehe auch window.frames.

Window.localStorage Schreibgeschtzt

Gibt eine Referenz auf das lokale Speicherobjekt zurck, in dem Daten gespeichert werden, auf die nur die Origin zugreifen kann, die sie erstellt hat.

Window.location

Ruft die Position beziehungsweise die aktuelle URL des Fensterobjekts ab oder legt sie fest.

Window.locationbar Schreibgeschtzt

Gibt das locationbar-Objekt zurck.

Window.menubar Schreibgeschtzt

Gibt das menubar-Objekt zurck.

Window.mozInnerScreenX Schreibgeschtzt

Gibt die horizontale (X-)Koordinate der linken oberen Ecke des Viewports des Fensters in Bildschirmkoordinaten zurck. Dieser Wert wird in CSS-Pixeln angegeben. Einen Umrechnungsfaktor fr Bildschirmpixel finden Sie bei mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils.

Window.mozInnerScreenY Schreibgeschtzt

Gibt die vertikale (Y-)Koordinate der linken oberen Ecke des Viewports des Fensters in Bildschirmkoordinaten zurck. Dieser Wert wird in CSS-Pixeln angegeben. Einen Umrechnungsfaktor fr Bildschirmpixel finden Sie bei mozScreenPixelsPerCSSPixel.

Window.name

Ruft den Namen des Fensters ab oder legt ihn fest.

Window.navigation Schreibgeschtzt

Gibt das dem aktuellen window zugeordnete Navigation-Objekt zurck. Es ist der Einstiegspunkt fr die Navigation API.

Window.navigator Schreibgeschtzt

Gibt eine Referenz auf das navigator-Objekt zurck.

Window.opener

Gibt eine Referenz auf das Fenster zurck, das das aktuelle Fenster geffnet hat.

Window.origin Schreibgeschtzt

Gibt die Origin des globalen Objekts als serialisierten String zurck.

Window.originAgentCluster Schreibgeschtzt

Gibt true zurck, wenn dieses Fenster zu einem Origin-basierten Agent-Cluster gehrt.

Window.outerHeight Schreibgeschtzt

Gibt die Auenhhe des Browserfensters zurck.

Window.outerWidth Schreibgeschtzt

Gibt die Auenbreite des Browserfensters zurck.

Window.pageXOffset Schreibgeschtzt

Ein Alias fr window.scrollX.

Window.pageYOffset Schreibgeschtzt

Ein Alias fr window.scrollY.

Window.parent Schreibgeschtzt

Gibt eine Referenz auf das bergeordnete Fenster des aktuellen Fensters oder Unterframes zurck.

Window.performance Schreibgeschtzt

Gibt ein Performance-Objekt zurck. Es enthlt die Attribute timing und navigation, die jeweils ein Objekt mit leistungsbezogenen Daten bereitstellen. Weitere Informationen und Beispiele finden Sie auch unter Navigation Timing verwenden.

Window.personalbar Schreibgeschtzt

Gibt das personalbar-Objekt zurck.

Window.scheduler Schreibgeschtzt

Gibt das dem aktuellen Kontext zugeordnete Scheduler-Objekt zurck. Es ist der Einstiegspunkt fr die Verwendung der Prioritized Task Scheduling API.

Window.screen Schreibgeschtzt

Gibt eine Referenz auf das dem Fenster zugeordnete screen-Objekt zurck.

Window.screenX und Window.screenLeft Schreibgeschtzt

Beide Eigenschaften geben den horizontalen Abstand zwischen dem linken Rand des Browserfensters und dem linken Bildschirmrand zurck.

Window.screenY und Window.screenTop Schreibgeschtzt

Beide Eigenschaften geben den vertikalen Abstand zwischen dem oberen Rand des Browserfensters und dem oberen Bildschirmrand zurck.

Window.scrollbars Schreibgeschtzt

Gibt das scrollbars-Objekt zurck.

Window.scrollMaxX Schreibgeschtzt

Der maximale horizontale Bildlaufversatz des Fensters, also die Dokumentbreite abzglich der Viewport-Breite.

Window.scrollMaxY Schreibgeschtzt

Der maximale vertikale Bildlaufversatz des Fensters, also die Dokumenthhe abzglich der Viewport-Hhe.

Window.scrollX Schreibgeschtzt

Gibt die Anzahl der Pixel zurck, um die das Dokument bereits horizontal gescrollt wurde.

Window.scrollY Schreibgeschtzt

Gibt die Anzahl der Pixel zurck, um die das Dokument bereits vertikal gescrollt wurde.

Window.self Schreibgeschtzt

Gibt eine Objektreferenz auf das Fensterobjekt selbst zurck.

Window.sessionStorage Schreibgeschtzt

Gibt eine Referenz auf das Sitzungsspeicherobjekt zurck, in dem Daten gespeichert werden, auf die nur die Origin zugreifen kann, die sie erstellt hat.

Window.sharedStorage Schreibgeschtzt Sicherer Kontext

Gibt das WindowSharedStorage-Objekt fr die aktuelle Origin zurck. Es ist der Haupteinstiegspunkt zum Schreiben von Daten in den gemeinsamen Speicher mithilfe der Shared Storage API.

Window.speechSynthesis Schreibgeschtzt

Gibt ein SpeechSynthesis-Objekt zurck, das den Einstiegspunkt fr die Sprachsynthesefunktionen der Web Speech API bildet.

Window.statusbar Schreibgeschtzt

Gibt das statusbar-Objekt zurck.

Window.toolbar Schreibgeschtzt

Gibt das toolbar-Objekt zurck.

Window.top Schreibgeschtzt

Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurck. Diese Eigenschaft ist schreibgeschtzt.

Window.trustedTypes Schreibgeschtzt

Gibt das dem globalen Objekt zugeordnete TrustedTypePolicyFactory-Objekt zurck. Es ist der Einstiegspunkt fr die Verwendung der Trusted Types API.

Window.viewport Schreibgeschtzt

Gibt eine Viewport-Objektinstanz zurck, die Informationen ber den aktuellen Zustand des Viewports des Gerts bereitstellt.

Window.visualViewport Schreibgeschtzt

Gibt ein VisualViewport-Objekt zurck, das den visuellen Viewport eines bestimmten Fensters reprsentiert.

Window.window Schreibgeschtzt

Gibt eine Referenz auf das aktuelle Fenster zurck.

window[0], window[1] usw.

Gibt eine Referenz auf das jeweilige window-Objekt in den Frames zurck. Weitere Informationen finden Sie unter Window.frames.

Benannte Eigenschaften

Einige Elemente im Dokument sind auch als Fenstereigenschaften verfgbar:

Bei jedem <embed>-, <form>-, <iframe>-, <img>- und <object>-Element wird sein name verfgbar gemacht, sofern er nicht leer ist. Wenn das Dokument beispielsweise <form name="my_form"> enthlt, geben window["my_form"] und das gleichwertige window.my_form eine Referenz auf dieses Element zurck.
Bei jedem HTML-Element wird seine id verfgbar gemacht, sofern sie nicht leer ist.

Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurckgegeben. Entspricht die Eigenschaft mehreren Elementen, wird eine HTMLCollection zurckgegeben, die alle diese Elemente enthlt. Wenn eines der Elemente ein navigierbares <iframe> oder <object> ist, wird stattdessen contentWindow des ersten solchen iframe zurckgegeben.

Veraltete Eigenschaften

Window.event Schreibgeschtzt: Gibt das aktuelle Ereignis zurck, also das Ereignis, das gerade im Kontext des JavaScript-Codes verarbeitet wird, oder undefined, wenn gerade kein Ereignis verarbeitet wird. Verwenden Sie nach Mglichkeit stattdessen das Event-Objekt, das direkt an Event-Handler bergeben wird.
Window.external Schreibgeschtzt: Gibt ein Objekt mit Funktionen zurck, mit denen dem Browser externe Suchanbieter hinzugefgt werden knnen.
Window.orientation Schreibgeschtzt: Gibt die Ausrichtung des Viewports relativ zur natrlichen Ausrichtung des Gerts in Grad zurck, in Schritten von 90 Grad.
Window.status: Ruft den Text in der Statusleiste am unteren Rand des Browsers ab oder legt ihn fest.

Instanzmethoden

Diese Schnittstelle erbt Methoden von der Schnittstelle EventTarget.

Window.atob(): Dekodiert einen String mit Daten, die mit Base64 kodiert wurden.
Window.alert(): Zeigt einen Warnungsdialog an.
Window.blur(): Entzieht dem Fenster den Fokus.
Window.btoa(): Erzeugt aus einem String mit Binrdaten einen Base64-kodierten ASCII-String.
Window.cancelAnimationFrame(): Ermglicht es, einen zuvor mit Window.requestAnimationFrame geplanten Callback abzubrechen.
Window.cancelIdleCallback(): Ermglicht es, einen zuvor mit Window.requestIdleCallback geplanten Callback abzubrechen.
Window.clearInterval(): Beendet die mit Window.setInterval() eingerichtete wiederholte Ausfhrung.
Window.clearTimeout(): Bricht die mit Window.setTimeout() geplante verzgerte Ausfhrung ab.
Window.close(): Schliet das aktuelle Fenster.
Window.confirm(): Zeigt einen Dialog mit einer Nachricht an, auf die der Benutzer reagieren muss.
Window.createImageBitmap(): Akzeptiert verschiedene Bildquellen und gibt eine Promise zurck, die mit einem ImageBitmap erfllt wird. Optional wird die Quelle auf ein Pixelrechteck zugeschnitten, das bei (sx, sy) beginnt und die Breite sw sowie die Hhe sh hat.
Window.dump(): Schreibt eine Nachricht in die Konsole.
Window.fetch(): Startet den Abruf einer Ressource aus dem Netzwerk.
Window.fetchLater(): Erstellt einen verzgerten Abruf, der gesendet wird, sobald die Seite verlassen wird (wenn sie zerstrt wird oder in den bfcache gelangt), oder nach Ablauf eines angegebenen activateAfter-Timeouts je nachdem, was zuerst eintritt.
Window.find(): Sucht in einem Fenster nach einem bestimmten String.
Window.focus(): Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle(): Ruft den berechneten Stil fr das angegebene Element ab. Der berechnete Stil umfasst die berechneten Werte aller CSS-Eigenschaften des Elements.
Window.getDefaultComputedStyle(): Ruft den standardmig berechneten Stil fr das angegebene Element ab und ignoriert dabei Autoren-Stylesheets.
Window.getScreenDetails() Sicherer Kontext: Gibt eine Promise zurck, die mit einer ScreenDetails-Objektinstanz erfllt wird. Diese enthlt Details zu allen Bildschirmen, die dem Gert des Benutzers zur Verfgung stehen.
Window.getSelection(): Gibt das Selection-Objekt zurck, das die ausgewhlten Elemente reprsentiert.
Window.matchMedia(): Gibt ein MediaQueryList-Objekt zurck, das den angegebenen Media-Query-String reprsentiert.
Window.moveBy(): Verschiebt das aktuelle Fenster um einen angegebenen Betrag.
Window.moveTo(): Verschiebt das Fenster an die angegebenen Koordinaten.
: ffnet ein neues Fenster.
Window.postMessage(): Stellt eine sichere Mglichkeit bereit, mit der ein Fenster einen String mit Daten an ein anderes Fenster senden kann, das sich nicht in derselben Domain befinden muss.
Window.print(): ffnet den Druckdialog, um das aktuelle Dokument zu drucken.
Window.prompt(): Gibt den Text zurck, den der Benutzer in einen Eingabedialog eingegeben hat.
Window.queryLocalFonts() Sicherer Kontext: Gibt eine Promise zurck, die mit einem Array von FontData-Objekten erfllt wird. Diese reprsentieren die lokal verfgbaren Schriftarten.
Window.queueMicrotask(): Reiht einen Mikrotask zur Ausfhrung zu einem sicheren Zeitpunkt ein, bevor die Kontrolle an die Ereignisschleife des Browsers zurckkehrt.
Window.reportError(): Meldet einen Fehler in einem Skript und simuliert dabei eine nicht behandelte Ausnahme.
Window.requestAnimationFrame(): Teilt dem Browser mit, dass eine Animation luft, und fordert ihn auf, das Fenster fr den nchsten Animationsframe neu zu zeichnen.
Window.requestIdleCallback(): Ermglicht es, Aufgaben fr Leerlaufphasen des Browsers einzuplanen.
Window.requestResize(): Aktualisiert die Greninformationen, die ein eingebettetes Dokument mit seinem einbettenden bergeordneten Dokument teilt, jedoch nur, wenn das eingebettete Dokument der Weitergabe dieser Informationen zugestimmt hat.
Window.resizeBy(): ndert die Gre des aktuellen Fensters um einen bestimmten Betrag.
Window.resizeTo(): ndert die Gre des Fensters dynamisch.
Window.scroll(): Scrollt das Fenster zu einer bestimmten Stelle im Dokument.
Window.scrollBy(): Scrollt das Dokument im Fenster um den angegebenen Betrag.
Window.scrollByLines(): Scrollt das Dokument um die angegebene Anzahl von Zeilen.
Window.scrollByPages(): Scrollt das aktuelle Dokument um die angegebene Anzahl von Seiten.
Window.scrollTo(): Scrollt zu bestimmten Koordinaten im Dokument.
Window.setInterval(): Plant die wiederholte Ausfhrung einer Funktion in einem angegebenen Abstand von Millisekunden.
Window.setTimeout(): Plant die Ausfhrung einer Funktion nach einer angegebenen Zeit.
Window.showDirectoryPicker() Sicherer Kontext: Zeigt eine Verzeichnisauswahl an, ber die der Benutzer ein Verzeichnis auswhlen kann.
Window.showOpenFilePicker() Sicherer Kontext: Zeigt eine Dateiauswahl an, ber die der Benutzer eine oder mehrere Dateien auswhlen kann.
Window.showSaveFilePicker() Sicherer Kontext: Zeigt eine Dateiauswahl an, ber die der Benutzer eine Datei speichern kann.
Window.sizeToContent(): Passt die Gre des Fensters an seinen Inhalt an.
Window.stop(): Diese Methode stoppt das Laden des Fensters.
Window.structuredClone(): Erstellt mithilfe des Structured-Clone-Algorithmus eine tiefe Kopie eines angegebenen Werts.

Veraltete Methoden

Window.captureEvents(): Registriert das Fenster, um alle Ereignisse des angegebenen Typs zu erfassen.
Window.clearImmediate(): Beendet die mit setImmediate() eingerichtete wiederholte Ausfhrung.
Window.releaseEvents(): Beendet die Erfassung von Ereignissen eines bestimmten Typs durch das Fenster.
Window.requestFileSystem(): Ermglicht einer Website oder App den Zugriff auf ein isoliertes Dateisystem fr die eigene Nutzung.
Window.setImmediate(): Fhrt eine Funktion aus, nachdem der Browser andere aufwendige Aufgaben abgeschlossen hat.
Window.setResizable(): Bewirkt nichts (No-op). Aus Grnden der Abwrtskompatibilitt mit Netscape 4.x beibehalten.
Window.webkitConvertPointFromNodeToPage(): Transformiert einen WebKitPoint vom Koordinatensystem des Knotens in das Koordinatensystem der Seite.
Window.webkitConvertPointFromPageToNode(): Transformiert einen WebKitPoint vom Koordinatensystem der Seite in das Koordinatensystem des Knotens.

Ereignisse

Sie knnen diese Ereignisse mit addEventListener() berwachen oder der Eigenschaft oneventname dieser Schnittstelle einen Event-Listener zuweisen. Zustzlich zu den unten aufgefhrten Ereignissen knnen viele Ereignisse vom Document im Fensterobjekt nach oben weitergegeben werden.

error: Wird ausgelst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann. Dies ist beispielsweise der Fall, wenn bei der Ausfhrung eines Skripts ein Fehler auftritt oder ein Bild nicht gefunden wird oder ungltig ist.
languagechange: Wird am globalen Scope-Objekt ausgelst, wenn sich die bevorzugte Sprache des Benutzers ndert.
resize: Wird ausgelst, wenn die Gre des Fensters gendert wurde.
storage: Wird ausgelst, wenn ein Speicherbereich (localStorage oder sessionStorage) im Kontext eines anderen Dokuments gendert wurde.

Verbindungsereignisse

offline: Wird ausgelst, wenn der Browser den Zugriff auf das Netzwerk verloren hat und der Wert von navigator.onLine auf false gewechselt ist.
online: Wird ausgelst, wenn der Browser Zugriff auf das Netzwerk erhalten hat und der Wert von navigator.onLine auf true gewechselt ist.

Gerteausrichtungsereignisse

devicemotion Sicherer Kontext: Wird in regelmigen Abstnden ausgelst und gibt die auf das Gert wirkende Beschleunigung sowie, falls verfgbar, die Rotationsgeschwindigkeit an.
deviceorientation Sicherer Kontext: Wird ausgelst, wenn neue Daten des Magnetometer-Ausrichtungssensors zur aktuellen Ausrichtung des Gerts relativ zum Erdkoordinatensystem verfgbar sind.
deviceorientationabsolute Sicherer Kontext: Wird ausgelst, wenn neue Daten des Magnetometer-Ausrichtungssensors zur aktuellen absoluten Ausrichtung des Gerts relativ zum Erdkoordinatensystem verfgbar sind.

Fokusereignisse

blur: Wird ausgelst, wenn das Fenster den Fokus verloren hat.
focus: Wird ausgelst, wenn das Fenster den Fokus erhalten hat.

Gamepad-Ereignisse

gamepadconnected: Wird ausgelst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde, oder wenn erstmals eine Taste oder Achse des Gamepads verwendet wird.
gamepaddisconnected: Wird ausgelst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.

Verlaufsereignisse

hashchange: Wird ausgelst, wenn sich der Fragmentbezeichner der URL gendert hat, also der Teil der URL, der mit dem Symbol # beginnt.
pagehide: Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, whrend er zu einem anderen Dokument aus dem Sitzungsverlauf wechselt. Das geschieht beispielsweise, wenn der Benutzer auf die Zurck- oder Vorwrts-Schaltflche klickt.
pagereveal: Wird ausgelst, wenn ein Dokument zum ersten Mal gerendert wird entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder beim Aktivieren eines Dokuments aus dem Back-Forward-Cache (bfcache) oder einem Prerender.
pageshow: Wird gesendet, wenn der Browser das Dokument infolge einer Navigation sichtbar macht. Dazu gehrt sowohl das erstmalige Laden der Seite als auch beispielsweise die Rckkehr zu ihr, nachdem der Benutzer innerhalb desselben Tabs zu einer anderen Seite navigiert ist.
pageswap: Wird ausgelst, wenn ein Dokument aufgrund einer Navigation gleich entladen wird.
popstate: Wird ausgelst, wenn sich der aktive Verlaufseintrag ndert.

Lade- und Entladeereignisse

beforeunload: Wird ausgelst, wenn das Fenster, das Dokument und dessen Ressourcen gleich entladen werden.
load: Wird ausgelst, wenn die gesamte Seite einschlielich aller abhngigen Ressourcen wie Stylesheets und Bilder geladen wurde.
unload: Wird ausgelst, wenn das Dokument oder eine untergeordnete Ressource entladen wird.

Manifest-Ereignisse

appinstalled: Wird ausgelst, wenn der Browser eine Seite erfolgreich als Anwendung installiert hat.
beforeinstallprompt: Wird ausgelst, bevor der Benutzer zur Installation einer Webanwendung aufgefordert wird.

Nachrichtenereignisse

message: Wird ausgelst, wenn das Fenster eine Nachricht empfngt, beispielsweise durch einen Aufruf von Window.postMessage() aus einem anderen Browsing-Kontext.
messageerror: Wird ausgelst, wenn ein Window-Objekt eine Nachricht empfngt, die nicht deserialisiert werden kann.

Druckereignisse

afterprint: Wird ausgelst, nachdem der Druck des zugehrigen Dokuments begonnen hat oder die Druckvorschau geschlossen wurde.
beforeprint: Wird ausgelst, bevor das zugehrige Dokument gedruckt oder in der Druckvorschau angezeigt wird.

Ereignisse bei abgelehnten Promises

rejectionhandled: Wird jedes Mal gesendet, wenn eine JavaScript-Promise abgelehnt wird, unabhngig davon, ob ein Handler vorhanden ist, der die Ablehnung abfngt.
unhandledrejection: Wird gesendet, wenn eine JavaScript-Promise abgelehnt wird und kein Handler vorhanden ist, der die Ablehnung abfngt.

Scroll-Ereignisse

scrollsnapchange: Wird am Scroll-Container nach Abschluss eines Scrollvorgangs ausgelst, wenn ein neues Scroll-Snap-Ziel ausgewhlt wurde.
scrollsnapchanging: Wird am Scroll-Container ausgelst, wenn der Browser feststellt, dass ein neues Scroll-Snap-Ziel ansteht, das nach Ende der aktuellen Scrollgeste ausgewhlt wird.

Veraltete Ereignisse

orientationchange: Wird ausgelst, wenn sich die Ausrichtung des Gerts gendert hat.
vrdisplayactivate: Wird ausgelst, wenn eine Anzeige fr die Darstellung verfgbar wird.
vrdisplayconnect: Wird ausgelst, wenn ein kompatibles VR-Gert mit dem Computer verbunden wurde.
vrdisplaydisconnect: Wird ausgelst, wenn ein kompatibles VR-Gert vom Computer getrennt wurde.
vrdisplaydeactivate: Wird ausgelst, wenn eine Anzeige nicht mehr fr die Darstellung verfgbar ist.
vrdisplaypresentchange: Wird ausgelst, wenn sich der Darstellungszustand eines VR-Gerts ndert wenn es also von der Darstellung zum Nichtdarstellen wechselt oder umgekehrt.

Nach oben weitergegebene Ereignisse

Nicht alle Ereignisse, die nach oben weitergegeben werden, erreichen das Window-Objekt. Nur die folgenden erreichen es und knnen am Window-Objekt berwacht werden:

Schnittstellen

Siehe DOM-Referenz.

Ereignisse auf Window berwachen

Fr HTML-Elemente gibt es drei Mglichkeiten, Ereignisse zu berwachen:

Fgen Sie dem Element mit der Methode EventTarget.addEventListener einen Event-Listener hinzu.
Weisen Sie der Eigenschaft oneventname des Elements in JavaScript einen Event-Handler zu.
Fgen Sie dem Element im HTML ein Attribut mit dem Prfix on hinzu.

Um Ereignisse auf Window-Objekten zu berwachen, knnen Sie im Allgemeinen nur die ersten beiden Methoden verwenden, da Window kein entsprechendes HTML-Element hat. Es gibt jedoch eine bestimmte Gruppe von Ereignissen, deren Listener mit der zweiten oder dritten Methode dem <body>-Element (oder dem veralteten <frameset>-Element) im Dokument des Window-Objekts hinzugefgt werden knnen. 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 Varianten genau gleichwertig sind:

window.onresize = (e) => console.log(e.currentTarget);
document.body.onresize = (e) => console.log(e.currentTarget);

html

<body ></body>

In allen drei Fllen wird das Window-Objekt als currentTarget protokolliert.

Spezifikationen

Spezifikation
HTML # the-window-object

Browser-Kompatibilitt

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden