Fenster

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Die Window-Schnittstelle repräsentiert ein Fenster, das ein DOM-Dokument enthält; die document-Eigenschaft verweist auf das DOM-Dokument, das in diesem Fenster geladen ist.

Ein Fenster für ein bestimmtes Dokument kann über die document.defaultView-Eigenschaft abgerufen 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, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters in Verbindung stehen. Die Window-Schnittstelle ist jedoch ein geeigneter Ort, um diese Elemente, die global verfügbar sein müssen, einzuschließen. Viele dieser Elemente sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.

In einem Tab-basierten Browser wird jeder Tab durch ein eigenes Window-Objekt dargestellt; das globale window, das von JavaScript-Code gesehen wird, der innerhalb eines bestimmten Tabs ausgeführt wird, repräsentiert immer den Tab, in dem der Code ausgeführt wird. Das gesagt, auch in einem Tab-basierten Browser gelten einige Eigenschaften und Methoden weiterhin für das Gesamtfenster, das den Tab enthält, wie zum Beispiel resizeTo() und innerHeight. Allgemein gilt: Alles, was nicht vernünftigerweise auf einen Tab zutreffen kann, bezieht sich auf das Fenster stattdessen.

EventTarget Window

Instanzeigenschaften

Diese Schnittstelle erbt Eigenschaften von der EventTarget-Schnittstelle.

Beachten Sie, dass Eigenschaften, die Objekte sind (zum Beispiel zum Überschreiben des Prototyps eingebauter Elemente), 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 Assets für die 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 gibt an, ob das aktuelle Fenster geschlossen ist oder nicht.

Window.cookieStore Schreibgeschützt Sicherer Kontext

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

Window.credentialless Schreibgeschützt Experimentell

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

Window.crossOriginIsolated Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, ob die Website sich in einem Cross-Origin-Isolation-Zustand 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 Document Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.

Window.fence Schreibgeschützt Experimentell

Gibt eine Instanz eines Fence-Objekts für den aktuellen Dokumentkontext 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 Unterrahmen im aktuellen Fenster zurück.

Window.fullScreen Nicht standardisiert

Diese Eigenschaft gibt 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 eine Möglichkeit für Anwendungen, asynchron auf die Funktionen indizierter Datenbanken zuzugreifen; gibt ein IDBFactory-Objekt zurück.

Window.innerHeight Schreibgeschützt

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

Window.innerWidth Schreibgeschützt

Gibt die Breite des Inhaltsbereichs des Browserfensters einschließlich der vertikalen Bildlaufleiste zurück, falls diese gerendert 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 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 die launchQueue Zugang zur LaunchQueue-Klasse, die es ermöglicht, 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 eine Referenz auf das lokale Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, auf die nur von dem Ursprungsort, der es erstellt hat, zugegriffen werden kann.

Window.location

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

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 Ansichtsbereichs des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln gemeldet. Siehe mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor zur Anpassung an Bildschirm-Pixel, falls erforderlich.

Window.mozInnerScreenY Schreibgeschützt Nicht standardisiert

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

Window.name

Ruft den Namen des Fensters ab oder setzt ihn.

Window.navigation Schreibgeschützt Experimentell

Gibt das mit dem aktuellen window verknüpfte 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 zurück, serialisiert als Zeichenkette.

Window.originAgentCluster Schreibgeschützt

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

Window.outerHeight Schreibgeschützt

Ruft die Höhe außerhalb des Browserfensters ab.

Window.outerWidth Schreibgeschützt

Ruft die Breite außerhalb 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 Unterrahmens zurück.

Window.performance Schreibgeschützt

Gibt ein Performance-Objekt zurück, das die Attribute timing und navigation 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 personalbar-Objekt zurück.

Window.scheduler Schreibgeschützt

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

Window.screen Schreibgeschützt

Gibt eine Referenz auf das screen-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 Benutzer-Browseransichtsbereichs zur linken Seite des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Benutzer-Browseransichtsbereichs zur oberen Seite des Bildschirms zurück.

Window.scrollbars Schreibgeschützt

Gibt das scrollbars-Objekt zurück.

Window.scrollMaxX Nicht standardisiert Schreibgeschützt

Der maximale Versatz, zu dem das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus die Ansichtsbereichsbreite.

Window.scrollMaxY Nicht standardisiert Schreibgeschützt

Der maximale Versatz, zu dem das Fenster vertikal gescrollt werden kann (d.h. die Dokumentenhöhe minus die Ansichtsbereichshö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

Gibt eine Referenz auf das Sitzungspeicherobjekt zurück, das verwendet wird, um Daten zu speichern, auf die nur von dem Ursprungsort, der es erstellt hat, zugegriffen werden kann.

Window.sharedStorage Schreibgeschützt Experimentell Sicherer Kontext

Gibt das WindowSharedStorage-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt, um Daten in einen gemeinsamen Speicher zu schreiben, der die Shared Storage API verwendet.

Window.speechSynthesis Schreibgeschützt

Gibt ein SpeechSynthesis-Objekt zurück, das den Einstieg in die Verwendung der Web Speech API-Sprachsynthesefunktionalität 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 verknüpft ist und den Einstiegspunkt für die Verwendung der Trusted Types API bietet.

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport-Objekt zurück, das den visuellen Ansichtsbereich 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.

Veraltete Eigenschaften

Window.event Veraltet Schreibgeschützt

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

Window.external Veraltet Schreibgeschützt

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

Window.orientation Veraltet Schreibgeschützt

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

Window.status Veraltet

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

Instanzmethoden

Diese Schnittstelle erbt Methoden von der EventTarget-Schnittstelle.

Window.atob()

Dekodiert eine Zeichenfolge von Daten, die mithilfe der Base-64-Codierung kodiert wurde.

Window.alert()

Zeigt ein Warnungsdialogfeld an.

Window.blur() Veraltet

Defokussiert das Fenster.

Window.btoa()

Erstellt eine Base-64-kodierte ASCII-Zeichenfolge aus einer Zeichenfolge von Binärdaten.

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

Window.createImageBitmap()

Akzeptiert eine Vielzahl verschiedener Bildquellen und gibt ein Promise zurück, das sich zu einem ImageBitmap auflöst. Optional wird die Quelle auf das Rechteck von Pixeln beschnitten, das bei (sx, sy) beginnt, mit einer Breite sw und einer Höhe sh.

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 navigiert wird (sie wird zerstört oder betritt den bfcache), oder nach einem angegebenen activateAfter-Timeout — je nachdem, was zuerst eintritt.

Window.find() Nicht standardisiert

Sucht nach einer gegebenen Zeichenkette in einem Fenster.

Window.focus()

Setzt den Fokus auf das aktuelle Fenster.

Window.getComputedStyle()

Holt den berechneten Stil für das angegebene Element. Der berechnete Stil gibt die berechneten Werte aller CSS-Eigenschaften des Elements an.

Window.getDefaultComputedStyle() Nicht standardisiert

Holt den Standard berechneten Stil für das angegebene Element und ignoriert Autoren-Stylesheets.

Window.getScreenDetails() Experimentell Sicherer Kontext

Gibt ein Promise zurück, das sich mit einer ScreenDetails-Objektinstanz auflöst, die die Details aller Bildschirme repräsentiert, die auf dem Gerät des Benutzers verfügbar sind.

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

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 Datenzeichenfolge an ein anderes Fenster sendet, das sich nicht notwendigerweise in derselben Domäne wie das erste befindet.

Window.print()

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

Window.prompt()

Gibt den Text zurück, den der Benutzer in ein Eingabedialogfeld eingegeben hat.

Window.queryLocalFonts() Experimentell Sicherer Kontext

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

Window.queueMicrotask()

Platziert eine Mikrotask in einer Warteschlange, die zu einem sicheren Zeitpunkt vor der Rückgabe der Kontrolle an die Ereignisschleife des Browsers ausgeführt werden soll.

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, einen Neuzeichen der Fenster für den nächsten Animationsrahmen zu planen.

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 dynamisch die Größe des Fensters.

Window.scroll()

Scrollt das Fenster an einen bestimmten Ort 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 bestimmten Satz von Koordinaten im Dokument.

Window.setInterval()

Plant die Ausführung einer Funktion, jedes Mal wenn eine gegebene Anzahl von Millisekunden verstrichen ist.

Window.setTimeout()

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

Window.showDirectoryPicker() Experimentell Sicherer Kontext

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

Window.showOpenFilePicker() Experimentell Sicherer Kontext

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

Window.showSaveFilePicker() Experimentell Sicherer Kontext

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

Window.sizeToContent() Nicht standardisiert

Passt die Fenstergröße entsprechend dem Inhalt an.

Window.stop()

Diese Methode stoppt das Laden des Fensters.

Window.structuredClone()

Erstellt eine tiefgehende Kopie eines gegebenen Wertes unter Verwendung des Structured Clone Algorithmus.

Veraltete Methoden

Window.captureEvents() Veraltet

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

Window.clearImmediate() Nicht standardisiert Veraltet

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

Window.releaseEvents() Veraltet

Lässt das Fenster aufhören, Ereignisse eines bestimmten Typs abzufangen.

Window.requestFileSystem() Nicht standardisiert Veraltet

Ermöglicht es einer Website oder App, Zugriff auf ein sandkastenbasiertes Dateisystem für ihre eigene Nutzung zu erhalten.

Window.setImmediate() Nicht standardisiert Veraltet

Führt eine Funktion aus, nachdem der Browser andere aufwändige Aufgaben beendet hat.

Window.setResizable() Nicht standardisiert Veraltet

Macht nichts (no-op). Beibehalten für die Rückwärtskompatibilität mit Netscape 4.x.

Window.showModalDialog() Nicht standardisiert Veraltet

Zeigt ein modales Dialogfeld an.

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.

Ereignisse

Hören Sie diese Ereignisse mit addEventListener() oder durch Zuweisen eines Ereignislisteners zur oneventname-Eigenschaft dieser Schnittstelle ab. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse aus dem im Fensterobjekt enthaltenen Document aufsteigen.

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 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.

Zwischenablage-Ereignisse

copy

Wird ausgelöst, wenn der Benutzer eine Kopieraktion über die Benutzeroberfläche des Browsers initiiert. Auch über die oncopy-Eigenschaft verfügbar.

cut

Wird ausgelöst, wenn der Benutzer eine Ausschneideaktion über die Benutzeroberfläche des Browsers initiiert. Auch über die oncut-Eigenschaft verfügbar.

paste

Wird ausgelöst, wenn der Benutzer eine Einfügeaktion über die Benutzeroberfläche des Browsers initiiert. Auch über die onpaste-Eigenschaft verfügbar.

Verbindung-Ereignisse

offline

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

online

Wird ausgelöst, wenn der Browser den Netzwerkzugang wiederhergestellt hat und der Wert von navigator.onLine auf true gewechselt hat.

Geräteausrichtungen-Ereignisse

devicemotion Sicherer Kontext

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

deviceorientation Sicherer Kontext

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

deviceorientationabsolute Sicherer Kontext

Wird ausgelöst, wenn neue Daten vom Magnetometer-Ausrichtungssensor über die aktuelle absolute Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen 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 angeschlossen wurde oder das erste Mal, dass eine Taste/ein Achse des Gamepads verwendet wird.

gamepaddisconnected

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

Verlaufs-Ereignisse

hashchange

Wird ausgelöst, wenn sich der Fragmentbezeichner der URL geändert hat (der Teil der URL, der mit # beginnt und darauf folgt).

pagehide

Wird gesendet, wenn der Browser das aktuelle Dokument versteckt, während er dabei ist, ein anderes Dokument aus dem Sitzungsverlauf an seiner Stelle anzuzeigen. Dies passiert zum Beispiel, wenn der Benutzer die Zurück-Schaltfläche klickt oder wenn er die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf voranzugehen.

pagereveal

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

pageshow

Wird gesendet, wenn der Browser das Dokument aufgrund von Navigation tasks sichtbar macht, einschließlich nicht nur beim ersten Laden der Seite, sondern auch Situationen wie der Benutzer kehrt zur Seite zurück, nachdem er zu einem anderen innerhalb desselben Tabs navigiert hat.

pageswap

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

popstate

Wird ausgelöst, wenn der aktuelle Eintrag in der Verlaufshistorie sich ändert.

Lade- & Entlade-Ereignisse

beforeunload

Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen dabei sind, entladen zu werden.

load

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

unload Veraltet

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

Manifest-Ereignisse

appinstalled

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

beforeinstallprompt

Wird ausgelöst, wenn ein Benutzer dabei ist, aufgefordert zu werden, eine Webanwendung zu installieren.

Nachrichten-Ereignisse

message

Wird ausgelöst, wenn das Fenster eine Nachricht erhält, zum Beispiel von einem Aufruf an 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 mit dem Drucken begonnen hat oder die Druckvorschau geschlossen wurde.

beforeprint

Wird ausgelöst, wenn das zugehörige Dokument gedruckt werden soll oder zur Druckvorschau bereit ist.

Promise-Ablehnungsereignisse

rejectionhandled

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

unhandledrejection

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

Scroll-Ereignisse

scrollsnapchange Experimentell

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

scrollsnapchanging Experimentell

Wird am Scrollcontainer ausgelöst, wenn der Browser ein neues Scrollsnap-Ziel bestimmt, das in Aussicht steht, d.h. ausgewählt wird, wenn die aktuelle Scrollgeste endet.

Veraltete Ereignisse

orientationchange Veraltet

Wird ausgelöst, wenn sich die Orientierung 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 Darstellungszustand eines VR-Geräts ändert - d.h. von Darstellen zu Nicht-Darstellen wechselt oder umgekehrt.

Aufgestiegene Ereignisse

Schnittstellen

Ereignisabhörung auf Window

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

  • Fügen Sie einen Ereignislistener zu dem Element hinzu, indem Sie die Methode EventTarget.addEventListener verwenden.
  • Weisen Sie einen Ereignishandler der Eigenschaft oneventname des Elements in JavaScript zu.
  • Fügen Sie dem Element im HTML ein Attribut mit on-Präfix 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 spezielle Gruppe von Ereignissen, deren Listener zum <body> (oder dem veralteten <frameset>) Element hinzugefügt werden können, das dem Dokument des Window gehört, mit der zweiten oder dritten Methode. 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 strikt 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

Specification
HTML
# the-window-object

Browser-Kompatibilität