Window

Instanz-Eigenschaften

Dieses Interface erbt Eigenschaften vom EventTarget-Interface.

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 Dokumentenkontext zurück.

Window.crashReport Schreibgeschützt Sicherer Kontext

Gibt ein CrashReportContext-Objekt zurück, das das Aufzeichnen von beliebigen Daten für den aktuellen Browsing-Kontext auf oberster Ebene ermöglicht, die dann zu einem CrashReport hinzugefügt und an einen Berichtsendepunkt gesendet werden, wenn ein Browserabsturz auftritt.

Window.credentialless Schreibgeschützt Experimentell

Gibt einen booleschen Wert zurück, der angibt, ob das aktuelle Dokument in einem credentiallosen <iframe> geladen wurde. Weitere Details finden Sie unter IFrame credentialless.

Window.crossOriginIsolated Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob die Website sich in einem zustandsübergreifenden Trennungsartikel befindet.

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 verwendet werden kann, um neue benutzerdefinierte Elemente zu registrieren und Informationen über zuvor registrierte benutzerdefinierte Elemente abzurufen.

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 Dokument Picture-in-Picture-Fenster für den aktuellen Dokumentenkontext zurück.

Window.fence Schreibgeschützt Experimentell

Gibt eine Fence-Objektinstanz für den aktuellen Dokumentenkontext zurück. Nur verfügbar für Dokumente, die in einem <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 zeigt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.

Window.history Schreibgeschützt

Gibt eine Referenz auf das Historienobjekt zurück.

Window.indexedDB Schreibgeschützt

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

Window.innerHeight Schreibgeschützt

Gibt die Höhe des Inhaltsbereichs des Browserfensters zurück, einschließlich der horizontalen Bildlaufleiste, falls angezeigt.

Window.innerWidth Schreibgeschützt

Gibt die Breite des Inhaltsbereichs des Browserfensters zurück, einschließlich der vertikalen Bildlaufleiste, falls angezeigt.

Window.isSecureContext Schreibgeschützt

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

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 launchQueue Zugriff auf die LaunchQueue-Klasse, die eine benutzerdefinierte Startnavigation für die PWA ermöglicht.

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 verwendet wird, um Daten zu speichern, die nur vom Ursprung, der sie erstellt hat, abgerufen werden können.

Window.location

Ruft den Standort oder die aktuelle URL des Fensterobjekts ab oder setzt ihn.

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 Sichtfensters des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, wenn nötig.

Window.mozInnerScreenY Schreibgeschützt Nicht standardisiert

Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Sichtfensters des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel für einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, wenn nötig.

Window.name

Ruft den Namen des Fensters ab oder setzt ihn.

Window.navigation Schreibgeschützt

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 das aktuelle Fenster geöffnet hat.

Window.origin Schreibgeschützt

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

Window.originAgentCluster Schreibgeschützt

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

Window.outerHeight Schreibgeschützt

Gibt die Höhe des äußeren Bereichs des Browserfensters zurück.

Window.outerWidth Schreibgeschützt

Gibt die Breite des äußeren Bereichs des Browserfensters zurück.

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

Window.performance Schreibgeschützt

Gibt ein Performance-Objekt zurück, das die timing- und navigation-Attribute enthält, von denen jedes ein Objekt ist, das leistungsbezogene Daten bereitstellt. Siehe auch Using Navigation Timing für zusätzliche Informationen und Beispiele.

Window.personalbar Schreibgeschützt

Gibt das persönlichenleiste-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 Bildschirm-Objekt zurück, das mit dem Fenster verknüpft ist.

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben den horizontalen Abstand von der linken Kante des Browser-Sichtfensters zur linken Seite des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben den vertikalen Abstand von der oberen Kante des Browser-Sichtfensters zur oberen Seite des Bildschirms zurück.

Window.scrollbars Schreibgeschützt

Gibt das scrollbar-Objekt zurück.

Window.scrollMaxX Nicht standardisiert Schreibgeschützt

Der maximale Offset, den das Fenster horizontal scrollen kann, also die Dokumentenbreite minus der Ansichtsfensterbreite.

Window.scrollMaxY Nicht standardisiert Schreibgeschützt

Der maximale Offset, den das Fenster vertikal scrollen kann (d.h. die Dokumentenhöhe minus der Ansichtsfensterhö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 Objekt-Referenz auf das Fensterobjekt selbst zurück.

Window.sessionStorage

Gibt eine Referenz auf das Sitzungs-Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur vom Ursprung, der sie erstellt hat, abgerufen werden können.

Window.sharedStorage Schreibgeschützt Sicherer Kontext Veraltet

Gibt das WindowSharedStorage-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt für das Schreiben von Daten im gemeinsamen Speicher mithilfe der Shared Storage API.

Window.speechSynthesis Schreibgeschützt

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

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 TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt assoziiert ist und den Einstiegspunkt für die Nutzung der Trusted Types API bietet.

Window.viewport Experimentell Schreibgeschützt

Gibt eine Viewport-Objektinstanz zurück, die Informationen über den aktuellen Status des Geräte-Sichtfensters bereitstellt.

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport-Objekt zurück, das das visuelle Sichtfenster für ein bestimmtes Fenster repräsentiert.

Window.window Schreibgeschützt

Gibt eine Referenz auf das aktuelle Fenster zurück.

window[0], window[1], etc.

Gibt eine Referenz auf das window-Objekt in den Frames zurück. Weitere Details finden Sie unter Window.frames.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Fenster-Eigenschaften verfügbar gemacht:

• Für jedes <embed>, <form>, <iframe>, <img> und <object>-Element wird sein name (falls nicht leer) verfügbar gemacht. Zum Beispiel, wenn das Dokument <form name="my_form"> enthält, dann gibt window["my_form"] (und sein Äquivalent window.my_form) eine Referenz auf dieses Element zurück.
• Für jedes HTML-Element wird seine id (falls nicht leer) verfügbar gemacht.

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 enthält. Wenn eines der Elemente ein navigierbares <iframe> oder <object> ist, wird stattdessen das contentWindow des ersten solchen iframes zurückgegeben.

Veraltete Eigenschaften

Window.event Veraltet Schreibgeschützt

Gibt das aktuelle Ereignis zurück, das ist das Ereignis, das gerade im Kontext des JavaScript-Codes behandelt wird, oder undefined, wenn gerade kein Ereignis behandelt wird. Das Event-Objekt, das direkt an Ereignis-Handler weitergegeben wird, sollte wann immer möglich bevorzugt werden.

Window.external Veraltet Schreibgeschützt

Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter zum Browser hinzuzufügen.

Window.orientation Veraltet Schreibgeschützt

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

Window.status Veraltet

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

Instanz-Methoden

Dieses Interface erbt Methoden vom EventTarget-Interface.

Window.atob()

Decodiert eine Datenzeichenkette, die mit Base-64-Codierung kodiert wurde.

Window.alert()

Zeigt ein Alarmdialogfeld an.

Window.blur() Veraltet

Entfernt den Fokus vom Fenster.

Window.btoa()

Erstellt eine Base-64-codierte ASCII-Zeichenkette aus einer binären Datenzeichenkette.

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()

Hebt die wiederholte Ausführung auf, die mit Window.setInterval() festgelegt wurde.

Window.clearTimeout()

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

Window.close()

Schließt das aktuelle Fenster.

Window.confirm()

Zeigt einen Dialog mit einer Nachricht an, auf die der Benutzer reagieren muss.

Window.createImageBitmap()

Nimmt eine Vielzahl von Bildquellen an und gibt einen Promise zurück, der zu einem ImageBitmap aufgelöst wird. Optional wird die Quelle auf das Rechteck der Pixel eingeschränkt, das bei (sx, sy) mit der Breite sw und der Höhe sh beginnt.

Window.dump() Nicht standardisiert

Schreibt eine Nachricht in die Konsole.

Window.fetch()

Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.

Window.fetchLater() Experimentell

Erstellt einen verzögerten Abruf, der gesendet wird, sobald die Seite verlassen wird (wenn sie zerstört wird oder in den bfcache eintritt), oder nach einem angegebenen activateAfter-Timeout — je nachdem, was zuerst eintritt.

Window.find() Nicht standardisiert

Sucht ein bestimmtes Zeichenfolgenmuster 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 Standard-Berechneten Stil für das angegebene Element ab, wobei Autor-Stylesheets ignoriert werden.

Window.getScreenDetails() Experimentell Sicherer Kontext

Gibt einen Promise zurück, der mit einem ScreenDetails-Objekt aufgelöst wird, das die Details aller Bildschirme darstellt, die dem Gerät des Benutzers zur Verfügung stehen.

Window.getSelection()

Gibt das Auswahlobjekt zurück, das das/die ausgewählte(n) Element(e) darstellt.

Window.matchMedia()

Gibt ein MediaQueryList-Objekt zurück, das die angegebene Medienabfragezeichenfolge darstellt.

Window.moveBy()

Bewegt das aktuelle Fenster um einen bestimmten Betrag.

Window.moveTo()

Bewegt das Fenster zu den angegebenen Koordinaten.

Window.open()

Öffnet ein neues Fenster.

Window.postMessage()

Bietet eine sichere Möglichkeit für ein Fenster, eine Datenzeichenfolge an ein anderes Fenster zu senden, das nicht innerhalb derselben Domäne wie das erste Fenster liegen muss.

Window.print()

Öffnet den Druckdialog, um das aktuelle Dokument zu drucken.

Window.prompt()

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

Window.queryLocalFonts() Experimentell Sicherer Kontext

Gibt einen Promise zurück, der mit einem Array von FontData-Objekten aufgelöst wird, die die lokal verfügbaren Schriftgesichter darstellen.

Window.queueMicrotask()

Sorgt dafür, dass eine Mikroaufgabe zu einem sicheren Zeitpunkt ausgeführt wird, bevor die Kontrolle wieder an die Ereignisschleife des Browsers zurückgegeben wird.

Window.reportError()

Meldet einen Fehler in einem Skript, ähnlich einer unbehandelten Ausnahme.

Window.requestAnimationFrame()

Teilt dem Browser mit, dass eine Animation in Arbeit ist, und fordert ihn auf, das Fenster für den nächsten Animationsframe neu zu zeichnen.

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 zu einer bestimmten Position 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 Satz von Koordinaten im Dokument.

Window.setInterval()

Plant die Ausführung einer Funktion jedes Mal, wenn eine bestimmte Anzahl von Millisekunden vergeht.

Window.setTimeout()

Plant die Ausführung einer Funktion innerhalb einer bestimmten Zeitspanne.

Window.showDirectoryPicker() Experimentell Sicherer Kontext

Zeigt einen Verzeichnisauswähler an, mit dem der Benutzer ein Verzeichnis auswählen kann.

Window.showOpenFilePicker() Experimentell Sicherer Kontext

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

Window.showSaveFilePicker() Experimentell Sicherer Kontext

Zeigt einen Dateiauswähler an, der es dem Benutzer ermöglicht, eine Datei zu speichern.

Window.sizeToContent() Nicht standardisiert

Passt die Größe des Fensters an seinen Inhalt an.

Window.stop()

Diese Methode stoppt das Laden des Fensters.

Window.structuredClone()

Erstellt eine tiefe Kopie eines angegebenen Wertes unter Verwendung des strukturierten Klonalgrithmus.

Veraltete Methoden

Window.captureEvents() Veraltet

Registriert das Fenster, um alle Ereignisse eines bestimmten Typs zu erfassen.

Window.clearImmediate() Nicht standardisiert Veraltet

Hebt die wiederholte Ausführung auf, die mit setImmediate() festgelegt wurde.

Window.releaseEvents() Veraltet

Befreit das Fenster von der Erfassung von Ereignissen eines bestimmten Typs.

Window.requestFileSystem() Nicht standardisiert Veraltet

Ermöglicht einer Website oder einer App den Zugriff auf ein geschütztes Dateisystem für den eigenen Gebrauch.

Window.setImmediate() Nicht standardisiert Veraltet

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

Window.setResizable() Nicht standardisiert Veraltet

Tut nichts (no-op). Wird zur Rückwärtskompatibilität mit Netscape 4.x beibehalten.

Window.webkitConvertPointFromNodeToPage() Nicht standardisiert Veraltet

Transformiert einen WebKitPoint vom Koordinatensystem des Knotens zum Koordinatensystem der Seite.

Window.webkitConvertPointFromPageToNode() Nicht standardisiert Veraltet

Transformiert einen WebKitPoint vom Koordinatensystem der Seite zum Koordinatensystem des Knotens.

Events

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener auf die oneventname-Eigenschaft dieses Interfaces zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom Document, das im Fensterobjekt enthalten ist, ausgelöst werden.

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 oder ungültig ist.

languagechange

Wird beim globalen Scope-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 modifiziert wurde.

Verbindungsereignisse

offline

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

online

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

Geräteorientierungsereignisse

devicemotion Sicherer Kontext

Wird in regelmäßigen Abständen ausgelöst und zeigt die Menge der physikalischen Beschleunigungskraft an, die das Gerät empfängt, sowie die Rotationsrate, falls verfügbar.

deviceorientation Sicherer Kontext

Wird ausgelöst, wenn frische Daten vom Magnetometersensor zur Orientierungsbestimmung über die aktuelle Ausrichtung des Geräts im Vergleich zum Erdkoordinatensystem verfügbar sind.

deviceorientationabsolute Sicherer Kontext

Wird ausgelöst, wenn frische Daten vom Magnetometersensor zur Orientierungsbestimmung über die aktuelle absolute Ausrichtung des Geräts im Vergleich zum Erdkoordinatensystem 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 verbunden wurde, oder zum ersten Mal ein Button/eine Achse des Gamepads verwendet wird.

gamepaddisconnected

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

Verlaufereignisse

hashchange

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

pagehide

Wird gesendet, wenn der Browser das aktuelle Dokument versteckt, während es dabei ist, an dessen Stelle ein anderes Dokument aus der Sitzungsverlauf anzuzeigen. Dies geschieht beispielsweise, wenn der Benutzer auf die Zurück-Schaltfläche klickt oder wenn er auf die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf voranzuschreiten.

pagereveal

Wird ausgelöst, wenn ein Dokument erstmals gerendert wird, entweder wenn ein neues Dokument aus dem Netzwerk geladen wird oder ein Dokument aktiviert wird (entweder aus dem back/forward cache (bfcache) oder prerender).

pageshow

Wird gesendet, wenn der Browser das Dokument sichtbar macht aufgrund von Navigationstätigkeiten, einschließlich nicht nur, wenn die Seite erstmals geladen wird, sondern auch in Situationen, wie wenn der Benutzer zur Seite zurück navigiert, nachdem er eine andere innerhalb desselben Tabs besucht hat.

pageswap

Wird ausgelöst, wenn ein Dokument gerade entladen wird aufgrund einer Navigation.

popstate

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

Lade- und Entladeereignisse

beforeunload

Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen gerade entladen werden.

load

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

unload

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

Manifest-Ereignisse

appinstalled

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

beforeinstallprompt

Wird ausgelöst, wenn ein Benutzer kurz davor ist, zur Installation einer Web-Anwendung aufgefordert zu werden.

Messaging-Ereignisse

message

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

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 mit dem Drucken begonnen hat oder die Druckvorschau geschlossen wurde.

beforeprint

Wird ausgelöst, wenn das zugehörige Dokument kurz davor ist, gedruckt oder zur Druckvorbereitung angezeigt zu werden.

Promise-Ablehnungserignisse

rejectionhandled

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

unhandledrejection

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

Scrollereignisse

scrollsnapchange Experimentell

Wird am Scrollcontainer am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.

scrollsnapchanging Experimentell

Wird am Scrollcontainer ausgelöst, wenn der Browser feststellt, dass ein neues Scroll-Snap-Ziel aussteht, d.h. ausgewählt wird, wenn die aktuelle Scrollgeste endet.

Veraltete Ereignisse

orientationchange Veraltet

Wird ausgelöst, wenn sich die Ausrichtung 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äsentationszustand eines VR-Geräts ändert – das heißt, von Präsentieren zu Nicht-Präsentieren oder umgekehrt.

Gepropagte Ereignisse

Nicht alle gepropagten Ereignisse können das Window-Objekt erreichen. Nur die folgenden tun dies und können auf dem Window-Objekt abgehört 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

Schnittstellen

Siehe DOM-Referenz.

Events auf Window lauschen

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

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

Um auf Events bei Window-Objekten zu lauschen, können Sie im Allgemeinen nur die ersten beiden Methoden verwenden, da Window kein entsprechendes HTML-Element hat. Es gibt jedoch eine spezifische Gruppe von Events, deren Listener dem <body> (oder dem veralteten <frameset>) Element hinzugefügt werden können, das vom Dokument des Window-Objekts verwaltet wird, indem die zweite oder dritte Methode verwendet wird. Diese Events 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

Dies bedeutet, dass die folgenden Beispiele streng äquivalent 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 sehen Sie das Window-Objekt als currentTarget im Protokoll.

Spezifikationen

Browser-Kompatibilität