Window
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Die Window-Schnittstelle repräsentiert ein Fenster, das ein DOM-Dokument enthält. 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 repräsentiert, in dem das Skript ausgeführt wird, ist für JavaScript-Code verfügbar.
Die Window-Schnittstelle enthält zahlreiche Funktionen, Namespaces, Objekte und Konstruktoren, die nicht unbedingt unmittelbar mit dem Konzept eines Fensters der Benutzeroberfläche zusammenhängen. Sie ist jedoch ein geeigneter Ort für Elemente, die global verfügbar sein müssen. 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 repräsentiert. Das globale window, auf das JavaScript-Code innerhalb eines Tabs zugreift, repräsentiert stets diesen Tab. Allerdings beziehen sich manche Eigenschaften und Methoden auch in einem Browser mit Tabs weiterhin auf das übergeordnete Fenster, das den Tab enthält, etwa resizeTo() und innerHeight. Grundsätzlich gilt: Was sich nicht sinnvoll auf einen Tab beziehen lässt, bezieht sich stattdessen auf das Fenster.
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 aufgeführt sind.
Window.cachesSchreibgeschützt Sicherer Kontext-
Gibt das dem aktuellen Kontext zugeordnete
CacheStorage-Objekt zurück. Dieses Objekt ermöglicht unter anderem das Speichern von Ressourcen für die Offline-Nutzung und das Erzeugen benutzerdefinierter Antworten auf Anfragen. Window.clientInformationSchreibgeschützt-
Ein Alias für
Window.navigator. Window.closedSchreibgeschützt-
Diese Eigenschaft gibt an, ob das aktuelle Fenster geschlossen ist.
-
Gibt eine Referenz auf das
CookieStore-Objekt für den aktuellen Dokumentkontext zurück. Window.crashReportSchreibgeschützt Sicherer Kontext-
Gibt ein
CrashReportContext-Objekt zurück, mit dem beliebige Daten für den aktuellen Browsing-Kontext der obersten Ebene aufgezeichnet werden können. Bei einem Browserabsturz werden diese Daten einemCrashReporthinzugefügt und an einen Reporting-Endpunkt gesendet. Window.credentiallessSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob das aktuelle Dokument in einem credentialless
<iframe>geladen wurde. Weitere Informationen finden Sie unter IFrame credentialless. Window.crossOriginIsolatedSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob sich die Website in einem Zustand der Cross-Origin-Isolation befindet.
Window.cryptoSchreibgeschützt-
Gibt das dem globalen Objekt zugeordnete
Crypto-Objekt zurück. Window.customElementsSchreibgeschützt-
Gibt eine Referenz auf das
CustomElementRegistry-Objekt zurück, mit dem neue benutzerdefinierte Elemente registriert und Informationen über bereits registrierte benutzerdefinierte Elemente abgerufen werden können. Window.devicePixelRatioSchreibgeschützt-
Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln auf dem aktuellen Bildschirm zurück.
Window.documentSchreibgeschützt-
Gibt eine Referenz auf das Dokument zurück, das das Fenster enthält.
Window.documentPictureInPictureSchreibgeschützt Sicherer Kontext-
Gibt eine Referenz auf das Document-Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.
Window.fenceSchreibgeschützt-
Gibt eine
Fence-Objektinstanz für den aktuellen Dokumentkontext zurück. Nur für Dokumente verfügbar, die in ein<fencedframe>eingebettet sind. Window.frameElementSchreibgeschützt-
Gibt das Element zurück, in das das Fenster eingebettet ist, oder
null, wenn das Fenster nicht eingebettet ist. Window.framesSchreibgeschützt-
Gibt ein Array der Unterframes im aktuellen Fenster zurück.
Window.fullScreen-
Diese Eigenschaft gibt an, ob das Fenster im Vollbildmodus angezeigt wird.
Window.historySchreibgeschützt-
Gibt eine Referenz auf das Verlaufsobjekt zurück.
Window.indexedDBSchreibgeschützt-
Stellt einen Mechanismus bereit, mit dem Anwendungen asynchron auf die Funktionen indexierter Datenbanken zugreifen können; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Gibt die Höhe des Inhaltsbereichs des Browserfensters einschließlich der horizontalen Bildlaufleiste zurück, sofern diese angezeigt wird.
Window.innerWidthSchreibgeschützt-
Gibt die Breite des Inhaltsbereichs des Browserfensters einschließlich der vertikalen Bildlaufleiste zurück, sofern diese angezeigt wird.
Window.isSecureContextSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob der aktuelle Kontext sicher (
true) ist oder nicht (false). Window.launchQueueSchreibgeschützt-
Wenn eine Progressive Web App (PWA) mit einem
client_mode-Wert vonfocus-existing,navigate-newodernavigate-existingfürlaunch_handlergestartet wird, bietetlaunchQueueZugriff auf die KlasseLaunchQueue. Damit lässt sich für die PWA eine benutzerdefinierte Navigation beim Start implementieren. Window.lengthSchreibgeschützt-
Gibt die Anzahl der Frames im Fenster zurück. Siehe auch
window.frames. Window.localStorageSchreibgeschützt-
Gibt eine Referenz auf das lokale Speicherobjekt zurück, 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.locationbarSchreibgeschützt-
Gibt das locationbar-Objekt zurück.
-
Gibt das menubar-Objekt zurück.
Window.mozInnerScreenXSchreibgeschützt-
Gibt die horizontale (X-)Koordinate der linken oberen Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Einen Umrechnungsfaktor für Bildschirmpixel finden Sie bei
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtils. Window.mozInnerScreenYSchreibgeschützt-
Gibt die vertikale (Y-)Koordinate der linken oberen Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Einen Umrechnungsfaktor für Bildschirmpixel finden Sie bei
mozScreenPixelsPerCSSPixel. Window.name-
Ruft den Namen des Fensters ab oder legt ihn fest.
-
Gibt das dem aktuellen
windowzugeordneteNavigation-Objekt zurück. Es ist der Einstiegspunkt für die Navigation API. -
Gibt eine Referenz auf das navigator-Objekt zurück.
Window.opener-
Gibt eine Referenz auf das Fenster zurück, das das aktuelle Fenster geöffnet hat.
Window.originSchreibgeschützt-
Gibt die Origin des globalen Objekts als serialisierten String zurück.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem Origin-basierten Agent-Cluster gehört. Window.outerHeightSchreibgeschützt-
Gibt die Außenhöhe des Browserfensters zurück.
Window.outerWidthSchreibgeschützt-
Gibt die Außenbreite des Browserfensters zurück.
Window.pageXOffsetSchreibgeschützt-
Ein Alias für
window.scrollX. Window.pageYOffsetSchreibgeschützt-
Ein Alias für
window.scrollY. Window.parentSchreibgeschützt-
Gibt eine Referenz auf das übergeordnete Fenster des aktuellen Fensters oder Unterframes zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück. Es enthält die Attributetimingundnavigation, die jeweils ein Objekt mit leistungsbezogenen Daten bereitstellen. Weitere Informationen und Beispiele finden Sie auch unter Navigation Timing verwenden. Window.personalbarSchreibgeschützt-
Gibt das personalbar-Objekt zurück.
Window.schedulerSchreibgeschützt-
Gibt das dem aktuellen Kontext zugeordnete
Scheduler-Objekt zurück. Es ist der Einstiegspunkt für die Verwendung der Prioritized Task Scheduling API. Window.screenSchreibgeschützt-
Gibt eine Referenz auf das dem Fenster zugeordnete screen-Objekt zurück.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben den horizontalen Abstand zwischen dem linken Rand des Browserfensters und dem linken Bildschirmrand zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben den vertikalen Abstand zwischen dem oberen Rand des Browserfensters und dem oberen Bildschirmrand zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das scrollbars-Objekt zurück.
Window.scrollMaxXSchreibgeschützt-
Der maximale horizontale Bildlaufversatz des Fensters, also die Dokumentbreite abzüglich der Viewport-Breite.
Window.scrollMaxYSchreibgeschützt-
Der maximale vertikale Bildlaufversatz des Fensters, also die Dokumenthöhe abzüglich der Viewport-Höhe.
Window.scrollXSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits horizontal gescrollt wurde.
Window.scrollYSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits vertikal gescrollt wurde.
Window.selfSchreibgeschützt-
Gibt eine Objektreferenz auf das Fensterobjekt selbst zurück.
Window.sessionStorageSchreibgeschützt-
Gibt eine Referenz auf das Sitzungsspeicherobjekt zurück, in dem Daten gespeichert werden, auf die nur die Origin zugreifen kann, die sie erstellt hat.
-
Gibt das
WindowSharedStorage-Objekt für die aktuelle Origin zurück. Es ist der Haupteinstiegspunkt zum Schreiben von Daten in den gemeinsamen Speicher mithilfe der Shared Storage API. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das den Einstiegspunkt für die Sprachsynthesefunktionen der Web Speech API bildet. Window.statusbarSchreibgeschützt-
Gibt das statusbar-Objekt zurück.
Window.toolbarSchreibgeschützt-
Gibt das toolbar-Objekt zurück.
Window.topSchreibgeschützt-
Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.
Window.trustedTypesSchreibgeschützt-
Gibt das dem globalen Objekt zugeordnete
TrustedTypePolicyFactory-Objekt zurück. Es ist der Einstiegspunkt für die Verwendung der Trusted Types API. Window.viewportSchreibgeschützt-
Gibt eine
Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Viewports des Geräts bereitstellt. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-Objekt zurück, das den visuellen Viewport eines bestimmten Fensters repräsentiert. Window.windowSchreibgeschützt-
Gibt eine Referenz auf das aktuelle Fenster zurück.
window[0],window[1]usw.-
Gibt eine Referenz auf das jeweilige
window-Objekt in den Frames zurück. Weitere Informationen finden Sie unterWindow.frames. - Benannte Eigenschaften
-
Einige Elemente im Dokument sind auch als Fenstereigenschaften verfügbar:
- Bei jedem
<embed>-,<form>-,<iframe>-,<img>- und<object>-Element wird seinnameverfügbar gemacht, sofern er nicht leer ist. Wenn das Dokument beispielsweise<form name="my_form">enthält, gebenwindow["my_form"]und das gleichwertigewindow.my_formeine Referenz auf dieses Element zurück. - Bei jedem HTML-Element wird seine
idverfügbar gemacht, sofern sie nicht leer ist.
Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Entspricht die Eigenschaft mehreren Elementen, wird eine
HTMLCollectionzurückgegeben, die alle diese Elemente enthält. Wenn eines der Elemente ein navigierbares<iframe>oder<object>ist, wird stattdessencontentWindowdes ersten solchen iframe zurückgegeben. - Bei jedem
Veraltete Eigenschaften
Window.eventSchreibgeschützt-
Gibt das aktuelle Ereignis zurück, also das Ereignis, das gerade im Kontext des JavaScript-Codes verarbeitet wird, oder
undefined, wenn gerade kein Ereignis verarbeitet wird. Verwenden Sie nach Möglichkeit stattdessen dasEvent-Objekt, das direkt an Event-Handler übergeben wird. Window.externalSchreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, mit denen dem Browser externe Suchanbieter hinzugefügt werden können.
Window.orientationSchreibgeschützt-
Gibt die Ausrichtung des Viewports relativ zur natürlichen Ausrichtung des Geräts in Grad zurück, 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 Binärdaten einen Base64-kodierten ASCII-String.
Window.cancelAnimationFrame()-
Ermöglicht es, einen zuvor mit
Window.requestAnimationFramegeplanten Callback abzubrechen. Window.cancelIdleCallback()-
Ermöglicht es, einen zuvor mit
Window.requestIdleCallbackgeplanten Callback abzubrechen. Window.clearInterval()-
Beendet die mit
Window.setInterval()eingerichtete wiederholte Ausführung. Window.clearTimeout()-
Bricht die mit
Window.setTimeout()geplante verzögerte Ausführung ab. Window.close()-
Schließt 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
Promisezurück, die mit einemImageBitmaperfüllt wird. Optional wird die Quelle auf ein Pixelrechteck zugeschnitten, das bei (sx, sy) beginnt und die Breite sw sowie die Höhe sh hat. Window.dump()-
Schreibt eine Nachricht in die Konsole.
Window.fetch()-
Startet den Abruf einer Ressource aus dem Netzwerk.
Window.fetchLater()-
Erstellt einen verzögerten Abruf, der gesendet wird, sobald die Seite verlassen wird (wenn sie zerstört 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 für das angegebene Element ab. Der berechnete Stil umfasst die berechneten Werte aller CSS-Eigenschaften des Elements.
Window.getDefaultComputedStyle()-
Ruft den standardmäßig berechneten Stil für das angegebene Element ab und ignoriert dabei Autoren-Stylesheets.
Window.getScreenDetails()Sicherer Kontext-
Gibt eine
Promisezurück, die mit einerScreenDetails-Objektinstanz erfüllt wird. Diese enthält Details zu allen Bildschirmen, die dem Gerät des Benutzers zur Verfügung stehen. Window.getSelection()-
Gibt das Selection-Objekt zurück, das die ausgewählten Elemente repräsentiert.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das den angegebenen Media-Query-String repräsentiert. Window.moveBy()-
Verschiebt das aktuelle Fenster um einen angegebenen Betrag.
Window.moveTo()-
Verschiebt das Fenster an die angegebenen Koordinaten.
Window.open()-
Öffnet ein neues Fenster.
Window.postMessage()-
Stellt eine sichere Möglichkeit 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 zurück, den der Benutzer in einen Eingabedialog eingegeben hat.
Window.queryLocalFonts()Sicherer Kontext-
Gibt eine
Promisezurück, die mit einem Array vonFontData-Objekten erfüllt wird. Diese repräsentieren die lokal verfügbaren Schriftarten. Window.queueMicrotask()-
Reiht einen Mikrotask zur Ausführung zu einem sicheren Zeitpunkt ein, bevor die Kontrolle an die Ereignisschleife des Browsers zurückkehrt.
Window.reportError()-
Meldet einen Fehler in einem Skript und simuliert dabei eine nicht behandelte Ausnahme.
Window.requestAnimationFrame()-
Teilt dem Browser mit, dass eine Animation läuft, und fordert ihn auf, das Fenster für den nächsten Animationsframe neu zu zeichnen.
Window.requestIdleCallback()-
Ermöglicht es, Aufgaben für Leerlaufphasen des Browsers einzuplanen.
Window.requestResize()-
Aktualisiert die Größeninformationen, 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 Größe des aktuellen Fensters um einen bestimmten Betrag.
Window.resizeTo()-
Ändert die Größe 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 Ausführung einer Funktion in einem angegebenen Abstand von Millisekunden.
Window.setTimeout()-
Plant die Ausführung einer Funktion nach einer angegebenen Zeit.
Window.showDirectoryPicker()Sicherer Kontext-
Zeigt eine Verzeichnisauswahl an, über die der Benutzer ein Verzeichnis auswählen kann.
Window.showOpenFilePicker()Sicherer Kontext-
Zeigt eine Dateiauswahl an, über die der Benutzer eine oder mehrere Dateien auswählen kann.
Window.showSaveFilePicker()Sicherer Kontext-
Zeigt eine Dateiauswahl an, über die der Benutzer eine Datei speichern kann.
Window.sizeToContent()-
Passt die Größe 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 Ausführung. Window.releaseEvents()-
Beendet die Erfassung von Ereignissen eines bestimmten Typs durch das Fenster.
Window.requestFileSystem()-
Ermöglicht einer Website oder App den Zugriff auf ein isoliertes Dateisystem für die eigene Nutzung.
Window.setImmediate()-
Führt eine Funktion aus, nachdem der Browser andere aufwendige Aufgaben abgeschlossen hat.
Window.setResizable()-
Bewirkt nichts (No-op). Aus Gründen der Abwärtskompatibilität mit Netscape 4.x beibehalten.
Window.webkitConvertPointFromNodeToPage()-
Transformiert einen
WebKitPointvom Koordinatensystem des Knotens in das Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()-
Transformiert einen
WebKitPointvom Koordinatensystem der Seite in das Koordinatensystem des Knotens.
Ereignisse
Sie können diese Ereignisse mit addEventListener() überwachen oder der Eigenschaft oneventname dieser Schnittstelle einen Event-Listener zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom Document im Fensterobjekt nach oben weitergegeben werden.
error-
Wird ausgelöst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann. Dies ist beispielsweise der Fall, wenn bei der Ausführung eines Skripts ein Fehler auftritt oder ein Bild nicht gefunden wird oder ungültig ist.
languagechange-
Wird am globalen Scope-Objekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize-
Wird ausgelöst, wenn die Größe des Fensters geändert wurde.
storage-
Wird ausgelöst, wenn ein Speicherbereich (
localStorageodersessionStorage) im Kontext eines anderen Dokuments geändert wurde.
Verbindungsereignisse
Geräteausrichtungsereignisse
devicemotionSicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und gibt die auf das Gerät wirkende Beschleunigung sowie, falls verfügbar, die Rotationsgeschwindigkeit an.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn neue Daten des Magnetometer-Ausrichtungssensors zur aktuellen Ausrichtung des Geräts relativ zum Erdkoordinatensystem verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn neue Daten des Magnetometer-Ausrichtungssensors zur aktuellen absoluten Ausrichtung des Geräts relativ zum Erdkoordinatensystem verfügbar sind.
Fokusereignisse
Gamepad-Ereignisse
gamepadconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde, oder wenn erstmals eine Taste oder 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, also der Teil der URL, der mit dem Symbol
#beginnt. pagehide-
Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während er zu einem anderen Dokument aus dem Sitzungsverlauf wechselt. Das geschieht beispielsweise, wenn der Benutzer auf die Zurück- oder Vorwärts-Schaltfläche klickt.
pagereveal-
Wird ausgelöst, 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 gehört sowohl das erstmalige Laden der Seite als auch beispielsweise die Rückkehr zu ihr, nachdem der Benutzer innerhalb desselben Tabs zu einer anderen Seite navigiert ist.
pageswap-
Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation gleich entladen wird.
popstate-
Wird ausgelöst, wenn sich der aktive Verlaufseintrag ändert.
Lade- und Entladeereignisse
beforeunload-
Wird ausgelöst, wenn das Fenster, das Dokument und dessen Ressourcen gleich entladen werden.
load-
Wird ausgelöst, wenn die gesamte Seite einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder geladen wurde.
unload-
Wird ausgelöst, wenn das Dokument oder eine untergeordnete Ressource entladen wird.
Manifest-Ereignisse
appinstalled-
Wird ausgelöst, wenn der Browser eine Seite erfolgreich als Anwendung installiert hat.
beforeinstallprompt-
Wird ausgelöst, bevor der Benutzer zur Installation einer Webanwendung aufgefordert wird.
Nachrichtenereignisse
message-
Wird ausgelöst, wenn das Fenster eine Nachricht empfängt, beispielsweise durch einen Aufruf von
Window.postMessage()aus einem anderen Browsing-Kontext. messageerror-
Wird ausgelöst, wenn ein
Window-Objekt eine Nachricht empfängt, die nicht deserialisiert werden kann.
Druckereignisse
afterprint-
Wird ausgelöst, nachdem der Druck des zugehörigen Dokuments begonnen hat oder die Druckvorschau geschlossen wurde.
beforeprint-
Wird ausgelöst, bevor das zugehörige Dokument gedruckt oder in der Druckvorschau angezeigt wird.
Ereignisse bei abgelehnten Promises
rejectionhandled-
Wird jedes Mal gesendet, wenn eine JavaScript-
Promiseabgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, der die Ablehnung abfängt. unhandledrejection-
Wird gesendet, wenn eine JavaScript-
Promiseabgelehnt wird und kein Handler vorhanden ist, der die Ablehnung abfängt.
Scroll-Ereignisse
scrollsnapchange-
Wird am Scroll-Container nach Abschluss eines Scrollvorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging-
Wird am Scroll-Container ausgelöst, wenn der Browser feststellt, dass ein neues Scroll-Snap-Ziel ansteht, das nach Ende der aktuellen Scrollgeste ausgewählt wird.
Veraltete Ereignisse
orientationchange-
Wird ausgelöst, wenn sich die Ausrichtung des Geräts geändert hat.
vrdisplayactivate-
Wird ausgelöst, wenn eine Anzeige für die Darstellung verfügbar wird.
vrdisplayconnect-
Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.
vrdisplaydisconnect-
Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivate-
Wird ausgelöst, wenn eine Anzeige nicht mehr für die Darstellung verfügbar ist.
vrdisplaypresentchange-
Wird ausgelöst, wenn sich der Darstellungszustand eines VR-Geräts ä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 können am Window-Objekt überwacht werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Ereignisse auf Window überwachen
Für HTML-Elemente gibt es drei Möglichkeiten, Ereignisse zu überwachen:
- Fügen Sie dem Element mit der Methode
EventTarget.addEventListenereinen Event-Listener hinzu. - Weisen Sie der Eigenschaft
oneventnamedes Elements in JavaScript einen Event-Handler zu. - Fügen Sie dem Element im HTML ein Attribut mit dem Präfix
onhinzu.
Um Ereignisse auf Window-Objekten zu überwachen, können 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 hinzugefügt werden können. Diese Ereignisse sind:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
Das bedeutet, dass die folgenden Varianten genau gleichwertig sind:
window.onresize = (e) => console.log(e.currentTarget);
document.body.onresize = (e) => console.log(e.currentTarget);
<body onresize="console.log(event.currentTarget)"></body>
In allen drei Fällen wird das Window-Objekt als currentTarget protokolliert.
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-window-object> |