Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 im Fenster geladene DOM-Dokument.

Ein Fenster für ein gegebenes Dokument kann über die Eigenschaft document.defaultView erhalten werden.

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

Die Window-Schnittstelle beherbergt eine Vielzahl von Funktionen, Namensräumen, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters in Verbindung stehen. Dennoch ist die Window-Schnittstelle ein geeigneter Ort, um diese Elemente einzufügen, die global verfügbar sein müssen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.

In einem tab-basierten Browser wird jedes Tab durch ein eigenes Window-Objekt repräsentiert; das globale window, das vom JavaScript-Code innerhalb eines bestimmten Tabs gesehen wird, repräsentiert immer das Tab, in dem der Code ausgeführt wird. Trotzdem gelten auch in einem tab-basierten Browser einige Eigenschaften und Methoden für das gesamte Fenster, das das Tab enthält, wie resizeTo() und innerHeight. Im Allgemeinen bezieht sich alles, was nicht vernünftigerweise zu einem Tab gehören kann, stattdessen auf das Fenster.

EventTarget Window

Instanz-Eigenschaften

Diese Schnittstelle erbt Eigenschaften von der Schnittstelle EventTarget.

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-Nutzung und das Generieren benutzerdefinierter Antworten auf Anfragen.

Window.clientInformation Schreibgeschützt

Ein Alias für Window.navigator.

Window.closed Schreibgeschützt

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

Window.cookieStore Schreibgeschützt Sicherer Kontext

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

Window.crashReport Schreibgeschützt Sicherer Kontext

Gibt ein CrashReportContext-Objekt zurück, das es ermöglicht, beliebige Daten für den aktuellen, obersten Browsing-Kontext aufzuzeichnen, die dann zu einem CrashReport hinzugefügt und an einen Berichts-Endpunkt gesendet werden, wenn ein Browser-Absturz auftritt.

Window.credentialless Schreibgeschützt

Gibt einen booleschen Wert zurück, der anzeigt, ob das aktuelle Dokument in einem credentialless <iframe> geladen wurde. Siehe IFrame credentialless für weitere Einzelheiten.

Window.crossOriginIsolated Schreibgeschützt

Gibt einen booleschen Wert zurück, der anzeigt, ob sich die Website in einem cross-origin-Isolationszustand befindet.

Window.crypto Schreibgeschützt

Gibt das Crypto-Objekt zurück, das mit dem globalen Objekt verknüpft 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 zu erhalten.

Window.devicePixelRatio Schreibgeschützt

Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln auf dem 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 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. Verfügbar nur 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 Unterframes im aktuellen Fenster zurück.

Window.fullScreen

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

Window.history Schreibgeschützt

Gibt eine Referenz auf das Verlaufsobjekt zurück.

Window.indexedDB Schreibgeschützt

Bietet einen Mechanismus, mit dem Anwendungen asynchron auf die Möglichkeiten von indizierten Datenbanken zugreifen können; gibt ein IDBFactory-Objekt zurück.

Window.innerHeight Schreibgeschützt

Ruft die Höhe des Inhaltsbereichs des Browserfensters einschließlich, falls vorhanden, der horizontalen Scrollleiste ab.

Window.innerWidth Schreibgeschützt

Ruft die Breite des Inhaltsbereichs des Browserfensters einschließlich, falls vorhanden, der vertikalen Scrollleiste ab.

Window.isSecureContext Schreibgeschützt

Gibt ein boolesches Ergebnis zurück, das anzeigt, ob der aktuelle Kontext sicher ist (true) oder nicht (false).

Window.launchQueue Schreibgeschützt

Wenn eine progressive Webanwendung (PWA) mit einem launch_handler client_mode-Wert von focus-existing, navigate-new oder navigate-existing gestartet wird, bietet die launchQueue Zugriff auf die LaunchQueue-Klasse, die es ermöglicht, eine benutzerdefinierte Launch-Navigation zu implementieren.

Window.length Schreibgeschützt

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

Window.localStorage Schreibgeschützt

Gibt eine Referenz auf das Lokalspeicher-Objekt zurück, das verwendet wird, um Daten zu speichern, die nur von der Ursprungsquelle abgerufen werden können, die sie erstellt hat.

Window.location

Ruft den Standort oder die aktuelle URL des Fensterobjekts ab/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 oberen linken Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor zu Bildschirm-Pixeln, falls erforderlich.

Window.mozInnerScreenY Schreibgeschützt

Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel für einen Umrechnungsfaktor zu Bildschirm-Pixeln, falls erforderlich.

Window.name

Ruft den Namen des Fensters ab/legt ihn fest.

Window.navigation Schreibgeschützt

Gibt das aktuelle window's assoziierte Navigation-Objekt zurück. Der Einstiegspunkt für die Navigation-API.

Window.navigator Schreibgeschützt

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

Window.opener

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

Window.origin Schreibgeschützt

Gibt den Ursprung des globalen Objekts als Zeichenkette zurück.

Window.originAgentCluster Schreibgeschützt

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

Window.outerHeight Schreibgeschützt

Ruft die Höhe des Äußeren des Browserfensters ab.

Window.outerWidth Schreibgeschützt

Ruft die Breite des Äußeren 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 Elternobjekt des aktuellen Fensters oder Unterrahmens zurück.

Window.performance Schreibgeschützt

Gibt ein Performance-Objekt zurück, zu dem die Attribute timing und navigation gehören, von denen jedes ein Objekt ist, das leistungsbezogene Daten bereitstellt. Siehe auch Verwenden der Navigations-Timing-API für zusätzliche Informationen und Beispiele.

Window.personalbar Schreibgeschützt

Gibt das Personalbar-Objekt zurück.

Window.scheduler Schreibgeschützt

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

Window.screen Schreibgeschützt

Gibt eine Referenz auf das Bildschirminfo-Objekt zurück, das mit dem Fenster verknüpft ist.

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Benutzeransichtsfensters zum linken Rand des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Benutzeransichtsfensters zum oberen Rand des Bildschirms zurück.

Window.scrollbars Schreibgeschützt

Gibt das Scrollbars-Objekt zurück.

Window.scrollMaxX Schreibgeschützt

Der maximale Versatz, zu dem das Fenster horizontal gescrollt werden kann, das heißt die Dokumentbreite minus der Viewport-Breite.

Window.scrollMaxY Schreibgeschützt

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

Window.scrollX Schreibgeschützt

Gibt die Anzahl der Pixel zurück, 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 Objekt-Referenz auf das Fensterobjekt selbst zurück.

Window.sessionStorage

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

Window.sharedStorage Schreibgeschützt Sicherer Kontext

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

Window.speechSynthesis Schreibgeschützt

Gibt ein SpeechSynthesis-Objekt zurück, das den Einstieg in 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 nur lesbar.

Window.trustedTypes Schreibgeschützt

Gibt das TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verbunden ist, und bietet den Einstiegspunkt in die Nutzung der Trusted Types API.

Window.viewport Schreibgeschützt

Gibt eine Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Gerätevieports bietet.

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport Objekt zurück, das das visuelle Viewport für ein gegebenes Fenster darstellt.

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. Siehe Window.frames für weitere Details.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Fenster-Eigenschaften exponiert:

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

Falls 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 iframe zurückgegeben.

Veraltete Eigenschaften

Window.event Schreibgeschützt

Gibt das aktuelle Ereignis zurück, das derzeit im JavaScript-Kontext behandelt wird, oder undefined, wenn derzeit kein Ereignis behandelt wird. Das Event-Objekt, das direkt an Event-Handler übergeben wird, sollte stattdessen verwendet werden, wann immer möglich.

Window.external Schreibgeschützt

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

Window.orientation Schreibgeschützt

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

Window.status

Ruft den Text in der Statusleiste unten im Browser ab/setzt ihn fest.

Instanz-Methoden

Diese Schnittstelle erbt Methoden von der Schnittstelle EventTarget.

Window.atob()

Dekodiert eine Datenzeichenkette, die unter Verwendung der Base-64-Codierung kodiert wurde.

Window.alert()

Zeigt ein Warn-Dialogfeld an.

Window.blur()

Entzieht dem Fenster den Fokus.

Window.btoa()

Erstellt eine Base-64-kodierte ASCII-Zeichenkette aus einer Zeichenkette binärer Daten.

Window.cancelAnimationFrame()

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

Window.cancelIdleCallback()

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

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 ein Dialogfeld mit einer Nachricht an, auf die der Benutzer antworten muss.

Window.createImageBitmap()

Akzeptiert eine Vielzahl unterschiedlicher Bildquellen und gibt ein Promise zurück, das sich in ein ImageBitmap auflöst. Optional wird die Quelle auf das Pixelrechteck mit Ursprung bei (sx, sy) mit Breite sw und Höhe sh zugeschnitten.

Window.dump()

Schreibt eine Nachricht in die Konsole.

Window.fetch()

Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.

Window.fetchLater()

Erstellt einen verzögerten Abruf, der gesendet wird, sobald die Seite navigiert wird (sie wird zerstört oder tritt in den bfcache ein), oder nach einer bereitgestellten activateAfter-Zeitüberschreitung — je nachdem, was zuerst eintritt.

Window.find()

Sucht nach einer gegebenen Zeichenkette 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 zeigt die berechneten Werte aller CSS-Eigenschaften des Elements an.

Window.getDefaultComputedStyle()

Ruft den Standard-berechneten Stil für das angegebene Element ab, indem Autor-Stilblätter ignoriert werden.

Window.getScreenDetails() Sicherer Kontext

Gibt ein Promise zurück, das sich mit einem ScreenDetails-Objekt auflöst, das die Details aller auf dem Gerät des Benutzers verfügbaren Bildschirme darstellt.

Window.getSelection()

Gibt das Auswahl-Objekt zurück, das die ausgewählten Elemente darstellt.

Window.matchMedia()

Gibt ein MediaQueryList-Objekt zurück, das die angegebene Media-Abfrage-Zeichenkette darstellt.

Window.moveBy()

Bewegt das aktuelle Fenster um einen angegebenen Betrag.

Window.moveTo()

Bewegt das Fenster zu den angegebenen Koordinaten.

Window.open()

Öffnet ein neues Fenster.

Window.postMessage()

Bietet eine sichere Möglichkeit, dass ein Fenster eine Datenzeichenkette an ein anderes Fenster sendet, das nicht innerhalb desselben Domänennamens wie das erste sein muss.

Window.print()

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

Window.prompt()

Gibt den Text zurück, den der Benutzer in einem Eingabeaufforderungs-Dialog eingegeben hat.

Window.queryLocalFonts() Sicherer Kontext

Gibt ein Promise zurück, das sich mit einem Array von FontData-Objekten auflöst, die die lokal verfügbaren Schriftarten darstellen.

Window.queueMicrotask()

Stellt eine Microtask zur Ausführung zu einer sicheren Zeit vor der Rückkehr der Kontrolle in die Ereignisschleife des Browsers in die Warteschlange.

Window.reportError()

Meldet einen Fehler in einem Skript und emuliert eine unbehandelte Ausnahme.

Window.requestAnimationFrame()

Sagt dem Browser, dass eine Animation im Gange ist und fordert den Browser auf, ein Neuzeichnen des Fensters für den nächsten Animationsrahmen zu planen.

Window.requestIdleCallback()

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

Window.requestResize()

Aktualisiert die Größeninformationen, die von einem eingebetteten Dokument mit seinem einbettenden Elternteil geteilt werden, jedoch nur, wenn das eingebettete Dokument sich zum Teilen seiner Größeninformationen entschieden 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 an eine bestimmte 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 einem bestimmten Satz von Koordinaten im Dokument.

Window.setInterval()

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

Window.setTimeout()

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

Window.showDirectoryPicker() Sicherer Kontext

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

Window.showOpenFilePicker() Sicherer Kontext

Zeigt einen Dateipicker an, mit dem ein Benutzer eine Datei oder mehrere Dateien auswählen kann.

Window.showSaveFilePicker() Sicherer Kontext

Zeigt einen Dateipicker an, der es einem Benutzer ermöglicht, eine Datei zu speichern.

Window.sizeToContent()

Passt die Fenstergröße entsprechend dem Inhalt an.

Window.stop()

Diese Methode stoppt das Laden des Fensters.

Window.structuredClone()

Erstellt eine tiefe Kopie eines gegebenen Wertes unter Verwendung des strukturierten Klonalalgorithmus.

Veraltete Methoden

Window.captureEvents()

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

Window.clearImmediate()

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

Window.releaseEvents()

Löst das Fenster aus, um Ereignisse eines bestimmten Typs nicht mehr zu erfassen.

Window.requestFileSystem()

Ermöglicht es einer Webseite oder einer App, Zugriff auf ein Sandbox-Dateisystem für ihre eigene Verwendung zu erhalten.

Window.setImmediate()

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

Window.setResizable()

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

Window.webkitConvertPointFromNodeToPage()

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

Window.webkitConvertPointFromPageToNode()

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

Ereignisse

Hören Sie diese Ereignisse mit addEventListener() ab oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieser Schnittstelle zuweisen. Abgesehen von den unten aufgeführten Ereignissen, können viele Ereignisse von dem Document, das im Fenster-Objekt enthalten ist, hochsteigen.

error

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

languagechange

Ausgelöst beim globalen Bereichsobjekt, wenn sich die bevorzugte Sprache des Benutzers ändert.

resize

Ausgelöst, wenn das Fenster neu dimensioniert wurde.

storage

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

Verbindungs-Ereignisse

offline

Ausgelöst, wenn der Browser den Netzwerkzugang verloren hat und der Wert von navigator.onLine auf false umgeschaltet wurde.

online

Ausgelöst, wenn der Browser den Netzwerkzugang erlangt hat und der Wert von navigator.onLine auf true umgeschaltet wurde.

Geräteorientierungs-Ereignisse

devicemotion Sicherer Kontext

In regelmäßigen Intervallen ausgelöst, um die Menge der physikalischen Beschleunigungskräfte zu zeigen, die das Gerät empfängt und die Rotationsgeschwindigkeit, falls verfügbar.

deviceorientation Sicherer Kontext

Ausgelöst, wenn frische Daten von dem Magnetometer-Orientierungssensor über die aktuelle Orientierung des Geräts im Vergleich zum Erd-Koordinatenrahmen verfügbar sind.

deviceorientationabsolute Sicherer Kontext

Ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor über die aktuelle absolute Orientierung des Geräts im Vergleich zum Erd-Koordinatenrahmen verfügbar sind.

Fokus-Ereignisse

blur

Ausgelöst, wenn ein Element den Fokus verloren hat.

focus

Ausgelöst, wenn ein Element den Fokus erhalten hat.

Gamepad-Ereignisse

gamepadconnected

Ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde oder das erste Mal eine Taste/Achse des Gamepads benutzt wird.

gamepaddisconnected

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

Verlauf-Ereignisse

hashchange

Ausgelöst, wenn sich der Fragment-Identifikator der URL geändert hat (der Teil der URL beginnend mit und folgend nach dem #-Symbol).

pagehide

Gesendet, wenn der Browser das aktuelle Dokument ausblendet, während er dabei ist, ein anderes Dokument aus dem Sitzungssverlauf an dessen Stelle 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 voranzugehen.

pagereveal

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

pageshow

Gesendet, wenn der Browser das Dokument aufgrund von Navigationsaufgaben sichtbar macht, einschließlich nicht nur, wenn die Seite zuerst geladen wird, sondern auch Situationen wie der Benutzer navigiert zurück zur Seite, nachdem er zu einer anderen innerhalb desselben Tabs navigiert ist.

pageswap

Ausgelöst, wenn ein Dokument aufgrund einer Navigation entladen werden soll.

popstate

Ausgelöst, wenn der aktive Verlaufseintrag geändert wird.

Lade- & Entlade-Ereignisse

beforeunload

Ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen fast entladen sind.

load

Ausgelöst, wenn die ganze Seite geladen ist, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.

unload

Ausgelöst, wenn das Dokument oder eine Kindeinheit entladen wird.

Manifest-Ereignisse

appinstalled

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

beforeinstallprompt

Ausgelöst, wenn ein Benutzer kurz davor ist, aufgefordert zu werden, eine Webanwendung zu installieren.

Nachrichten-Ereignisse

message

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

messageerror

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

Druck-Ereignisse

afterprint

Ausgelöst, nachdem das zugehörige Dokument mit dem Drucken oder der Druckvorschau begonnen hat.

beforeprint

Ausgelöst, wenn das zugehörige Dokument gedruckt wird oder zur Druckvorschau bereit ist.

Promise-Ablehnungs-Ereignisse

rejectionhandled

Gesendet, jedes Mal, wenn ein JavaScript Promise abgelehnt wird, unabhängig davon, ob ein Handler darauf wartet, die Ablehnung zu behandeln oder nicht.

unhandledrejection

Gesendet, wenn ein JavaScript Promise abgelehnt wird, aber kein Handler vorhanden ist, der die Ablehnung behandelt.

Scroll-Ereignisse

scrollsnapchange

Ausgelöst beim Scroll-Container nach Abschluss eines Scroll-Vorgangs, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.

scrollsnapchanging

Ausgelöst beim Scroll-Container, wenn der Browser feststellt, dass ein neuer Scroll-Snap-Ziel aussteht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.

Veraltete Ereignisse

orientationchange

Ausgelöst, wenn sich die Orientierung des Geräts ändert.

vrdisplayactivate

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

vrdisplayconnect

Ausgelöst, wenn ein kompatibles VR-Gerät an den Computer angeschlossen wurde.

vrdisplaydisconnect

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

vrdisplaydeactivate

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

vrdisplaypresentchange

Ausgelöst, wenn der Präsentationszustand eines VR-Geräts wechselt — d.h. von präsent zu nicht präsent, oder umgekehrt.

Hochstrebende Ereignisse

Nicht alle Ereignisse, die hochstreben, können das Window-Objekt erreichen. Nur die folgenden tun es und können am Window-Objekt abgehört werden:

Schnittstellen

Siehe DOM-Referenz.

Überwachung von Ereignissen auf Window

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

  • Durch hinzufügen eines Ereignis-Listeners zum Element mithilfe der Methode EventTarget.addEventListener.
  • Durch zuweisen eines Ereignis-Handlers zur oneventname Eigenschaft des Elements in JavaScript.
  • Durch hinzufügen eines on-prefixierten Attributs zum Element im HTML.

Um Ereignisse auf Window-Objekten zu hören, können Sie im Allgemeinen nur die ersten beiden Methoden verwenden, da es kein entsprechendes HTML-Element für Window gibt. Es gibt jedoch eine besondere Gruppe von Ereignissen, bei denen Listener zum <body> (oder dem veralteten <frameset>) Element hinzugefügt werden können, das dem Dokument des Window-Objekts gehört, indem die zweite oder dritte Methode verwendet wird. Diese Ereignisse sind:

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

Das bedeutet, dass die folgenden strikt äquivalent sind:

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

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

Spezifikationen

Spezifikation
HTML
# the-window-object

Browser-Kompatibilität