DasWindow-Interface repräsentiert ein Fenster, das einDOM-Dokument enthält; diedocument-Eigenschaft zeigt auf das im Fenster geladeneDOM-Dokument.

Ein Fenster für ein bestimmtes Dokument kann mit derdocument.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.

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

In einem Browser mit Registerkarten wird jede Registerkarte durch ihr eigenesWindow-Objekt dargestellt; das globalewindow, 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, wieresizeTo() undinnerHeight. Im Allgemeinen bezieht sich alles, was nicht vernünftigerweise mit einer Registerkarte in Verbindung gebracht werden kann, stattdessen auf das Fenster.

Instanzeigenschaften

Dieses Interface erbt Eigenschaften vomEventTarget-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.cachesSchreibgeschütztSicherer Kontext

Gibt dasCacheStorage-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.clientInformationSchreibgeschützt

Ein Alias fürWindow.navigator.

Window.closedSchreibgeschützt

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

Window.cookieStoreSchreibgeschütztSicherer Kontext

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

Window.credentiallessSchreibgeschütztExperimentell

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

Window.crossOriginIsolatedSchreibgeschützt

Gibt einen Boolean-Wert zurück, der angibt, ob die Website sich in einem Cross-Origin-Isolationszustand befindet.

Window.cryptoSchreibgeschützt

Gibt dasCrypto-Objekt zurück, das mit dem globalen Objekt verbunden ist.

Window.customElementsSchreibgeschützt

Gibt eine Referenz auf dasCustomElementRegistry-Objekt zurück, das verwendet werden kann, um neuebenutzerdefinierte Elemente zu registrieren und Informationen über zuvor registrierte benutzerdefinierte Elemente abzurufen.

Window.devicePixelRatioSchreibgeschützt

Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln im aktuellen Display zurück.

Window.documentSchreibgeschützt

Gibt eine Referenz auf das Dokument zurück, das das Fenster enthält.

Window.documentPictureInPictureSchreibgeschütztExperimentellSicherer Kontext

Gibt eine Referenz auf dasDocument Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.

Window.fenceSchreibgeschütztExperimentell

Gibt eineFence-Objektinstanz für den aktuellen Dokumentkontext zurück. Nur verfügbar für Dokumente, die in ein<fencedframe> eingebettet sind.

Window.frameElementSchreibgeschützt

Gibt das Element zurück, in dem das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.

Window.framesSchreibgeschützt

Gibt ein Array der Unterrahmen im aktuellen Fenster zurück.

Window.fullScreenNicht standardisiert

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

Window.historySchreibgeschützt

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

Window.indexedDBSchreibgeschützt

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

Window.innerHeightSchreibgeschützt

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

Window.innerWidthSchreibgeschützt

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

Window.isSecureContextSchreibgeschützt

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

Window.launchQueueSchreibgeschütztExperimentell

Wenn eineprogressive Web-App (PWA) gestartet wird, mit einemlaunch_handlerclient_mode-Wert vonfocus-existing,navigate-new odernavigate-existing, bietet dielaunchQueue Zugriff auf dieLaunchQueue-Klasse, die es ermöglicht, benutzerdefinierte Start-Navigationsverwaltung für die PWA zu implementieren.

Window.lengthSchreibgeschützt

Gibt die Anzahl der Rahmen im Fenster zurück. Siehe auchwindow.frames.

Window.localStorageSchreibgeschü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.locationbarSchreibgeschützt

Gibt das Locationbar-Objekt zurück.

Window.menubarSchreibgeschützt

Gibt das Menubar-Objekt zurück.

Window.mozInnerScreenXSchreibgeschütztNicht 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. SiehemozScreenPixelsPerCSSPixel innsIDOMWindowUtils für einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel zu konvertieren.

Window.mozInnerScreenYSchreibgeschütztNicht 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. SiehemozScreenPixelsPerCSSPixel, um bei Bedarf in Bildschirm-Pixel zu konvertieren.

Window.name

Ruft den Namen des Fensters ab oder setzt ihn.

Window.navigationSchreibgeschützt

Gibt das dem aktuellenwindow zugeordneteNavigation-Objekt zurück. Der Einstiegspunkt für dieNavigation API.

Window.navigatorSchreibgeschü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.originSchreibgeschützt

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

Window.originAgentClusterSchreibgeschützt

Gibttrue zurück, wenn dieses Fenster zu einem origin-erschlüsselten Agenten-Cluster gehört.

Window.outerHeightSchreibgeschützt

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

Window.outerWidthSchreibgeschützt

Ruft die Breite des Äußeren des Browserfensters ab.

Window.pageXOffsetSchreibgeschützt

Ein Alias fürwindow.scrollX.

Window.pageYOffsetSchreibgeschützt

Ein Alias fürwindow.scrollY.

Window.parentSchreibgeschützt

Gibt eine Referenz auf das übergeordnete Fenster oder Unterrahmen des aktuellen Fensters zurück.

Window.performanceSchreibgeschützt

Gibt einPerformance-Objekt zurück, das dietiming- undnavigation-Attribute enthält, von denen jedes ein Objekt ist, dasleistungsbezogene Daten bereitstellt. Siehe auchVerwenden der Navigationstiming für weitere Informationen und Beispiele.

Window.personalbarSchreibgeschützt

Gibt das Personalbar-Objekt zurück.

Window.schedulerSchreibgeschützt

Gibt dasScheduler-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dies ist der Einstiegspunkt zur Verwendung derPriorisierten Aufgabenplanungs-API.

Window.screenSchreibgeschützt

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

Window.screenX undWindow.screenLeftSchreibgeschützt

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

Window.screenY undWindow.screenTopSchreibgeschützt

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

Window.scrollbarsSchreibgeschützt

Gibt das Scrollbars-Objekt zurück.

Window.scrollMaxXNicht standardisiertSchreibgeschützt

Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus der Ansichtsfensterbreite.

Window.scrollMaxYNicht standardisiertSchreibgeschützt

Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann, d.h. die Dokumenthöhe minus der Ansichtsfensterhöhe.

Window.scrollXSchreibgeschützt

Gibt die Anzahl der Pixel zurück, um die das Dokument bereits horizontal gescrollt wurde.

Window.scrollYSchreibgeschützt

Gibt die Anzahl der Pixel zurück, um die das Dokument bereits vertikal gescrollt wurde.

Window.selfSchreibgeschü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.sharedStorageSchreibgeschütztSicherer KontextVeraltet

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

Window.speechSynthesisSchreibgeschützt

Gibt einSpeechSynthesis-Objekt zurück, das den Einstiegspunkt zur Nutzung der Sprachsynthesefunktionalität derWeb Speech API darstellt.

Window.statusbarSchreibgeschützt

Gibt das Statusbar-Objekt zurück.

Window.toolbarSchreibgeschützt

Gibt das Toolbar-Objekt zurück.

Window.topSchreibgeschützt

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

Window.trustedTypesSchreibgeschützt

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

Window.viewportExperimentellSchreibgeschützt

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

Window.visualViewportSchreibgeschützt

Gibt einVisualViewport-Objekt zurück, das das visuelle Ansichtsfenster für ein bestimmtes Fenster darstellt.

Window.windowSchreibgeschützt

Gibt eine Referenz auf das aktuelle Fenster zurück.

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

Gibt eine Referenz auf daswindow-Objekt in den Rahmenelementen zurück. Weitere Details finden Sie unterWindow.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 seinname (falls nicht leer) verfügbar gemacht.Zum Beispiel, wenn das Dokument<form name="my_form"> enthält, dann gibtwindow["my_form"] (und das äquivalentewindow.my_form) eine Referenz auf dieses Element zurück.
• Für jedes HTML-Element wird seineid (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 einHTMLCollection zurückgegeben, das alle enthält. Wenn eines der Elemente ein navigierbarer<iframe> oder<object> ist, wird stattdessen dascontentWindow des ersten derartigen iframe zurückgegeben.

Veraltete Eigenschaften

Window.eventVeraltetSchreibgeschützt

Gibt dasderzeitige Ereignis zurück, welches das aktuell vom JavaScript-Code kontextuell verarbeitete Ereignis ist, oderundefined, wenn kein Ereignis derzeit verarbeitet wird. Das direkt an Event-Handler übergebeneEvent-Objekt sollte wann immer möglich stattdessen verwendet werden.

Window.externalVeraltetSchreibgeschützt

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

Window.orientationVeraltetSchreibgeschützt

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

Window.statusVeraltet

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

Instanzmethoden

Dieses Interface erbt Methoden vomEventTarget-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 mitWindow.requestAnimationFrame geplanten Rückrufs.

Window.cancelIdleCallback()

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

Window.clearInterval()

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

Window.clearTimeout()

Bricht die verzögerte Ausführung ab, die mitWindow.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 einPromise zurück, das zu einemImageBitmap 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 denbfcache), oder nach einem bereitgestelltenactivateAfter-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()ExperimentellSicherer Kontext

Gibt einPromise zurück, das mit einerScreenDetails-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 einMediaQueryList-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()ExperimentellSicherer Kontext

Gibt einPromise zurück, das mit einem Array vonFontData-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()ExperimentellSicherer Kontext

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

Window.showOpenFilePicker()ExperimentellSicherer Kontext

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

Window.showSaveFilePicker()ExperimentellSicherer 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 einetiefe Kopie eines gegebenen Werts mit demStructured Clone Algorithmus.

Veraltete Methoden

Window.captureEvents()Veraltet

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

Window.clearImmediate()Nicht standardisiertVeraltet

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

Window.releaseEvents()Veraltet

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

Window.requestFileSystem()Nicht standardisiertVeraltet

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

Window.setImmediate()Nicht standardisiertVeraltet

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

Window.setResizable()Nicht standardisiertVeraltet

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

Window.webkitConvertPointFromNodeToPage()Nicht standardisiertVeraltet

Transformiert einenWebKitPoint vom Koordinatensystem des Knotens zum Koordinatensystem der Seite.

Window.webkitConvertPointFromPageToNode()Nicht standardisiertVeraltet

Transformiert einenWebKitPoint vom Koordinatensystem der Seite zum Koordinatensystem des Knotens.

Ereignisse

Diese Ereignisse können mitaddEventListener() abgehört werden oder durch Zuweisung eines Ereignis-Listeners zuroneventname-Eigenschaft dieses Interfaces. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse aus demDocument 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 odersessionStorage) 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 vonnavigator.onLine auffalse gewechselt ist.

online

Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk erlangt hat und der Wert vonnavigator.onLine auftrue gewechselt ist.

Geräteausrichtungsevents

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

deviceorientationSicherer Kontext

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

deviceorientationabsoluteSicherer 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 demBack/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 vonWindow.postMessage() aus einem anderen Browsing-Kontext.

messageerror

Wird ausgelöst, wenn einWindow-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 JavaScriptPromise abgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, um die Ablehnung abzufangen oder nicht.

unhandledrejection

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

Scrolling-Ereignisse

scrollsnapchangeExperimentell

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

scrollsnapchangingExperimentell

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

orientationchangeVeraltet

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

vrdisplayactivateVeraltetNicht standardisiert

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

vrdisplayconnectVeraltetNicht standardisiert

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

vrdisplaydisconnectVeraltetNicht standardisiert

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

vrdisplaydeactivateVeraltetNicht standardisiert

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

vrdisplaypresentchangeVeraltetNicht 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 dasWindow-Objekt erreichen. Nur die folgenden Events tun das und können auf demWindow-Objekt abgehört werden:

• abort
• auxclick
• beforeinput
• beforematch
• beforetoggle
• cancel
• canplay
• canplaythrough
• change
• click
• close
• contextlost
• contextmenu
• contextrestored
• copy
• cuechange
• cut
• dblclick
• drag
• dragend
• dragenter
• dragleave
• dragover
• dragstart
• drop
• durationchange
• emptied
• ended
• formdata
• input
• invalid
• keydown
• keypress
• keyup
• loadeddata
• loadedmetadata
• loadstart
• mousedown
• mouseenter
• mouseleave
• mousemove
• mouseout
• mouseover
• mouseup
• paste
• pause
• play
• playing
• progress
• ratechange
• reset
• scrollend
• securitypolicyviolation
• seeked
• seeking
• select
• slotchange
• stalled
• submit
• suspend
• timeupdate
• toggle
• volumechange
• waiting
• wheel

Schnittstellen

SieheDOM-Referenz.

Lauschen auf Ereignisse aufWindow

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

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

Um auf Ereignisse aufWindow-Objekten zu lauschen, können Sie im Allgemeinen nur die ersten beiden Methoden verwenden, daWindow 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 desWindow 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:

window.onresize = (e) => console.log(e.currentTarget);document.body.onresize = (e) => console.log(e.currentTarget);

<body onresize="console.log(event.currentTarget)"></body>

In allen drei Fällen sehen Sie dasWindow-Objekt alscurrentTarget.

Spezifikationen

Browser-Kompatibilität