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 verweist auf das in diesem Fenster geladene DOM-Dokument.
Ein Fenster für ein bestimmtes Dokument kann über die document.defaultView-Eigenschaft erhalten 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.
Das Window-Interface beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht notwendigerweise direkt mit dem Konzept eines Benutzeroberflächenfensters in Verbindung stehen. Dennoch ist das Window-Interface ein geeigneter Ort, um diese Elemente, die global verfügbar sein müssen, zu integrieren. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem Tab-Browser wird jeder Tab durch sein eigenes Window-Objekt repräsentiert; das globale window, das von JavaScript-Code in einem bestimmten Tab gesehen wird, repräsentiert immer den Tab, in dem der Code ausgeführt wird. Das heißt, selbst in einem Tab-Browser beziehen sich einige Eigenschaften und Methoden immer noch auf das gesamte Fenster, das den Tab enthält, wie z.B. resizeTo() und innerHeight. Im Allgemeinen gilt: Alles, was nicht vernünftigerweise zu einem Tab gehören kann, gehört stattdessen zum Fenster.
Instanz-Eigenschaften
Dieses Interface erbt Eigenschaften vom EventTarget-Interface.
Beachten Sie, dass Eigenschaften, die Objekte sind (z.B. für das Überschreiben des Prototyps von eingebauten Elementen), in einem separaten Abschnitt weiter unten aufgelistet sind.
Window.cachesSchreibgeschützt Sicherer Kontext-
Gibt das
CacheStorage-Objekt zurück, das dem aktuellen Kontext zugeordnet ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Assets zur Offline-Nutzung und das Generieren benutzerdefinierter Antworten auf Anfragen. Window.clientInformationSchreibgeschützt-
Ein Alias für
Window.navigator. Window.closedSchreibgeschützt-
Diese Eigenschaft zeigt an, ob das aktuelle Fenster geschlossen ist oder nicht.
-
Gibt eine Referenz auf das
CookieStore-Objekt für den aktuellen Dokumentenkontext zurück. Window.credentiallessSchreibgeschützt Experimentell-
Gibt einen booleschen Wert zurück, der angibt, ob das aktuelle Dokument innerhalb eines credentialless
<iframe>geladen wurde. Weitere Informationen finden Sie unter IFrame credentialless. Window.crossOriginIsolatedSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob die Website sich in einem Zustand der Cross-Origin-Isolation befindet.
Window.cryptoSchreibgeschützt-
Gibt das
Crypto-Objekt zurück, das mit dem globalen Objekt verknüpft ist. Window.customElementsSchreibgeschü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 zu erhalten. 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ützt Experimentell Sicherer Kontext-
Gibt eine Referenz auf das Dokument-Picture-in-Picture-Fenster für den aktuellen Dokumentenkontext zurück.
Window.fenceSchreibgeschützt Experimentell-
Gibt eine Instanz eines
Fence-Objekts für den aktuellen Dokumentenkontext zurück. Nur verfügbar für Dokumente, die innerhalb eines<fencedframe>eingebettet sind. Window.frameElementSchreibgeschützt-
Gibt das Element zurück, in das das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.
Window.framesSchreibgeschützt-
Gibt ein Array der Unterfenster 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 Verlauf-Objekt zurück.
Window.indexedDBSchreibgeschützt-
Bietet eine Möglichkeit für Anwendungen, asynchron auf die Fähigkeiten von indizierten Datenbanken zuzugreifen; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Ruft die Höhe des Inhaltsbereichs des Browserfensters ab, einschließlich des horizontalen Scrollbalkens, wenn dieser gerendert wird.
Window.innerWidthSchreibgeschützt-
Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich des vertikalen Scrollbalkens, wenn dieser gerendert wird.
Window.isSecureContextSchreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob der aktuelle Kontext sicher (
true) ist oder nicht (false). Window.launchQueueSchreibgeschützt Experimentell-
Wenn eine progressive Web-App (PWA) mit einem
launch_handlerclient_mode-Wert vonfocus-existing,navigate-newodernavigate-existinggestartet wird, bietet dielaunchQueueZugriff auf dieLaunchQueue-Klasse, die eine benutzerdefinierte Startnavigation-Handhabung für die PWA ermöglicht. Window.lengthSchreibgeschützt-
Gibt die Anzahl der Frames im Fenster zurück. Siehe auch
window.frames. Window.localStorageSchreibgeschützt-
Gibt eine Referenz auf das lokale Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, auf die nur der Ursprung zugreifen kann, der sie erstellt hat.
Window.location-
Holt/setzt den Speicherort oder die aktuelle URL des Fensterobjekts.
Window.locationbarSchreibgeschützt-
Gibt das locationbar-Objekt zurück.
-
Gibt das menubar-Objekt zurück.
Window.mozInnerScreenXSchreibgeschü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
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel umzuwandeln. Window.mozInnerScreenYSchreibgeschü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
mozScreenPixelsPerCSSPixelfür einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel umzuwandeln. Window.name-
Holt/setzt den Namen des Fensters.
-
Gibt das mit dem aktuellen
windowassoziierteNavigation-Objekt zurück. Der Einstiegspunkt für die Navigation-API. -
Gibt eine Referenz auf das Navigator-Objekt zurück.
Window.opener-
Gibt eine Referenz auf das Fenster zurück, das das aktuelle Fenster geöffnet hat.
Window.originSchreibgeschützt-
Gibt den Ursprung des globalen Objekts zurück, serialisiert als Zeichenkette.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem ursprungsbezogenen Agenten-Cluster gehört. Window.outerHeightSchreibgeschützt-
Ruft die Höhe außerhalb des Browserfensters ab.
Window.outerWidthSchreibgeschützt-
Ruft die Breite außerhalb des Browserfensters ab.
Window.pageXOffsetSchreibgeschützt-
Ein Alias für
window.scrollX. Window.pageYOffsetSchreibgeschützt-
Ein Alias für
window.scrollY. Window.parentSchreibgeschützt-
Gibt eine Referenz auf den übergeordneten Rahmen des aktuellen Fensters oder Unterrahmens zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, das dietiming- undnavigation-Attribute enthält. Jedes dieser Attribute ist ein Objekt, das leistungsbezogene Daten bereitstellt. Siehe auch Verwendung von Navigation Timing für zusätzliche Informationen und Beispiele. Window.personalbarSchreibgeschützt-
Gibt das personalbar-Objekt zurück.
Window.schedulerSchreibgeschützt-
Gibt das
Scheduler-Objekt zurück, das mit dem aktuellen Kontext verknüpft ist. Dies ist der Einstiegspunkt für die Verwendung der API für die priorisierte Aufgabenzuteilung. Window.screenSchreibgeschützt-
Gibt eine Referenz auf das Bildschirmobjekt zurück, das dem Fenster zugeordnet ist.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Benutzer-Browser-Ansichtsfensters zum linken Rand des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Browser-Ansichtsfensters des Benutzers zum oberen Rand des Bildschirms zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das scrollbars-Objekt zurück.
Window.scrollMaxXNicht standardisiert Schreibgeschützt-
Der maximale Versatz, den das Fenster horizontal gescrollt werden kann, das heißt die Dokumentbreite minus die Ansichtsfensterbreite.
Window.scrollMaxYNicht standardisiert Schreibgeschützt-
Der maximale Versatz, den das Fenster vertikal gescrollt werden kann, das heißt die Dokumentenhöhe minus die Ansichtsfensterhöhe.
Window.scrollXSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, die das Dokument bereits horizontal gescrollt wurde.
Window.scrollYSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, die das Dokument bereits vertikal gescrollt wurde.
Window.selfSchreibgeschützt-
Gibt einen Objektverweis auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt eine Referenz auf das Sitzungs-Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, auf die nur der Ursprung zugreifen kann, der sie erstellt hat.
-
Gibt das
WindowSharedStorage-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt, um Daten in das geteilte Speicher mittels der Shared Storage API zu schreiben. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das den Zugangspunkt zur Nutzung der Sprachsynthese-Funktionalität der Web Speech API bietet. 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 das
TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verknüpft ist und den Einstiegspunkt zur Nutzung der Trusted Types API bietet. Window.viewportExperimentell Schreibgeschützt-
Gibt eine Instanz eines
Viewport-Objekts zurück, das Informationen über den aktuellen Zustand des Ansichtsfensters des Geräts bietet. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-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 das
window-Objekt in den Frames zurück. SieheWindow.framesfür weitere Details. - Benannte Eigenschaften
-
Einige Elemente im Dokument werden auch als Fenstereigenschaften exponiert:
- Für jedes
<embed>,<form>,<iframe>,<img>, und<object>-Element wird seinname(wenn nicht leer) exponiert. Wenn das Dokument zum Beispiel<form name="my_form">enthält, dann gibtwindow["my_form"](und sein Äquivalentwindow.my_form) eine Referenz auf dieses Element zurück. - Für jedes HTML-Element wird sein
id(wenn nicht leer) exponiert.
Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird eine
HTMLCollectionzurückgegeben, die alle enthält. Wenn eines der Elemente ein navigierbares<iframe>oder<object>ist, wird dascontentWindowdes ersten solchen iframes stattdessen zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.eventVeraltet Schreibgeschützt-
Gibt das aktuelle Ereignis zurück, das Ereignis, das momentan vom JavaScript-Code-Kontext behandelt wird, oder
undefined, falls derzeit kein Ereignis behandelt wird. Es sollte wann immer möglich dasEvent-Objekt, das direkt an die Ereignishandler übergeben wird, verwendet werden. Window.externalVeraltet Schreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter zum Browser hinzuzufügen.
Window.orientationVeraltet Schreibgeschützt-
Gibt die Orientierung in Grad (in Schritten von 90 Grad) des Ansichtsfensters relativ zur natürlichen Orientierung des Geräts zurück.
Window.statusVeraltet-
Holt/setzt den Text in der Statusleiste am unteren Bildschirmrand des Browsers.
Instanz-Methoden
Dieses Interface erbt Methoden vom EventTarget-Interface.
Window.atob()-
Dekodiert eine Zeichenkette von Daten, die mit Base-64-Codierung kodiert wurde.
Window.alert()-
Zeigt ein Warnungsdialogfenster an.
Window.blur()Veraltet-
Setzt den Fokus vom Fenster ab.
Window.btoa()-
Erstellt eine Base-64-codierte ASCII-Zeichenkette aus einer Zeichenkette binärer Daten.
Window.cancelAnimationFrame()-
Ermöglicht das Abbrechen eines Rückrufs, der zuvor mit
Window.requestAnimationFramegeplant wurde. Window.cancelIdleCallback()-
Ermöglicht das Abbrechen eines Rückrufs, der zuvor mit
Window.requestIdleCallbackgeplant wurde. Window.clearInterval()-
Bricht die wiederholte Ausführung ab, die mithilfe von
Window.setInterval()eingerichtet wurde. Window.clearTimeout()-
Bricht die verzögerte Ausführung ab, die mithilfe von
Window.setTimeout()eingerichtet wurde. Window.close()-
Schließt das aktuelle Fenster.
Window.confirm()-
Zeigt ein Dialogfeld mit einer Nachricht an, auf die der Benutzer antworten muss.
Window.createImageBitmap()-
Akzeptiert eine Vielzahl unterschiedlicher Bildquellen und gibt ein
Promisezurück, das sich zu einemImageBitmapauflöst. Optional wird die Quelle auf das Rechteck der Pixel beschnitten, die an (sx, sy) mit der Breite sw und der Höhe sh beginnen. 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 wurde (sie wird zerstört oder tritt in den bfcache ein) oder nach einer bereitgestellten
activateAfter-Timeout – je nachdem, was zuerst eintritt. Window.find()Nicht standardisiert-
Sucht ein gegebenes String 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 zeigt die berechneten Werte aller CSS-Eigenschaften des Elements.
Window.getDefaultComputedStyle()Nicht standardisiert-
Holt den Standard-berechneten Stil für das angegebene Element und ignoriert die Autorenstylesheets.
Window.getScreenDetails()Experimentell Sicherer Kontext-
Gibt ein
Promisezurück, das sich zu einemScreenDetails-Objekt auflöst, das die Details aller dem Gerät des Benutzers zur Verfügung stehenden Bildschirme darstellt. Window.getSelection()-
Gibt das Auswahlobjekt zurück, das die ausgewählten Elemente darstellt.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die spezifizierte Medienabfragezeichenkette darstellt. Window.moveBy()-
Verschiebt das aktuelle Fenster um einen angegebenen Betrag.
Window.moveTo()-
Verschiebt das Fenster zu den angegebenen Koordinaten.
Window.open()-
Öffnet ein neues Fenster.
Window.postMessage()-
Bietet eine sichere Möglichkeit für ein Fenster, einem anderen Fenster eine Datenzeichenkette zu senden, dabei muss das andere Fenster nicht im selben Bereich wie das erste liegen.
Window.print()-
Öffnet das Druckdialogfeld, um das aktuelle Dokument zu drucken.
Window.prompt()-
Gibt den vom Benutzer in einem Eingabefeld eingegebenen Text zurück.
Window.queryLocalFonts()Experimentell Sicherer Kontext-
Gibt ein
Promisezurück, das sich zu einem Array vonFontData-Objekten auflöst, die die lokal verfügbaren Schriftarten repräsentieren. Window.queueMicrotask()-
Wartet eine Mikrotask auf, die zu einer sicheren Zeit vor der Rückkehr der Kontrolle zur Ereignisschleife des Browsers ausgeführt werden soll.
Window.reportError()-
Meldet einen Fehler in einem Skript, indem es eine nicht behandelte Ausnahme nachahmt.
Window.requestAnimationFrame()-
Teilt dem Browser mit, dass eine Animation im Gange ist und fordert den Browser auf, für den nächsten Animationsrahmen einen Neuanstrich des Fensters 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 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 festgelegte Anzahl von Millisekunden vergeht.
Window.setTimeout()-
Plant die Ausführung einer Funktion nach einer bestimmten Zeit.
Window.showDirectoryPicker()Experimentell Sicherer Kontext-
Zeigt einen Verzeichniswähler an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()Experimentell Sicherer Kontext-
Zeigt einen Dateiwähler an, der dem Benutzer ermöglicht, eine oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()Experimentell Sicherer Kontext-
Zeigt einen Dateiwähler an, der es dem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()Nicht standardisiert-
Passt die Fenstergröße entsprechend seinem Inhalt an.
Window.stop()-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()-
Erstellt eine tiefe Kopie eines gegebenen Wertes unter Verwendung des strukturierten Klon-Algorithmus.
Veraltete Methoden
Window.captureEvents()Veraltet-
Registriert das Fenster, um alle Ereignisse eines bestimmten Typs zu erfassen.
Window.clearImmediate()Nicht standardisiert Veraltet-
Hebt die wiederholte Ausführung auf, die mit
setImmediate()eingerichtet wurde. Window.releaseEvents()Veraltet-
Hebt die Erfassung der Ereignisse eines bestimmten Typs durch das Fenster auf.
Window.requestFileSystem()Nicht standardisiert Veraltet-
Ermöglicht es einer Website oder App, Zugriff auf ein eigenes Sandkasten-Dateisystem zu erhalten.
Window.setImmediate()Nicht standardisiert Veraltet-
Führt eine Funktion aus, nachdem der Browser andere schwere Aufgaben abgeschlossen hat.
Window.setResizable()Nicht standardisiert Veraltet-
Tut nichts (keine Operation). Aus Gründen der Rückwärtskompatibilität mit Netscape 4.x behalten.
Window.webkitConvertPointFromNodeToPage()Nicht standardisiert Veraltet-
Transformiert einen
WebKitPointvom Koordinatensystem des Knotens zum Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()Nicht standardisiert Veraltet-
Transformiert einen
WebKitPointvom Koordinatensystem der Seite zum Koordinatensystem des Knotens.
Ereignisse
Hören Sie auf diese Ereignisse, indem Sie addEventListener() verwenden oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von dem im Fensterobjekt enthaltenen Document aus aufsteigen.
error-
Ausgelöst, wenn eine Ressource nicht geladen wurde oder nicht verwendet werden kann. Beispielsweise, wenn ein Skript einen Ausführungsfehler hat oder ein Bild nicht gefunden wird oder ungültig ist.
languagechange-
Wird im globalen Scope-Objekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize-
Ausgelöst, wenn das Fenster in seiner Größe verändert wurde.
storage-
Ausgelöst, wenn ein Speicherbereich (
localStorageodersessionStorage) im Kontext eines anderen Dokuments geändert wurde.
Verbindungseignisse
Gerätorientierungseignisse
devicemotionSicherer Kontext-
In regelmäßigen Abständen ausgelöst, zeigt es die Menge an physischer Kräfteeinwirkung der Beschleunigung an, die das Gerät erhält und die Drehgeschwindigkeit, falls verfügbar.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor über die aktuelle Orientierung des Geräts im Vergleich zum Erdreferenzrahmen verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor über die aktuelle absolute Orientierung des Geräts im Vergleich zum Erdreferenzrahmen verfügbar sind.
Fokuseignisse
Gamepad-Ereignisse
gamepadconnected-
Ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder das erste Mal eine Schaltfläche/ein Achse des Gamepads verwendet wird.
gamepaddisconnected-
Ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufseignisse
hashchange-
Ausgelöst, wenn sich der Fragmentbezeichner der URL geändert hat (der Teil der URL, der mit dem
#-Symbol beginnt und folgt). pagehide-
Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während er dabei ist, an seiner Stelle ein anderes Dokument aus dem Verlaufs der Sitzung anzuzeigen. Dies passiert zum Beispiel, wenn der Benutzer auf die Zurück-Schaltfläche klickt oder wenn er auf die Vorwärts-Schaltfläche klickt, um im Verlaufs der Sitzung vorwärts zu gehen.
pagereveal-
Ausgelöst, wenn ein Dokument zum ersten Mal gerendert wird, entweder beim Laden eines frischen 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 sichtbar macht aufgrund von Navigationstätigkeiten, einschließlich nicht nur, wenn die Seite zum ersten Mal geladen wird, sondern auch in Situationen, wie wenn der Benutzer zur Seite zurück navigiert, nachdem er zu einer anderen im selben Tab navigiert war.
pageswap-
Ausgelöst, wenn ein Dokument aufgrund einer Navigation ausgewechselt werden soll.
popstate-
Ausgelöst, wenn sich der aktive Verlaufseintrag ändert.
Lade- und Entladeereignisse
beforeunload-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen kurz davor stehen, entladen zu werden.
load-
Wird ausgelöst, wenn die gesamte Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.
unload-
Wird ausgelöst, wenn das Dokument oder eine Kindressource entladen wird.
Manifest-Ereignisse
appinstalled-
Ausgelöst, wenn der Browser erfolgreich eine Seite als Anwendung installiert hat.
beforeinstallprompt-
Wird ausgelöst, wenn ein Benutzer kurz davor steht, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichtenereignisse
message-
Wird ausgelöst, wenn das Fenster eine Nachricht erhält, zum Beispiel von einem Aufruf zu
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 steht, gedruckt oder zur Druckvorschau angezeigt zu werden.
Ereignisse bei Promise-Abweisung
rejectionhandled-
Wird jedes Mal gesendet, wenn ein JavaScript
Promiseabgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, um die Ablehnung zu erfassen. unhandledrejection-
Wird gesendet, wenn ein JavaScript
Promiseabgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung zu erfassen.
Scroll-Ereignisse
scrollsnapchangeExperimentell-
Wird am Scroll-Behälter am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Scroll Snap Target ausgewählt wurde.
scrollsnapchangingExperimentell-
Wird am Scroll-Behälter ausgelöst, wenn der Browser feststellt, dass ein neues Scroll Snap Target ansteht, das beim Ende der aktuellen Scroll-Geste ausgewählt wird.
Veraltete Ereignisse
orientationchangeVeraltet-
Wird ausgelöst, wenn sich die Orientierung des Geräts geändert hat.
vrdisplayactivateVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display präsentiert werden kann.
vrdisplayconnectVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.
vrdisplaydisconnectVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivateVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display nicht mehr präsentiert werden kann.
vrdisplaypresentchangeVeraltet Nicht standardisiert-
Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert - also von Präsentation zu Nicht-Präsentation oder umgekehrt.
Blasenereignisse
Nicht alle Ereignisse, die blasen, können das Window-Objekt erreichen. Nur folgende tun dies und können auf dem Window-Objekt abgefragt werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Registrierung von Ereignissen auf Window
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu hören:
- Fügen Sie dem Element einen Ereignis-Listener hinzu, indem Sie die Methode
EventTarget.addEventListenerverwenden. - Weisen Sie dem Element den Event-Handler der
oneventname-Eigenschaft in JavaScript zu. - Fügen Sie dem Element ein
on-präfixiertes Attribut im HTML hinzu.
Um auf 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 spezifische 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:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
Das bedeutet, dass folgendes strikt äquivalent ist:
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 das Window-Objekt als currentTarget protokolliert.
Spezifikationen
| Specification |
|---|
| HTML> # the-window-object> |