Window

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 mit der document.defaultView-Eigenschaft abgerufen werden.

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

Die Window-Schnittstelle beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Allerdings ist die Window-Schnittstelle ein geeigneter Ort, um Elemente aufzunehmen, die global verfügbar sein müssen. Viele dieser Elemente sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.

In einem Browser mit Registerkarten wird jede Registerkarte durch ein eigenes Window-Objekt repräsentiert; das globale window, das vom JavaScript-Code in einer bestimmten Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code läuft. Nichtsdestotrotz gelten in einem Browser mit Registerkarten einige Eigenschaften und Methoden weiterhin für das gesamte Fenster, das die Registerkarte enthält, wie zum Beispiel resizeTo() und innerHeight. Im Allgemeinen beziehen sich alle Dinge, die nicht vernünftigerweise auf eine Registerkarte zutreffen können, auf das Fenster.

EventTarget Window

Instanzeigenschaften

Diese Schnittstelle erbt Eigenschaften von der EventTarget-Schnittstelle.

Beachten Sie, dass Eigenschaften, die Objekte sind (z.B. für das Ü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 für die Offline-Nutzung und das Erstellen 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 auf das CookieStore-Objekt für den aktuellen Dokumentkontext zurück.

Window.credentialless Schreibgeschützt Experimentell

Gibt einen booleschen Wert zurück, der anzeigt, ob das aktuelle Dokument innerhalb eines credentialless <iframe> geladen wurde. Weitere Details siehe IFrame credentialless.

Window.crossOriginIsolated Schreibgeschützt

Gibt einen booleschen Wert zurück, der anzeigt, ob die Website sich in einem cross-origin-Isolationszustand 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 bereits 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 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 Fence-Objektinstanz für den aktuellen Dokumentkontext zurück. Nur verfügbar für in einem <fencedframe> eingebettete Dokumente.

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 Unterfenster 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 Verlauf-Objekt zurück.

Window.indexedDB Schreibgeschützt

Bietet eine Möglichkeit für Anwendungen, asynchron auf die Funktionen von indizierten Datenbanken zuzugreifen; gibt ein IDBFactory-Objekt zurück.

Window.innerHeight Schreibgeschützt

Ruft die Höhe des Inhaltsbereichs des Browserfensters ab, einschließlich des horizontalen Scrollbalkens, falls gerendert.

Window.innerWidth Schreibgeschützt

Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich des vertikalen Scrollbalkens, falls gerendert.

Window.isSecureContext Schreibgeschützt

Gibt einen booleschen Wert zurück, der angibt, 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 die launchQueue Zugriff auf die LaunchQueue-Klasse, die es ermöglicht, benutzerdefinierte Startnavigationshandhabung für die PWA zu implementieren.

Window.length Schreibgeschützt

Gibt die Anzahl der Rahmen 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 von der Ursprungsquelle, die sie erstellt hat, abgerufen werden können.

Window.location

Ruft den Speicherort oder die aktuelle URL des Fensterobjekts ab/setzt diese.

Window.locationbar Schreibgeschützt

Gibt das Standortleistenobjekt zurück.

Window.menubar Schreibgeschützt

Gibt das Menüleistenobjekt zurück.

Window.mozInnerScreenX Schreibgeschützt Nicht standardisiert

Gibt die horizontale (X) Koordinate der oberen linken Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixel gemeldet. Siehe mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel umzuwandeln.

Window.mozInnerScreenY Schreibgeschützt Nicht standardisiert

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

Window.name

Ruft den Namen des Fensters ab/setzt diesen.

Window.navigation Schreibgeschützt Experimentell

Gibt das Navigation-Objekt zurück, das mit dem aktuellen window verbunden ist. Der Einstiegspunkt für die Navigation API.

Window.navigator Schreibgeschützt

Gibt eine Referenz auf das Navigatorobjekt 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 serialisiert zurück.

Window.originAgentCluster Schreibgeschützt

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

Window.outerHeight Schreibgeschützt

Ruft die Höhe des Außenbereichs des Browserfensters ab.

Window.outerWidth Schreibgeschützt

Ruft die Breite des Außenbereichs 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, die jeweils ein Objekt sind, das leistungsbezogene Daten bereitstellt. Weitere Informationen und Beispiele finden Sie unter Verwendung der Navigation-Timing.

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 zur Verwendung der Priorisierten Aufgabenplanungs-API.

Window.screen Schreibgeschützt

Gibt eine Referenz auf das Bildschirmobjekt zurück, das dem Fenster zugeordnet ist.

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Browser-Viewports des Benutzers zur linken Seite des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Browser-Viewports des Benutzers zur oberen Seite des Bildschirms zurück.

Window.scrollbars Schreibgeschützt

Gibt das Scrollbalkenobjekt zurück.

Window.scrollMaxX Nicht standardisiert Schreibgeschützt

Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus die Viewport-Breite.

Window.scrollMaxY Nicht standardisiert Schreibgeschützt

Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus die 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 Sitzungs-Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur von der Ursprungsquelle, die sie erstellt hat, abgerufen werden können.

Window.sharedStorage Schreibgeschützt Experimentell 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 gemeinsam genutzten Speicher mithilfe der Shared Storage API.

Window.speechSynthesis Schreibgeschützt

Gibt ein SpeechSynthesis-Objekt zurück, das den Einstiegspunkt in das Verwenden der Sprachsynthesefunktionalität der Web Speech API darstellt.

Window.statusbar Schreibgeschützt

Gibt das Statusleistenobjekt zurück.

Window.toolbar Schreibgeschützt

Gibt das Werkzeugleistenobjekt 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 verbunden 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 Viewport 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 siehe Window.frames.

Veraltete Eigenschaften

Window.event Veraltet Schreibgeschützt

Gibt das aktuelle Ereignis zurück, das momentan vom JavaScript-Code bearbeitet wird, oder undefined, falls momentan kein Ereignis bearbeitet wird. Das direkt an Ereignishandler übergebene Event-Objekt sollte stattdessen wann immer möglich verwendet 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 Ausrichtung in Grad (in 90-Grad-Schritten) des Viewports im Vergleich zur natürlichen Ausrichtung des Geräts zurück.

Window.status Veraltet

Ruft den Text in der Statusleiste am unteren Rand des Browsers ab/setzt diesen.

Instanzmethoden

Diese Schnittstelle erbt Methoden von der EventTarget-Schnittstelle.

Window.atob()

Dekodiert einen Datenstring, der mit base-64-Codierung kodiert wurde.

Window.alert()

Zeigt ein Alarmdialogfeld an.

Window.blur() Veraltet

Entfernt den Fokus vom Fenster.

Window.btoa()

Erstellt einen base-64-codierten ASCII-String aus einem String mit Binärdaten.

Window.cancelAnimationFrame()

Ermöglicht es, einen zuvor mit Window.requestAnimationFrame geplanten Rückruf abzubrechen.

Window.cancelIdleCallback()

Ermöglicht es, einen zuvor mit Window.requestIdleCallback geplanten Rückruf abzubrechen.

Window.clearInterval()

Bricht die wiederholte Ausführung ab, die mit Window.setInterval() festgelegt wurde.

Window.clearTimeout()

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

Window.close()

Schließt das aktuelle Fenster.

Window.confirm()

Zeigt ein Dialogfenster mit einer Nachricht an, auf die der Benutzer antworten muss.

Window.createImageBitmap()

Akzeptiert eine Vielzahl von verschiedenen Bildquellen und gibt ein Promise zurück, das auf ein ImageBitmap aufgelöst wird. Optional wird die Quelle auf das Rechteck von Pixeln zugeschnitten, 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 (sie wird zerstört oder tritt in den bfcache ein) oder nach einem angegebenen activateAfter-Timeout — je nachdem, was zuerst eintritt.

Window.find() Nicht standardisiert

Sucht nach einer gegebenen Zeichenfolge 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 Autorenstile ignoriert werden.

Window.getScreenDetails() Experimentell Sicherer Kontext

Gibt ein Promise zurück, das mit einem ScreenDetails-Objekt instanziiert 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 die ausgewählten Elemente repräsentiert.

Window.matchMedia()

Gibt ein MediaQueryList-Objekt zurück, das die angegebenen Mediaquery-Zeichenfolgen 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 Datenkette an ein anderes Fenster sendet, das nicht innerhalb derselben Domäne wie das erste liegen muss.

Window.print()

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

Window.prompt()

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

Window.queryLocalFonts() Experimentell Sicherer Kontext

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

Window.queueMicrotask()

Stellt einen Mikrotask in die Warteschlange, der zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle zur Ereignisschleife des Browsers ausgeführt wird.

Window.reportError()

Meldet einen Fehler in einem Skript, indem eine unbehandelte Ausnahme emuliert wird.

Window.requestAnimationFrame()

Signalisiert dem Browser, dass eine Animation im Gange ist, und beantragt, dass der Browser das Fenster für den nächsten Animationsframe neu zeichnet.

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 einem 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 bestimmte Anzahl von Millisekunden vergeht.

Window.setTimeout()

Plant die Ausführung einer Funktion zu einem bestimmten Zeitpunkt.

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 Dateiwähler an, mit dem ein Benutzer eine oder mehrere Dateien auswählen kann.

Window.showSaveFilePicker() Experimentell Sicherer Kontext

Zeigt einen Dateiwähler an, mit dem ein Benutzer eine Datei speichern kann.

Window.sizeToContent() Nicht standardisiert

Passt die Größe des Fensters basierend auf seinem Inhalt an.

Window.stop()

Diese Methode stoppt das Laden des Fensters.

Window.structuredClone()

Erstellt eine tiefergehende Kopie eines bestimmten Werts mithilfe des strukturierten Klonalternatives.

Veraltete Methoden

Window.captureEvents() Veraltet

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

Window.clearImmediate() Nicht standardisiert Veraltet

Bricht die wiederholte Ausführung ab, die mit setImmediate() festgelegt wurde.

Window.releaseEvents() Veraltet

Löst das Fenster aus der Erfassung von Ereignissen eines bestimmten Typs.

Window.requestFileSystem() Nicht standardisiert Veraltet

Ermöglicht es einer Website oder App, auf ein sandkastiertes Dateisystem für den eigenen Gebrauch zuzugreifen.

Window.setImmediate() Nicht standardisiert Veraltet

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

Window.setResizable() Nicht standardisiert Veraltet

Tut nichts (no-op). Wird aus Kompatibilitätsgründen mit Netscape 4.x beibehalten.

Window.webkitConvertPointFromNodeToPage() Nicht standardisiert Veraltet

Transformiert einen WebKitPoint aus dem Koordinatensystem des Knotens in das Koordinatensystem der Seite.

Window.webkitConvertPointFromPageToNode() Nicht standardisiert Veraltet

Transformiert einen WebKitPoint aus dem Koordinatensystem der Seite in das Koordinatensystem des Knotens.

Ereignisse

Hören Sie auf diese Ereignisse mit addEventListener() oder indem Sie einen Ereignishandler der oneventname-Eigenschaft dieser Schnittstelle zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom Document gebubbelt werden, das im Fensterobjekt enthalten ist.

error

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

languagechange

Wird im globalen Scope-Objekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.

resize

Wird ausgelöst, wenn das Fenster in der Größe geändert wurde.

storage

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

Verbindungsevents

offline

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

online

Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk wiedererlangt hat und der Wert von navigator.onLine auf true umgeschaltet wurde.

Gerätorientierungsevents

devicemotion Sicherer Kontext

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

deviceorientation Sicherer Kontext

Wird ausgelöst, wenn neue Daten vom Magnetometer-Orientierungssensor zur aktuellen Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.

deviceorientationabsolute Sicherer Kontext

Wird ausgelöst, wenn neue Daten vom Magnetometer-Orientierungssensor zur aktuellen absoluten Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.

Fokusevents

blur

Wird ausgelöst, wenn ein Element den Fokus verloren hat.

focus

Wird ausgelöst, wenn ein Element den Fokus erhalten hat.

Gamepad-Events

gamepadconnected

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

gamepaddisconnected

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

Verlaufsevents

hashchange

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

pagehide

Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während es dabei ist, ein anderes Dokument aus dem Sitzungsverlauf anzuzeigen. Dies geschieht beispielsweise, wenn der Benutzer auf die Zurück-Schaltfläche klickt oder wenn er auf die Weiter-Schaltfläche klickt, um im Sitzungsverlauf vorwärts zu gehen.

pagereveal

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

pageshow

Wird gesendet, wenn der Browser das Dokument aufgrund von Navigationstasks sichtbar macht, einschließlich nicht nur, wenn die Seite zum ersten Mal geladen wird, sondern auch Situationen, wie wenn der Benutzer zur Seite zurückkehrt, nachdem er zu einer anderen innerhalb desselben Tabs navigiert ist.

pageswap

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

popstate

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

Lade- & Entladeereignisse

beforeunload

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

load

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

unload Veraltet

Wird ausgelöst, wenn das Dokument oder eine Kindressource 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 kurz davor ist, aufgefordert zu werden, eine Webanwendung zu installieren.

Nachrichtenereignisse

message

Wird ausgelöst, wenn das Fenster eine Nachricht empfängt, z.B. von einem Aufruf von Window.postMessage() von 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 vor dem Ausdrucken oder der Vorschau steht.

Promise-Ablehnungsereignisse

rejectionhandled

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

unhandledrejection

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

Scrollevents

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. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.

Veraltete Ereignisse

orientationchange Veraltet

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

vrdisplayactivate Veraltet Nicht standardisiert

Wird ausgelöst, wenn ein Display bereitgestellt 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 bereitgestellt werden kann.

vrdisplaypresentchange Veraltet Nicht standardisiert

Wird ausgelöst, wenn sich der Präsentationszustand eines VR-Geräts ändert — d.h. von präsentierend zu nicht präsentierend wechselt oder umgekehrt.

Gebubbelte Ereignisse

Schnittstellen

Über Events auf Window hören

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

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

Um auf Ereignisse bei Window-Objekten zu hören, können Sie im Allgemeinen nur die ersten zwei Methoden verwenden, da Window kein entsprechendes HTML-Element hat. Allerdings gibt es eine spezifische Gruppe von Ereignissen, deren Listener dem <body> (oder dem veralteten <frameset>) Element hinzugefügt werden können, das dem von Windows Dokument gehört, unter Verwendung 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

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

Spezifikationen

Specification
HTML
# the-window-object

Browser-Kompatibilität