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.

Das Window-Interface repräsentiert ein Fenster, das ein DOM-Dokument enthält; Die document-Eigenschaft verweist auf das im Fenster geladene DOM-Dokument.

Ein Fenster für ein bestimmtes Dokument kann über die document.defaultView-Eigenschaft abgerufen werden.

Eine globale Variable, window, die das Fenster darstellt, in dem das Skript ausgeführt wird, wird im JavaScript-Code bereitgestellt.

Das Window-Interface ist die Heimat einer Vielzahl von Funktionen, Namensräumen, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Trotzdem ist das Window-Interface ein geeigneter Ort, um diese Elemente aufzunehmen, die global verfügbar sein müssen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.

In einem Tabbed-Browser wird jeder Tab durch ein eigenes Window-Objekt dargestellt; das globale window, das der JavaScript-Code sieht, läuft immer innerhalb des Tabs, in dem der Code läuft. Dennoch gelten auch in einem Tabbed-Browser einige Eigenschaften und Methoden für das gesamte Fenster, das den Tab enthält, wie etwa resizeTo() und innerHeight. Im Allgemeinen gilt alles, was nicht vernünftigerweise für einen Tab gelten kann, stattdessen für das Fenster.

EventTarget Window

Instanzeigenschaften

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 verknüpft ist. Dieses Objekt ermöglicht Funktionen wie 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 zeigt an, ob das aktuelle Fenster geschlossen ist oder nicht.

Window.cookieStore Schreibgeschützt Sicherer Kontext

Gibt einen Verweis 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 Meldeendpunkt gesendet werden, wenn ein Browser-Absturz auftritt.

Window.credentialless Schreibgeschützt

Gibt ein boolean zurück, das angibt, ob das aktuelle Dokument in einem credentialless <iframe> geladen wurde. Siehe IFrame credentialless für weitere Details.

Window.crossOriginIsolated Schreibgeschützt

Gibt ein boolean zurück, das angibt, 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 einen Verweis 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 im aktuellen Display zurück.

Window.document Schreibgeschützt

Gibt einen Verweis auf das Dokument zurück, das das Fenster enthält.

Window.documentPictureInPicture Schreibgeschützt Sicherer Kontext

Gibt einen Verweis auf das document Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.

Window.fence Schreibgeschützt

Gibt eine Fence-Objektexemplar 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 Unterrahmen 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 einen Verweis auf das Verlauf-Objekt zurück.

Window.indexedDB Schreibgeschützt

Bietet eine Möglichkeit für Anwendungen, asynchron auf Fähigkeiten indizierter Datenbanken zuzugreifen; gibt ein IDBFactory-Objekt zurück.

Window.innerHeight Schreibgeschützt

Ruft die Höhe des Inhaltsbereichs des Browserfensters ab, einschließlich, wenn gerendert, der horizontalen Bildlaufleiste.

Window.innerWidth Schreibgeschützt

Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich, wenn gerendert, der vertikalen Bildlaufleiste.

Window.isSecureContext Schreibgeschützt

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

Window.launchQueue Schreibgeschützt

Wenn eine fortschrittliche 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 Startnavigation für die PWA zu implementieren.

Window.length Schreibgeschützt

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

Window.localStorage Schreibgeschützt

Gibt einen Verweis auf das lokale Speicherobjekt zurück, das Daten speichert, die nur vom Urheber, der es erstellt hat, abgerufen werden können.

Window.location

Ruft den Standort ab oder legt den aktuellen URL des Fensterobjekts 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 Fensters im Ansichtsbereich in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor, um bei Bedarf an Bildschirm-Pixel anzupassen.

Window.mozInnerScreenY Schreibgeschützt

Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Fensters im Ansichtsbereich in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel für einen Umrechnungsfaktor, um bei Bedarf an Bildschirm-Pixel anzupassen.

Window.name

Ruft den Namen des Fensters ab oder legt ihn fest.

Window.navigation Schreibgeschützt

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

Window.navigator Schreibgeschützt

Gibt einen Verweis auf das navigator-Objekt zurück.

Window.opener

Gibt einen Verweis auf das Fenster zurück, das dieses aktuelle Fenster geöffnet hat.

Window.origin Schreibgeschützt

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

Window.originAgentCluster Schreibgeschützt

Gibt true zurück, wenn dieses Fenster zu einem ursprungs-gebundenen Agentencluster gehört.

Window.outerHeight Schreibgeschützt

Ruft die Höhe der Außenseite des Browserfensters ab.

Window.outerWidth Schreibgeschützt

Ruft die Breite der Außenseite 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 einen Verweis auf das übergeordnete Fenster des aktuellen Fensters oder Unterrahmens zurück.

Window.performance Schreibgeschützt

Gibt ein Performance-Objekt zurück, das die timing und navigation Attribute enthält, die jeweils ein Objekt sind, das leistungsbezogene Daten bereitstellt. Siehe auch Verwenden der Navigation 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 Prioritized Task Scheduling API.

Window.screen Schreibgeschützt

Gibt einen Verweis auf das mit dem Fenster verbundene Bildschirmobjekt zurück.

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben die horizontale Distanz von der linken Grenze des Ansichtsbereichs des Benutzers bis zur linken Seite des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben die vertikale Distanz von der oberen Grenze des Ansichtsbereichs des Benutzers bis zur oberen Seite 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, d.h. die Dokumentbreite minus die Ansichtsbreite.

Window.scrollMaxY Schreibgeschützt

Der maximale Versatz, zu dem das Fenster vertikal gescrollt werden kann (d.h. die Dokumenhöhe minus die Ansichtshö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 einen Objektverweis auf das Fensterobjekt selbst zurück.

Window.sessionStorage

Gibt einen Verweis auf das Sitzungsspeicherobjekt zurück, das Daten speichert, die nur von der Ursprungsadresse 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 gemeinsamen Speicher mithilfe der Shared Storage API.

Window.speechSynthesis Schreibgeschützt

Gibt ein SpeechSynthesis-Objekt zurück, das den Einstiegspunkt in die Verwendung 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 einen Verweis 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 verbunden ist und den Einstiegspunkt für die Verwendung der Trusted Types API bietet.

Window.viewport Schreibgeschützt

Gibt eine Viewport-Objektexemplar zurück, die Informationen über den aktuellen Zustand des Ansichtsbereichs des Geräts liefert.

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport-Objekt zurück, das den visuellen Ansichtsbereich für ein gegebenes Fenster repräsentiert.

Window.window Schreibgeschützt

Gibt einen Verweis auf das aktuelle Fenster zurück.

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

Gibt einen Verweis 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 verfügbar gemacht:

  • Für jedes <embed>, <form>, <iframe>, <img> und <object>-Element wird der name (wenn nicht leer) verfügbar gemacht. Zum Beispiel, wenn das Dokument <form name="my_form"> enthält, dann gibt window["my_form"] (und das äquivalente window.my_form) einen Verweis auf dieses Element zurück.
  • Für jedes HTML-Element wird die id (wenn 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 Schreibgeschützt

Gibt das aktuelle Ereignis zurück, welches das Ereignis ist, das momentan im JavaScript-Kontext verarbeitet wird, oder undefined, wenn momentan kein Ereignis verarbeitet wird. Das direkt an die Ereignishandler übergebene Event-Objekt sollte stattdessen wann immer möglich verwendet werden.

Window.external Schreibgeschützt

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

Window.orientation Schreibgeschützt

Gibt die Orientierung in Grad zurück (in 90-Grad-Schritten) des Ansichtsbereichs im Verhältnis zur natürlichen Orientierung des Geräts.

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 Zeichenkette von Daten, die unter Verwendung der Basis-64-Codierung codiert wurde.

Window.alert()

Zeigt einen Alert-Dialog an.

Window.blur()

Setzt den Fokus vom Fenster weg.

Window.btoa()

Erstellt eine ASCII-Zeichenkette, die mithilfe von Basis-64-Codierung aus einer Binärdaten-Zeichenkette codiert wurde.

Window.cancelAnimationFrame()

Ermöglicht das Abbrechen eines zuvor mit Window.requestAnimationFrame geplanten Rückrufs.

Window.cancelIdleCallback()

Ermöglicht das Abbrechen eines zuvor geplanten Rückrufs mit Window.requestIdleCallback.

Window.clearInterval()

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

Window.clearTimeout()

Hebt die verzögerte Ausführung auf, die mit Window.setTimeout() eingestellt 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()

Akzeptiert eine Vielzahl verschiedener Bildquellen und gibt eine Promise zurück, die in einem ImageBitmap aufgelöst wird. Optional wird die Quelle auf das Rechteck von Pixeln zugeschnitten, die an (sx, sy) mit der Breite sw und der Höhe sh ihren Ursprung haben.

Window.dump()

Schreibt eine Nachricht in die Konsole.

Window.fetch()

Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.

Window.fetchLater()

Erstellt einen zurückgestellten Abruf, der gesendet wird, sobald die Seite verlassen wird (sie zerstört wird oder in den bfcache eintritt), oder nach einem angegebenen activateAfter-Timer — was auch immer zuerst eintritt.

Window.find()

Sucht in einem Fenster nach einer gegebenen Zeichenkette.

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, wobei Autoren-Stylesheets ignoriert werden.

Window.getScreenDetails() Sicherer Kontext

Gibt eine Promise zurück, die sich mit einem ScreenDetails-Objektexemplar erfüllt, das die Details aller Bildschirme bereitstellt, 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) repräsentiert.

Window.matchMedia()

Gibt ein MediaQueryList-Objekt zurück, das die angegebene Media-Query-Zeichenkette repräsentiert.

Window.moveBy()

Verschiebt das aktuelle Fenster um einen angegebenen Betrag.

Window.moveTo()

Verschiebt das Fenster zu den angegebenen Koordinaten.

Window.open()

Öffnet ein neues Fenster.

Window.postMessage()

Bietet eine sichere Möglichkeit, dass ein Fenster eine Zeichenkette von Daten an ein anderes Fenster sendet, das nicht in derselben Domain wie das erste sein muss.

Window.print()

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

Window.prompt()

Gibt den vom Benutzer in einem Eingabefeld eines Dialogs eingegebenen Text zurück.

Window.queryLocalFonts() Sicherer Kontext

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

Window.queueMicrotask()

Wartet einen Mikroauftrag ein, um zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle in die Ereignisschleife des Browsers ausgeführt zu werden.

Window.reportError()

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

Window.requestAnimationFrame()

Teilt dem Browser mit, 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 Ruhezeiten eines Browsers.

Window.requestResize()

Aktualisiert die Größeninformationen, die von einem eingebetteten Dokument mit seinem einbettenden übergeordneten Element geteilt werden, jedoch nur, wenn das eingebettete Dokument sich entschieden hat, seine Größeninformationen zu teilen.

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 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 zur Ausführung, jedes Mal wenn eine angegebene Anzahl von Millisekunden vergangen ist.

Window.setTimeout()

Plant eine Funktion zur Ausführung nach einer bestimmten Zeitspanne.

Window.showDirectoryPicker() Sicherer Kontext

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

Window.showOpenFilePicker() Sicherer Kontext

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

Window.showSaveFilePicker() Sicherer Kontext

Zeigt einen Dateiauswahldialog an, der dem Benutzer ermöglicht, eine Datei zu speichern.

Window.sizeToContent()

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 gegebenen Wertes unter Verwendung des Strukturklon-Algorithmus.

Veraltete Methoden

Window.captureEvents()

Registriert das Fenster, um alle Ereignisse des angegebenen Typs zu erfassen.

Window.clearImmediate()

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

Window.releaseEvents()

Gibt das Fenster frei, um Ereignisse eines bestimmten Typs abzufangen.

Window.requestFileSystem()

Ermöglicht einer Website oder App, Zugriff auf ein sandboxed Dateisystem für eigenen Gebrauch zu erhalten.

Window.setImmediate()

Führt eine Funktion aus, nachdem der Browser andere schwere Aufgaben beendet hat.

Window.setResizable()

Macht nichts (no-op). Wird für Rückwä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 auf diese Ereignisse, indem Sie addEventListener() verwenden oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom Document, das sich im Fensterobjekt befindet, nach oben blubbern.

error

Wird ausgelöst, wenn eine Ressource nicht geladen werden kann 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

Wird am 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 geändert wurde.

Verbindung-Ereignisse

offline

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

online

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

Geräteorientierungs-Ereignisse

devicemotion Sicherer Kontext

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

deviceorientation Sicherer Kontext

Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor über die aktuelle Ausrichtung des Geräts im Vergleich zum Erdkordinatensystem verfügbar sind.

deviceorientationabsolute Sicherer Kontext

Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor über die aktuelle absolute Ausrichtung des Geräts im Vergleich zum Erdkordinatensystem verfügbar sind.

Fokus-Ereignisse

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 das erste Mal ein Knopf/Achse des Gamepads benutzt wird.

gamepaddisconnected

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

Verlaufs-Ereignisse

hashchange

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

pagehide

Wird gesendet, wenn der Browser das aktuelle Dokument versteckt, während im Prozess des Wechsels zur Anzeige eines anderen Dokuments aus der Sitzungshistorie. Dies geschieht zum Beispiel, wenn der Benutzer die Zurück-Schaltfläche klickt oder wenn er die Vorwärts-Schaltfläche klickt, um in der Sitzungshistorie weiter zu navigieren.

pagereveal

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

pageshow

Wird gesendet, wenn der Browser das Dokument durch Navigationsaufgaben sichtbar macht, einschließlich nicht nur, wenn die Seite erstmals geladen wird, sondern auch, wenn der Benutzer zur Seite zurücknavigiert, nachdem er zu einer anderen innerhalb desselben Tabs navigiert hat.

pageswap

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

popstate

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

Lade- & Entlade-Ereignisse

beforeunload

Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen kurz davor stehen, entladen zu werden.

load

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

unload

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

Manifest-Ereignisse

appinstalled

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

beforeinstallprompt

Wird ausgelöst, wenn ein Benutzer darauf hingewiesen wird, eine Webanwendung zu installieren.

Nachrichten-Ereignisse

message

Wird ausgelöst, wenn das Fenster eine Nachricht empfängt, etwa 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.

Druck-Ereignisse

afterprint

Wird ausgelöst, nachdem das zugehörige Dokument gedruckt wurde oder die Druckvorschau geschlossen wurde.

beforeprint

Wird ausgelöst, wenn das zugehörige Dokument gedruckt wird oder zur Druckvorschau vorbereitet wird.

Promise-Abweisungs-Ereignisse

rejectionhandled

Wird gesendet, jedes Mal wenn ein JavaScript-Promise abgelehnt wird, egal 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.

Scroll-Ereignisse

scrollsnapchange

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

scrollsnapchanging

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

Veraltete Ereignisse

orientationchange

Wird ausgelöst, wenn sich die Ausrichtung des Geräts geändert hat.

vrdisplayactivate

Wird ausgelöst, wenn ein Display zur Darstellung bereit ist.

vrdisplayconnect

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

vrdisplaydisconnect

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

vrdisplaydeactivate

Wird ausgelöst, wenn ein Display nicht mehr dargestellt werden kann.

vrdisplaypresentchange

Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert — d.h. von der Darstellung zur Nichtdarstellung oder umgekehrt.

Gebubbelte Ereignisse

Nicht alle Ereignisse, die gebubbelt werden, können das Window-Objekt erreichen. Nur die folgenden können dies tun und können auf dem Window-Objekt abgehört werden:

Schnittstellen

Siehe DOM-Referenz.

Ereignisse auf Window hören

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

  • Fügen Sie dem Element einen Ereignis-Listener mit der Methode EventTarget.addEventListener hinzu.
  • Weisen Sie dem Element einen Ereignis-Handler in JavaScript zu dessen oneventname-Eigenschaft zu.
  • Fügen Sie dem Element im HTML ein on-präfixiertes Attribut hinzu.

Um Ereignisse auf Window-Objekten zu hören, 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 dem <body>-Element (oder dem veralteten <frameset>-Element), das im Dokument des Window enthalten ist, mit der zweiten oder dritten Methode hinzugefügt werden können. 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

Dies bedeutet, dass die folgenden im Wesentlichen gleichwertig 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 geloggt.

Spezifikationen

Spezifikation
HTML
# the-window-object

Browser-Kompatibilität