Window

Instanzeigenschaften

Dieses Interface erbt Eigenschaften vom EventTarget-Interface.

Beachten Sie, dass Eigenschaften, die Objekte sind (z. B. zum Überschreiben des Prototyps integrierter Elemente), weiter unten in einem eigenen Abschnitt aufgeführt sind.

Window.caches Schreibgeschü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.clientInformation Schreibgeschützt

Ein Alias für Window.navigator.

Window.closed Schreibgeschützt

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

Window.cookieStore Schreibgeschützt Sicherer Kontext

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

Window.crashReport Schreibgeschützt Sicherer Kontext

Gibt ein CrashReportContext-Objekt zurück, mit dem beliebige Daten für den aktuellen obersten Browsing-Kontext aufgezeichnet werden können. Bei einem Browserabsturz werden diese Daten einem CrashReport hinzugefügt und an einen Reporting-Endpunkt gesendet.

Window.credentialless Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob das aktuelle Dokument innerhalb eines credentialless <iframe> geladen wurde. Weitere Informationen finden Sie unter IFrame credentialless.

Window.crossOriginIsolated Schreibgeschützt

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

Window.crypto Schreibgeschützt

Gibt das dem globalen Objekt zugeordnete Crypto-Objekt zurück.

Window.customElements Schreibgeschützt

Gibt eine Referenz auf das CustomElementRegistry-Objekt zurück, mit dem neue Custom Elements registriert und Informationen über bereits registrierte Custom Elements abgerufen werden können.

Window.devicePixelRatio Schreibgeschützt

Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln auf dem aktuellen Bildschirm zurück.

Window.document Schreibgeschützt

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

Window.documentPictureInPicture Schreibgeschützt Sicherer Kontext

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

Window.fence Schreibgeschützt

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

Window.frameElement Schreibgeschützt

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

Window.frames Schreibgeschützt

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

Window.fullScreen

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

Window.history Schreibgeschützt

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

Window.indexedDB Schreibgeschützt

Stellt einen Mechanismus bereit, mit dem Anwendungen asynchron auf die Funktionen indizierter Datenbanken zugreifen können; gibt ein IDBFactory-Objekt zurück.

Window.innerHeight Schreibgeschützt

Ruft die Höhe des Inhaltsbereichs des Browserfensters ab, einschließlich der horizontalen Bildlaufleiste, sofern diese dargestellt wird.

Window.innerWidth Schreibgeschützt

Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich der vertikalen Bildlaufleiste, sofern diese dargestellt wird.

Window.isSecureContext Schreibgeschützt

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

Window.launchQueue Schreibgeschützt

Wenn eine Progressive Web App (PWA) mit einem client_mode-Wert von focus-existing, navigate-new oder navigate-existing für launch_handler gestartet wird, bietet launchQueue Zugriff auf die Klasse LaunchQueue. Damit lässt sich für die PWA eine benutzerdefinierte Navigation beim Start 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. Es wird zum Speichern von Daten verwendet, auf die nur der Origin zugreifen kann, der sie erstellt hat.

Window.location

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

Window.locationbar Schreibgeschützt

Gibt das locationbar-Objekt zurück.

Window.menubar Schreibgeschützt

Gibt das menubar-Objekt zurück.

Window.mozInnerScreenX Schreibgeschü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 die Umrechnung in Bildschirmpixel finden Sie bei Bedarf unter mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils.

Window.mozInnerScreenY Schreibgeschü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 die Umrechnung in Bildschirmpixel finden Sie bei Bedarf unter mozScreenPixelsPerCSSPixel.

Window.name

Ruft den Namen des Fensters ab oder legt ihn fest.

Window.navigation Schreibgeschützt

Gibt das dem aktuellen window zugeordnete Navigation-Objekt zurück. Es ist 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 das aktuelle Fenster geöffnet hat.

Window.origin Schreibgeschützt

Gibt den Origin des globalen Objekts als serialisierte Zeichenfolge zurück.

Window.originAgentCluster Schreibgeschützt

Gibt true zurück, wenn dieses Fenster zu einem nach Origin getrennten Agent-Cluster gehört.

Window.outerHeight Schreibgeschützt

Ruft die äußere Höhe des Browserfensters ab.

Window.outerWidth Schreibgeschützt

Ruft die äußere Breite des Browserfensters ab.

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 des aktuellen Fensters oder Subframes zurück.

Window.performance Schreibgeschützt

Gibt ein Performance-Objekt zurück, das die Attribute timing und navigation enthält. Beide sind Objekte, die leistungsbezogene Daten bereitstellen. Weitere Informationen und Beispiele finden Sie auch unter Navigation Timing verwenden.

Window.personalbar Schreibgeschützt

Gibt das personalbar-Objekt zurück.

Window.scheduler Schreibgeschü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.screen Schreibgeschützt

Gibt eine Referenz auf das dem Fenster zugeordnete screen-Objekt zurück.

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Browserfensters der Benutzerin oder des Benutzers zum linken Bildschirmrand zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Browserfensters der Benutzerin oder des Benutzers zum oberen Bildschirmrand zurück.

Window.scrollbars Schreibgeschützt

Gibt das scrollbars-Objekt zurück.

Window.scrollMaxX Schreibgeschützt

Der maximale Versatz, bis zu dem das Fenster horizontal gescrollt werden kann, also die Dokumentbreite abzüglich der Viewport-Breite.

Window.scrollMaxY Schreibgeschützt

Der maximale Versatz, bis zu dem das Fenster vertikal gescrollt werden kann, also die Dokumenthöhe abzüglich der Viewport-Höhe.

Window.scrollX Schreibgeschützt

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

Window.scrollY Schreibgeschützt

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

Window.self Schreibgeschützt

Gibt eine Objektreferenz auf das Fensterobjekt selbst zurück.

Window.sessionStorage Schreibgeschützt

Gibt eine Referenz auf das Sitzungsspeicherobjekt zurück. Es wird zum Speichern von Daten verwendet, auf die nur der Origin zugreifen kann, der sie erstellt hat.

Window.sharedStorage Schreibgeschützt Sicherer Kontext

Gibt das WindowSharedStorage-Objekt für den aktuellen Origin zurück. Dies ist der wichtigste Einstiegspunkt zum Schreiben von Daten in Shared Storage mithilfe der Shared Storage API.

Window.speechSynthesis Schreibgeschützt

Gibt ein SpeechSynthesis-Objekt zurück, das als Einstiegspunkt für die Sprachsynthesefunktionen der Web Speech API dient.

Window.statusbar Schreibgeschützt

Gibt das statusbar-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 dem globalen Objekt zugeordnete TrustedTypePolicyFactory-Objekt zurück. Es dient als Einstiegspunkt für die Verwendung der Trusted Types API.

Window.viewport Schreibgeschützt

Gibt eine Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Viewports des Geräts bereitstellt.

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport-Objekt zurück, das den visuellen Viewport eines bestimmten Fensters 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. Weitere Informationen finden Sie unter Window.frames.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Eigenschaften des Fensters verfügbar gemacht:

• Für jedes <embed>-, <form>-, <iframe>-, <img>- und <object>-Element wird sein name verfügbar gemacht, sofern es nicht leer ist. Wenn das Dokument beispielsweise <form name="my_form"> enthält, gibt window["my_form"] (ebenso wie window.my_form) eine Referenz auf dieses Element zurück.
• Für jedes HTML-Element wird seine id verfügbar gemacht, sofern sie nicht leer ist.

Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird eine HTMLCollection zurückgegeben, die alle diese Elemente enthält. Falls eines der Elemente ein navigierbares <iframe> oder <object> ist, wird stattdessen contentWindow des ersten solchen iframe zurückgegeben.

Veraltete Eigenschaften

Window.event Schreibgeschü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. Stattdessen sollte nach Möglichkeit das Event-Objekt verwendet werden, das direkt an Ereignisbehandlungsfunktionen übergeben wird.

Window.external Schreibgeschützt

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

Window.orientation Schreibgeschützt

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

Window.status

Ruft den Text in der Statusleiste am unteren Rand des Browsers ab oder legt ihn fest.

Instanzmethoden

Dieses Interface erbt Methoden vom EventTarget-Interface.

Window.atob()

Dekodiert eine Datenzeichenfolge, die mit Base64 kodiert wurde.

Window.alert()

Zeigt ein Hinweisdialogfeld an.

Window.blur()

Entzieht dem Fenster den Fokus.

Window.btoa()

Erstellt aus einer binären Datenzeichenfolge eine Base64-kodierte ASCII-Zeichenfolge.

Window.cancelAnimationFrame()

Ermöglicht es, einen zuvor mit Window.requestAnimationFrame geplanten Callback abzubrechen.

Window.cancelIdleCallback()

Ermöglicht es, einen zuvor mit Window.requestIdleCallback geplanten Callback abzubrechen.

Window.clearInterval()

Bricht die mit Window.setInterval() festgelegte wiederholte Ausführung ab.

Window.clearTimeout()

Bricht die mit Window.setTimeout() festgelegte verzögerte Ausführung ab.

Window.close()

Schließt das aktuelle Fenster.

Window.confirm()

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

Window.createImageBitmap()

Akzeptiert verschiedene Bildquellen und gibt ein Promise zurück, das mit einem ImageBitmap erfü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 eine verzögerte Fetch-Anfrage. Sie wird gesendet, sobald die Seite verlassen wird (wenn sie zerstört wird oder in den bfcache gelangt) oder nachdem ein angegebener activateAfter-Timeout abgelaufen ist – je nachdem, was zuerst eintritt.

Window.find()

Sucht in einem Fenster nach einer bestimmten Zeichenfolge.

Window.focus()

Setzt den Fokus auf das aktuelle Fenster.

Window.getComputedStyle()

Ruft den berechneten Stil für das angegebene Element ab. Der berechnete Stil enthält 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 ein Promise zurück, das mit einer ScreenDetails-Objektinstanz erfüllt wird, die Details zu allen für das Gerät der Benutzerin oder des Benutzers verfügbaren Bildschirmen repräsentiert.

Window.getSelection()

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

Window.matchMedia()

Gibt ein MediaQueryList-Objekt zurück, das die angegebene Media-Query-Zeichenfolge 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()

Bietet eine sichere Möglichkeit, eine Datenzeichenfolge von einem Fenster an ein anderes zu senden, das sich nicht in derselben Domain befinden muss.

Window.print()

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

Window.prompt()

Gibt den Text zurück, den die Benutzerin oder der Benutzer in einem Eingabedialogfeld eingegeben hat.

Window.queryLocalFonts() Sicherer Kontext

Gibt ein Promise zurück, das mit einem Array von FontData-Objekten erfüllt wird, die die lokal verfügbaren Schriftarten repräsentieren.

Window.queueMicrotask()

Reiht einen Microtask ein, der zu einem sicheren Zeitpunkt ausgeführt wird, bevor die Kontrolle an die Ereignisschleife des Browsers zurückgegeben wird.

Window.reportError()

Meldet einen Fehler in einem Skript und simuliert dabei eine unbehandelte Ausnahme.

Window.requestAnimationFrame()

Teilt dem Browser mit, dass eine Animation läuft, und fordert ihn auf, das Neuzeichnen des Fensters für den nächsten Animationsframe einzuplanen.

Window.requestIdleCallback()

Ermöglicht das Einplanen von Aufgaben während Leerlaufzeiten des Browsers.

Window.requestResize()

Aktualisiert die Größeninformationen, die ein eingebettetes Dokument mit seinem einbettenden Elternelement teilt, jedoch nur, wenn das eingebettete Dokument der Weitergabe seiner Größeninformationen zugestimmt hat.

Window.resizeBy()

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

Window.resizeTo()

Ändert die Fenstergröße 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 Ausführung einer Funktion nach jeweils einer bestimmten Anzahl von Millisekunden.

Window.setTimeout()

Plant die Ausführung einer Funktion nach einer bestimmten Zeit.

Window.showDirectoryPicker() Sicherer Kontext

Zeigt einen Verzeichnisauswahldialog an, in dem die Benutzerin oder der Benutzer ein Verzeichnis auswählen kann.

Window.showOpenFilePicker() Sicherer Kontext

Zeigt einen Dateiauswahldialog an, in dem die Benutzerin oder der Benutzer eine oder mehrere Dateien auswählen kann.

Window.showSaveFilePicker() Sicherer Kontext

Zeigt einen Dateiauswahldialog an, in dem die Benutzerin oder der Benutzer eine Datei speichern kann.

Window.sizeToContent()

Passt die Fenstergröße an den 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 abzufangen.

Window.clearImmediate()

Bricht die mit setImmediate() festgelegte wiederholte Ausführung ab.

Window.releaseEvents()

Beendet das Abfangen von Ereignissen eines bestimmten Typs durch das Fenster.

Window.requestFileSystem()

Ermöglicht einer Website oder App den Zugriff auf ein Sandbox-Dateisystem für eigene Zwecke.

Window.setImmediate()

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

Window.setResizable()

Hat keine Wirkung (No-op). Aus Gründen der Abwärtskompatibilität 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 können diese Ereignisse mit addEventListener() überwachen oder der oneventname-Eigenschaft dieses Interfaces eine Ereignisbehandlungsfunktion zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse aus dem im Fensterobjekt enthaltenen Document nach oben weitergegeben werden.

error

Wird ausgelöst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann, beispielsweise wenn bei der Ausführung eines Skripts ein Fehler auftritt oder ein Bild nicht gefunden wird beziehungsweise ungültig ist.

languagechange

Wird am globalen Scope-Objekt ausgelöst, wenn sich die bevorzugte Sprache der Benutzerin oder des Benutzers ändert.

resize

Wird ausgelöst, wenn die Größe des Fensters geändert wurde.

storage

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

Verbindungsereignisse

offline

Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk verloren hat und der Wert von navigator.onLine zu false gewechselt ist.

online

Wird ausgelöst, wenn der Browser Zugang zum Netzwerk erhalten hat und der Wert von navigator.onLine zu true gewechselt ist.

Ereignisse zur Geräteausrichtung

devicemotion Sicherer Kontext

Wird in regelmäßigen Abständen ausgelöst und gibt an, wie stark das Gerät physisch beschleunigt wird und, sofern verfügbar, wie schnell es sich dreht.

deviceorientation Sicherer Kontext

Wird ausgelöst, wenn vom Magnetometer-Ausrichtungssensor neue Daten zur aktuellen Ausrichtung des Geräts relativ zum Erdkoordinatensystem vorliegen.

deviceorientationabsolute Sicherer Kontext

Wird ausgelöst, wenn vom Magnetometer-Ausrichtungssensor neue Daten zur aktuellen absoluten Ausrichtung des Geräts relativ zum Erdkoordinatensystem vorliegen.

Fokusereignisse

blur

Wird ausgelöst, wenn das Fenster den Fokus verloren hat.

focus

Wird ausgelöst, wenn das Fenster den Fokus erhalten hat.

Gamepad-Ereignisse

gamepadconnected

Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde, oder wenn eine Taste oder Achse des Gamepads zum ersten Mal verwendet wird.

gamepaddisconnected

Wird ausgelöst, wenn der Browser erkennt, dass die Verbindung zu einem Gamepad getrennt wurde.

Verlauf-Ereignisse

hashchange

Wird ausgelöst, wenn sich der Fragmentbezeichner der URL geändert hat (der Teil der URL ab dem Symbol #).

pagehide

Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während er zu einem anderen Dokument aus dem Sitzungsverlauf wechselt. Dies geschieht beispielsweise, wenn die Benutzerin oder der Benutzer auf die Schaltfläche „Zurück“ oder auf die Schaltfläche „Vorwärts“ klickt, um im Sitzungsverlauf vorwärtszugehen.

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 durch Prerendering).

pageshow

Wird gesendet, wenn der Browser das Dokument aufgrund einer Navigation sichtbar macht. Dies umfasst nicht nur das erstmalige Laden der Seite, sondern auch Fälle, in denen die Benutzerin oder der Benutzer zu der Seite zurückkehrt, nachdem sie oder er 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 seine 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, wenn die Benutzerin oder der Benutzer gleich 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, wenn das zugehörige Dokument gleich gedruckt oder in der Druckvorschau angezeigt wird.

Ereignisse bei abgelehnten Promises

rejectionhandled

Wird jedes Mal gesendet, wenn ein JavaScript-Promise abgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, der die Ablehnung abfängt.

unhandledrejection

Wird gesendet, wenn ein JavaScript-Promise abgelehnt wird, aber kein Handler vorhanden ist, der die Ablehnung abfängt.

Scroll-Ereignisse

scrollsnapchange

Wird am Scroll-Container am Ende 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 zur Auswahl ansteht, das heißt, dass es nach dem 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 auf einem Display eine Darstellung gestartet werden kann.

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 auf einem Display keine Darstellung mehr möglich ist.

vrdisplaypresentchange

Wird ausgelöst, wenn sich der Darstellungszustand eines VR-Geräts ändert – wenn es also von der Darstellung zum Nicht-Darstellen wechselt oder umgekehrt.

Nach oben weitergegebene Ereignisse

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

• abort
• auxclick
• beforeinput
• beforematch
• beforetoggle
• cancel
• canplay
• canplaythrough
• change
• click
• close
• contextlost
• contextmenu
• contextrestored
• copy
• cuechange
• cut
• dblclick
• drag
• dragend
• dragenter
• dragleave
• dragover
• dragstart
• drop
• durationchange
• emptied
• ended
• formdata
• input
• invalid
• keydown
• keypress
• keyup
• loadeddata
• loadedmetadata
• loadstart
• mousedown
• mouseenter
• mouseleave
• mousemove
• mouseout
• mouseover
• mouseup
• paste
• pause
• play
• playing
• progress
• ratechange
• reset
• scrollend
• securitypolicyviolation
• seeked
• seeking
• select
• slotchange
• stalled
• submit
• suspend
• timeupdate
• toggle
• volumechange
• waiting
• wheel

Interfaces

Siehe DOM-Referenz.

Ereignisse auf Window überwachen

Bei HTML-Elementen gibt es drei Möglichkeiten, Ereignisse zu überwachen:

• Fügen Sie dem Element mit der Methode EventTarget.addEventListener einen Event Listener hinzu.
• Weisen Sie der oneventname-Eigenschaft des Elements in JavaScript eine Ereignisbehandlungsfunktion zu.
• Fügen Sie dem Element im HTML ein Attribut mit dem Präfix on hinzu.

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 sich mit der zweiten oder dritten Methode dem <body>-Element (oder dem veralteten <frameset>-Element) hinzufügen lassen, das zum Dokument des Window-Objekts gehört. 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 vollständig 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

Browser-Kompatibilität