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 Widely available *

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

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

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

Ein Fenster für ein bestimmtes Dokument kann mit der document.defaultView Eigenschaft abgerufen werden.

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

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

In einem Browser mit Registerkarten wird jede Registerkarte durch ihr eigenes Window-Objekt dargestellt; das globale window, das JavaScript-Code innerhalb einer bestimmten Registerkarte sieht, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Auch in einem Browser mit Registerkarten gelten einige Eigenschaften und Methoden weiterhin für das übergeordnete Fenster, das die Registerkarte enthält, wie resizeTo() und innerHeight. Im Allgemeinen bezieht sich alles, was nicht vernünftigerweise mit einer Registerkarte in Verbindung gebracht werden kann, stattdessen auf 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 Assets für die Offline-Nutzung und die Erstellung 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 zum CookieStore-Objekt für den aktuellen Dokumentkontext zurück.

Window.credentialless Schreibgeschützt Experimentell

Gibt einen Boolean zurück, der anzeigt, ob das aktuelle Dokument innerhalb eines credentialless <iframe> geladen wurde. Weitere Details finden Sie unter IFrame Credentialless.

Window.crossOriginIsolated Schreibgeschützt

Gibt einen Boolean-Wert zurück, der angibt, 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 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 Fence-Objektinstanz für den aktuellen Dokumentkontext zurück. Nur verfügbar für Dokumente, die in ein <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 zeigt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.

Window.history Schreibgeschützt

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

Window.indexedDB Schreibgeschützt

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

Window.innerHeight Schreibgeschützt

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

Window.innerWidth Schreibgeschützt

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

Window.isSecureContext Schreibgeschützt

Gibt einen Boolean zurück, der anzeigt, ob der aktuelle Kontext sicher (true) oder unsicher (false) ist.

Window.launchQueue Schreibgeschützt Experimentell

Wenn eine progressive Web-App (PWA) gestartet wird, mit einem launch_handler client_mode-Wert von focus-existing, navigate-new oder navigate-existing, bietet die launchQueue Zugriff auf die LaunchQueue-Klasse, die es ermöglicht, benutzerdefinierte Start-Navigationsverwaltung 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, auf die nur von der Herkunft zugegriffen werden kann, die diese erstellt hat.

Window.location

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

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 Ansichtsfensters des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel zu konvertieren.

Window.mozInnerScreenY Schreibgeschützt Nicht standardisiert

Gibt die vertikale (Y-)Koordinate der oberen linken Ecke des Ansichtsfensters des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe mozScreenPixelsPerCSSPixel, um bei Bedarf in Bildschirm-Pixel zu konvertieren.

Window.name

Ruft den Namen des Fensters ab oder setzt ihn.

Window.navigation Schreibgeschützt

Gibt das dem aktuellen window zugeordnete 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, als Zeichenkette serialisiert.

Window.originAgentCluster Schreibgeschützt

Gibt true zurück, wenn dieses Fenster zu einem origin-erschlüsselten 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 übergeordnete Fenster oder Unterrahmen des aktuellen Fensters zurück.

Window.performance Schreibgeschützt

Gibt ein Performance-Objekt zurück, das die timing- und navigation-Attribute enthält, von denen jedes ein Objekt ist, das leistungsbezogene Daten bereitstellt. Siehe auch Verwenden der Navigationstiming für weitere 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 zur Verwendung der Priorisierten Aufgabenplanungs-API.

Window.screen Schreibgeschützt

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

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Browseransichtsfensters zur linken Seite des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Browseransichtsfensters 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, auf den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus der Ansichtsfensterbreite.

Window.scrollMaxY Nicht standardisiert Schreibgeschützt

Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann, d.h. die Dokumenthöhe minus der Ansichtsfensterhö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 Sitzungspeicherobjekt zurück, das verwendet wird, um Daten zu speichern, auf die nur von der Herkunft zugegriffen werden kann, die diese erstellt hat.

Window.sharedStorage Schreibgeschützt Sicherer Kontext Veraltet

Gibt das WindowSharedStorage-Objekt für die aktuelle Herkunft zurück. Dies ist der Haupteinstiegspunkt zum Schreiben von Daten in den freigegebenen Speicher mit Hilfe der Shared Storage API.

Window.speechSynthesis Schreibgeschützt

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

Window.statusbar Schreibgeschützt

Gibt das Statusbar-Objekt zurück.

Window.toolbar Schreibgeschützt

Gibt das Toolbar-Objekt zurück.

Window.top Schreibgeschützt

Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.

Window.trustedTypes Schreibgeschützt

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

Window.viewport Experimentell Schreibgeschützt

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

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport-Objekt zurück, das das visuelle Ansichtsfenster für ein bestimmtes 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 Rahmenelementen zurück. Weitere Details finden Sie unter Window.frames.

Benannte Eigenschaften

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

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

Wenn eine Eigenschaft einem einzelnen Element entspricht, wird das Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird stattdessen ein HTMLCollection zurückgegeben, das alle enthält. Wenn eines der Elemente ein navigierbarer <iframe> oder <object> ist, wird stattdessen das contentWindow des ersten derartigen iframe zurückgegeben.

Veraltete Eigenschaften

Window.event Veraltet Schreibgeschützt

Gibt das derzeitige Ereignis zurück, welches das aktuell vom JavaScript-Code kontextuell verarbeitete Ereignis ist, oder undefined, wenn kein Ereignis derzeit verarbeitet wird. Das direkt an Event-Handler übergebene Event-Objekt sollte wann immer möglich stattdessen 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 Orientierung in Grad (in 90-Grad-Schritten) der Ansichtsfenster relativ zur natürlichen Orientierung des Geräts zurück.

Window.status Veraltet

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

Instanzmethoden

Dieses Interface erbt Methoden vom EventTarget-Interface.

Window.atob()

Dekodiert eine Zeichenkette, die mit base-64-Codierung codiert wurde.

Window.alert()

Zeigt ein Warnungsdialogfeld an.

Window.blur() Veraltet

Entfernt den Fokus vom Fenster.

Window.btoa()

Erstellt eine base-64-codierte ASCII-Zeichenkette aus einer Zeichenkette binärer Daten.

Window.cancelAnimationFrame()

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

Window.cancelIdleCallback()

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

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

Window.createImageBitmap()

Akzeptiert eine Vielzahl von Bildquellen und gibt ein Promise zurück, das zu einem ImageBitmap aufgelöst wird. Optional wird die Quelle auf das Rechteck der Pixel beschnitten, das bei (sx, sy) mit der Breite sw und 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 geht in den bfcache), oder nach einem bereitgestellten activateAfter-Zeitlimit – je nachdem, was zuerst eintritt.

Window.find() Nicht standardisiert

Sucht nach einer bestimmten 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.

Window.getDefaultComputedStyle() Nicht standardisiert

Ruft den Standard-berechneten Stil für das angegebene Element ab, wobei Autoren-Stylesheets ignoriert werden.

Window.getScreenDetails() Experimentell Sicherer Kontext

Gibt ein Promise zurück, das mit einer ScreenDetails-Objektinstanz aufgelöst wird, welche die Details aller Bildschirme darstellt, die dem Gerät des Benutzers verfügbar sind.

Window.getSelection()

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

Window.matchMedia()

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

Window.moveBy()

Verschiebt das aktuelle Fenster um eine bestimmte Menge.

Window.moveTo()

Verschiebt das Fenster zu den angegebenen Koordinaten.

Window.open()

Öffnet ein neues Fenster.

Window.postMessage()

Bietet eine sichere Methode, mit der ein Fenster eine Zeichenkette von Daten zu einem anderen Fenster senden kann, das nicht innerhalb derselben Domäne wie das erste liegen muss.

Window.print()

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

Window.prompt()

Gibt den im Eingabeaufforderungsdialog eingegebenen Text des Benutzers zurück.

Window.queryLocalFonts() Experimentell Sicherer Kontext

Gibt ein Promise zurück, das mit einem Array von FontData-Objekten aufgelöst wird, welche die lokal verfügbaren Schriftartgesichter darstellen.

Window.queueMicrotask()

Wartet eine Mikrotask auf, die zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle zur Ereignisschleife des Browsers ausgeführt werden soll.

Window.reportError()

Meldet einen Fehler in einem Skript und emuliert eine nicht abgefangene Ausnahme.

Window.requestAnimationFrame()

Teilt dem Browser mit, dass eine Animation im Gange ist, und fordert, dass der Browser einen Neuzeichen-Vorgang für das Fenster für den nächsten Animationsframe plant.

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 Koordinatenset im Dokument.

Window.setInterval()

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

Window.setTimeout()

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

Window.showDirectoryPicker() Experimentell Sicherer Kontext

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

Window.showOpenFilePicker() Experimentell Sicherer Kontext

Zeigt einen Dateiauswahldialog an, der dem Benutzer ermöglicht, eine Datei 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 das Fenster gemäß seinem Inhalt an.

Window.stop()

Diese Methode stoppt das Laden des Fensters.

Window.structuredClone()

Erstellt eine tiefe Kopie eines gegebenen Werts mit dem Structured Clone Algorithmus.

Veraltete Methoden

Window.captureEvents() Veraltet

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

Window.clearImmediate() Nicht standardisiert Veraltet

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

Window.releaseEvents() Veraltet

Hebt die Verhinderung des Fensters von Ereignissen eines bestimmten Typs auf.

Window.requestFileSystem() Nicht standardisiert Veraltet

Ermöglicht einer Website oder App den Zugang zu einem sandboxed-Dateisystem für deren eigenen Gebrauch.

Window.setImmediate() Nicht standardisiert Veraltet

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

Window.setResizable() Nicht standardisiert Veraltet

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

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

Diese Ereignisse können mit addEventListener() abgehört werden oder durch Zuweisung eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse aus dem Document im Fensterobjekt aufsteigen.

error

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

languagechange

Wird im globalen Geltungsbereichsobjekt 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.

Verbindungsevents

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 erlangt hat und der Wert von navigator.onLine auf true gewechselt ist.

Geräteausrichtungsevents

devicemotion Sicherer Kontext

Wird in regelmäßigen Abständen ausgelöst und zeigt die Menge der physikalischen Beschleunigungskräfte an, die auf das Gerät einwirken, 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.

Fokusereignisse

blur

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

focus

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

Gamepad-Ereignisse

gamepadconnected

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

gamepaddisconnected

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

Verlauf-Ereignisse

hashchange

Wird ausgelöst, wenn sich die Fragmentkennung 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 er dabei ist, ein anderes Dokument aus dem Sitzungsverlauf in dessen Platz anzuzeigen. Dies passiert beispielsweise, wenn der Benutzer die Zurück-Schaltfläche oder die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf vorwärts zu gehen.

pagereveal

Wird ausgelöst, wenn ein Dokument zum ersten Mal gerendert wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder beim Aktivieren eines Dokuments (entweder aus dem Back/Forward Cache (bfcache) oder [Vorrender])(/de/docs/Glossary/Prerender)).

pageshow

Wird gesendet, wenn der Browser das Dokument aufgrund von Navigationstätigkeiten sichtbar macht, einschließlich nicht nur, wenn die Seite zum ersten Mal geladen wird, sondern auch Situationen wie das Zurückkehren des Benutzers zur Seite, nachdem er zu einer anderen innerhalb derselben Registerkarte navigiert hat.

pageswap

Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation kurz davor ist, entladen zu werden.

popstate

Wird ausgelöst, wenn sich der aktive Verlaufs-Eintrag ändert.

Lade- und Entladeere ignisse

beforeunload

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

load

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

unload

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

Manifestereignisse

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.

Messaging-Ereignisse

message

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

messageerror

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

Druckereignisse

afterprint

Wird ausgelöst, nachdem das zugehörige Dokument mit dem Drucken begonnen hat oder die Druckvorschau geschlossen wurde.

beforeprint

Wird ausgelöst, wenn das zugehörige Dokument kurz davor ist, gedruckt oder für den Druck in der Vorschau angezeigt zu werden.

Promise-Ablehnungsereignisse

rejectionhandled

Wird jedes Mal gesendet, 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.

Scrolling-Ereignisse

scrollsnapchange Experimentell

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

scrollsnapchanging Experimentell

Wird am Scroll-Container ausgelöst, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel aussteht, das ausgewählt wird, wenn die aktuelle Scroll-Geste endet.

Veraltete Ereignisse

orientationchange Veraltet

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

vrdisplayactivate Veraltet Nicht standardisiert

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

vrdisplayconnect Veraltet Nicht standardisiert

Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.

vrdisplaydisconnect Veraltet Nicht standardisiert

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

vrdisplaydeactivate Veraltet Nicht standardisiert

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

vrdisplaypresentchange Veraltet Nicht standardisiert

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

Bubble-Ereignisse

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

Schnittstellen

Siehe DOM-Referenz.

Lauschen auf Ereignisse auf Window

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

  • Fügen Sie dem Element über die EventTarget.addEventListener-Methode einen Ereignis-Listener hinzu.
  • Weisen Sie einem Element-Ereignishandler in JavaScript die Eigenschaft oneventname zu.
  • Fügen Sie dem Element im HTML ein Attribut mit „on“-Präfix hinzu.

Um auf Ereignisse auf Window-Objekten zu lauschen, können Sie im Allgemeinen nur die ersten beiden Methoden verwenden, da Window kein entsprechendes HTML-Element hat. Es gibt jedoch eine bestimmte Gruppe von Ereignissen, deren Listener dem <body> (oder dem veralteten <frameset>)-Element hinzugefügt werden können, das dem Dokument des Window 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

Dies bedeutet, dass die folgenden strikt den gleichen Effekt haben:

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

Specification
HTML
# the-window-object

Browser-Kompatibilität