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.
Das Window
Interface repräsentiert ein Fenster, das ein DOM-Dokument enthält; die document
-Eigenschaft verweist auf das DOM-Dokument, das in diesem Fenster geladen ist.
Ein Fenster für ein bestimmtes Dokument kann über die Eigenschaft document.defaultView
abgerufen werden.
Eine globale Variable, window
, die das in JavaScript ausgeführte Fenster darstellt, wird JavaScript-Code zur Verfügung gestellt.
Das Window
Interface beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Das Window
Interface ist jedoch ein geeigneter Ort, um diese Elemente einzuschließen, die global verfügbar sein müssen. Viele davon sind in der JavaScript Referenz und der DOM Referenz dokumentiert.
In einem Browser mit Registerkarten wird jede Registerkarte durch ein eigenes Window
Objekt dargestellt; das globale window
, das von JavaScript-Code innerhalb einer bestimmten Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Dennoch gelten einige Eigenschaften und Methoden, auch in einem Browser mit Registerkarten, für das gesamte Fenster, das die Registerkarte enthält, wie zum Beispiel resizeTo()
und innerHeight
. Im Allgemeinen gilt: Alles, was nicht sinnvoll einer Registerkarte zugeordnet werden kann, betrifft stattdessen das 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 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 Ressourcen 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 zeigt an, ob das aktuelle Fenster geschlossen ist oder nicht.
-
Gibt eine Referenz auf das
CookieStore
Objekt für den aktuellen Dokumentkontext. Window.credentialless
Schreibgeschützt Experimentell-
Gibt einen booleschen Wert zurück, der anzeigt, ob das aktuelle Dokument in einem
iframe
ohne Anmeldeinformationen geladen wurde. Siehe IFrame credentialless für weitere Details. Window.crossOriginIsolated
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob die Website sich in einem state der Isolierung mit anderer Herkunft befindet.
Window.crypto
Schreibgeschützt-
Gibt das
Crypto
Objekt zurück, das mit dem globalen Objekt assoziiert ist. Window.customElements
Schreibgeschützt-
Gibt eine Referenz auf das
CustomElementRegistry
Objekt zurück, welches verwendet werden kann, um neue benutzerdefinierte Elemente zu registrieren und Informationen über zuvor 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 Dokument 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 für Dokumente verfügbar, die innerhalb einesfencedframe
eingebettet sind. 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 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 Verlaufsobjekt zurück.
Window.indexedDB
Schreibgeschützt-
Bietet einen Mechanismus für Anwendungen, asynchron auf Fähigkeiten von indizierten Datenbanken zuzugreifen; gibt ein
IDBFactory
Objekt zurück. Window.innerHeight
Schreibgeschützt-
Ruft die Höhe des Inhaltsbereichs des Browserfensters einschließlich der, wenn gerendert, horizontalen Bildlaufleiste ab.
Window.innerWidth
Schreibgeschützt-
Ruft die Breite des Inhaltsbereichs des Browserfensters einschließlich der, wenn gerendert, vertikalen Bildlaufleiste ab.
Window.isSecureContext
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, 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 vonfocus-existing
,navigate-new
odernavigate-existing
gestartet wird, bietet dielaunchQueue
Zugriff auf dieLaunchQueue
Klasse, die es ermöglicht, benutzerdefinierte Startnavigation für die PWA zu implementieren. Window.length
Schreibgeschützt-
Gibt die Anzahl der Frames im Fenster zurück. Siehe auch
window.frames
. Window.localStorage
Schreibgeschützt-
Gibt eine Referenz auf das lokale Speicherobjekt zurück, das zum Speichern von Daten verwendet wird, die nur vom Ursprung, der es erstellt hat, zugegriffen werden dürfen.
Window.location
-
Ruft die Location oder die aktuelle URL des Fensterobjekts ab oder setzt sie.
Window.locationbar
Schreibgeschützt-
Gibt das locationbar Objekt zurück.
-
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
innsIDOMWindowUtils
für einen Umrechnungsfaktor, um bei Bedarf auf Bildschirmpixel anzupassen. 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
für einen Umrechnungsfaktor, um bei Bedarf auf Bildschirmpixel anzupassen. Window.name
-
Ruft den Namen des Fensters ab oder setzt ihn.
-
Gibt das mit dem aktuellen
window
assoziierteNavigation
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 dieses aktuelle Fenster geöffnet hat.
Window.origin
Schreibgeschützt-
Gibt den Ursprung des globalen Objekts zurück, serialisiert als Zeichenkette.
Window.originAgentCluster
Schreibgeschützt-
Gibt
true
zurück, wenn dieses Fenster zu einem durch Herkunft gekennzeichneten Agentencluster gehört. Window.outerHeight
Schreibgeschützt-
Ruft die Höhe der Außenseite des Browserfensters ab.
Window.outerWidth
Schreibgeschützt-
Ruft die Breite der Außenseite 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 des aktuellen Fensters oder Unterrahmens zurück.
Window.performance
Schreibgeschützt-
Gibt ein
Performance
Objekt zurück, das die Attributetiming
undnavigation
umfasst. Jedes dieser Attribute ist ein Objekt, das leistungsbezogene Daten bereitstellt. Siehe auch Verwenden der Navigation Timing für zusätzliche Informationen und Beispiele. Window.personalbar
Schreibgeschützt-
Gibt das personalbar Objekt zurück.
Window.scheduler
Schreibgeschützt-
Gibt das
Scheduler
Objekt zurück, das dem aktuellen Kontext zugeordnet ist. Dies ist der Einstiegspunkt zur Verwendung der Prioritized Task Scheduling API. Window.screen
Schreibgeschützt-
Gibt eine Referenz auf das mit dem Fenster assoziierte Bildschrimobjekt zurück.
Window.screenX
undWindow.screenLeft
Schreibgeschützt-
Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Ansichtsfensters des Browsers zur linken Seite des Bildschirms zurück.
Window.screenY
undWindow.screenTop
Schreibgeschützt-
Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Ansichtsfensters des Browsers 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 Dokumentenbreite minus der Ansichtsfensterbreite.
Window.scrollMaxY
Nicht standardisiert Schreibgeschützt-
Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumentenhö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 Sitzungsspeicherobjekt zurück, das zum Speichern von Daten verwendet wird, die nur vom Ursprung, der es erstellt hat, zugegriffen werden dürfen.
-
Gibt das
WindowSharedStorage
Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt zum Schreiben von Daten in den gemeinsamen Speicher mithilfe der Shared Storage API. Window.speechSynthesis
Schreibgeschützt-
Gibt ein
SpeechSynthesis
Objekt zurück, welches der Einstiegspunkt zur Verwendung der Web Speech API Sprechersynthesefunktionalität ist. 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 assoziiert ist, und bietet den Einstiegspunkt zur Verwendung der Trusted Types API. Window.visualViewport
Schreibgeschützt-
Gibt ein
VisualViewport
Objekt zurück, welches das visuelle Ansichtsfenster für ein gegebenes 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 Frames zurück. Weitere Details sieheWindow.frames
.
Veraltete Eigenschaften
Window.event
Veraltet Schreibgeschützt-
Gibt das aktuelle Ereignis zurück, welches das Ereignis ist, das derzeit vom Kontext des JavaScript-Codes verarbeitet wird, oder
undefined
, wenn derzeit kein Ereignis verarbeitet wird. Das direkt an Ereignishandler übergebeneEvent
Objekt sollte wann immer möglich verwendet werden. Window.external
Veraltet Schreibgeschützt-
Gibt ein Objekt mit Funktionen zum Hinzufügen externer Suchanbieter zum Browser zurück.
Window.orientation
Veraltet Schreibgeschützt-
Gibt die Ausrichtung in Grad (in 90 Grad Schritten) des Ansichtsfensters relativ zur natürlichen Ausrichtung des Geräts zurück.
Window.status
Veraltet-
Ruft den Text in der Statusleiste unten im Browser ab oder setzt ihn.
Instanzmethoden
Dieses Interface erbt Methoden vom EventTarget
Interface.
Window.atob()
-
Dekodiert eine Zeichenkette von Daten, die mit der Base-64-Kodierung kodiert wurden.
Window.alert()
-
Zeigt ein Alarmdialogfeld an.
Window.blur()
Veraltet-
Setzt den Fokus von dem Fenster weg.
Window.btoa()
-
Erzeugt eine Base-64-kodierte ASCII-Zeichenkette aus einer Zeichenkette binärer Daten.
Window.cancelAnimationFrame()
-
Ermöglicht das Abbrechen eines zuvor mit
Window.requestAnimationFrame
geplanten Rückrufs. Window.cancelIdleCallback()
-
Ermöglicht das Abbrechen eines zuvor mit
Window.requestIdleCallback
geplanten Rücklaufs. Window.clearInterval()
-
Stoppt die wiederholte Ausführung, die mit
Window.setInterval()
festgelegt wurde. Window.clearTimeout()
-
Stoppt die verzögerte Ausführung, 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 sich zu einemImageBitmap
auflöst. Optional wird die Quelle auf das Rechteck von Pixeln beschnitten, 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()
-
Beginnt mit dem Abrufen einer Ressource aus dem Netzwerk.
Window.find()
Nicht standardisiert-
Sucht ein gegebenes 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. Berechneter Stil gibt die berechneten Werte aller CSS-Eigenschaften des Elements an.
Window.getDefaultComputedStyle()
Nicht standardisiert-
Ruft den Standard-Berechnungsstil für das angegebene Element ab und ignoriert dabei Autoren-Stylesheets.
Window.getScreenDetails()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das sich zu einerScreenDetails
Objektinstanz auflöst, die die Details aller für das Gerät des Benutzers verfügbaren Bildschirme darstellt. 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 Mediaquery-Zeichenkette darstellt. Window.moveBy()
-
Verschiebt das aktuelle Fenster um einen angegebenen Betrag.
Window.moveTo()
-
Verschiebt das Fenster auf die angegebenen Koordinaten.
Window.open()
-
Öffnet ein neues Fenster.
Window.postMessage()
-
Bietet eine sichere Möglichkeit, dass ein Fenster eine Datenzeichenkette an ein anderes Fenster sendet, das nicht im selben Domain sein muss wie das erste.
Window.print()
-
Öffnet das Druckdialogfenster, 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 sich zu einem Array vonFontData
Objekten auflöst, die die lokal verfügbaren Schriftarten darstellen. Window.queueMicrotask()
-
Plant eine Mikrotask zur Ausführung zu einem sicheren Zeitpunkt, bevor die Kontrolle zur Ereignisschleife des Browsers zurückkehrt.
Window.reportError()
-
Meldet einen Fehler in einem Skript und emuliert eine nicht behandelte Ausnahme.
Window.requestAnimationFrame()
-
Fordert den Browser auf, dass eine Animation im Gange ist, und fordert, dass der Browser ein Neuzeichnen des Fensters 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 einer bestimmten Reihe 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 nach einer bestimmten Zeit.
Window.showDirectoryPicker()
Experimentell Sicherer Kontext-
Zeigt einen Verzeichnisauswahldialog an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der es einem Benutzer ermöglicht, eine Datei oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der es einem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()
Nicht standardisiert-
Ändert die Größe des Fensters gemäß seinem Inhalt.
Window.stop()
-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()
-
Erstellt eine tiefe Kopie eines gegebenen Werts mithilfe des structured clone algorithmus.
Veraltete Methoden
Window.back()
Nicht standardisiert Veraltet-
Geht einen Schritt in der Fensterhistorie zurück. Diese Methode ist veraltet; Sie sollten stattdessen
history.back()
verwenden. Window.captureEvents()
Veraltet-
Registriert das Fenster, um alle Ereignisse des angegebenen Typs zu erfassen.
Window.clearImmediate()
Nicht standardisiert Veraltet-
Stoppt die wiederholte Ausführung, die mit
setImmediate()
festgelegt wurde. Window.forward()
Nicht standardisiert Veraltet-
Bewegt das Fenster ein Dokument vorwärts in der Historie. Diese Methode ist veraltet; Sie sollten stattdessen
history.forward()
verwenden. Window.releaseEvents()
Veraltet-
Gibt das Fenster frei, um die Ereignisse eines bestimmten Typs zu senden.
Window.requestFileSystem()
Nicht standardisiert Veraltet-
Erlaubt einer Website oder App den Zugriff auf ein in sich abgeschlossenes Dateisystem zur eigenen Verwendung.
Window.setImmediate()
Nicht standardisiert Veraltet-
Führt eine Funktion aus, nachdem der Browser andere umfangreiche Aufgaben beendet hat.
Window.setResizable()
Nicht standardisiert Veraltet-
Macht nichts (No-op). Wird für die Abwärtskompatibilität mit Netscape 4.x erhalten.
Window.showModalDialog()
Nicht standardisiert Veraltet-
Zeigt ein modales Dialogfeld an.
Window.webkitConvertPointFromNodeToPage()
Nicht standardisiert Veraltet-
Transformiert einen
WebKitPoint
von dem Koordinatensystem des Knotens in das der Seite. Window.webkitConvertPointFromPageToNode()
Nicht standardisiert Veraltet-
Transformiert einen
WebKitPoint
von dem Koordinatensystem der Seite in das des Knotens.
Ereignisse
Diese Ereignisse können mit addEventListener()
oder durch Zuweisen eines Ereignis-Listeners zur oneventname
-Eigenschaft dieses Interfaces überwacht werden. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von dem im Fensterobjekt enthaltenen Document
heraufsteigen.
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 oder ungültig ist.
languagechange
-
Wird im globalen Anwendungsbereichsobjekt 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
odersessionStorage
) im Kontext eines anderen Dokuments geändert wurde.
Zwischenablage-Ereignisse
copy
-
Wird ausgelöst, wenn der Benutzer eine Kopieraktion über die Benutzeroberfläche des Browsers initiiert. Auch verfügbar über die
oncopy
Eigenschaft. cut
-
Wird ausgelöst, wenn der Benutzer eine Cut-Aktion über die Benutzeroberfläche des Browsers initiiert. Auch verfügbar über die
oncut
Eigenschaft. paste
-
Wird ausgelöst, wenn der Benutzer eine Einfügeaktion über die Benutzeroberfläche des Browsers initiiert. Auch verfügbar über die
onpaste
Eigenschaft.
Verbindungsevents
Geräteorientation-Ereignisse
devicemotion
Sicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und gibt die Menge an physischer Beschleunigungskraft an, die das Gerät erhält, sowie die Rotationsrate, falls verfügbar.
deviceorientation
Sicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetsensor-Orientsierungssensor über die aktuelle Orientierung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
deviceorientationabsolute
Sicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetsensor-Orientsierungssensor über die aktuelle absolute Orientierung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
Fokussierungsereignisse
Gamepad-Ereignisse
gamepadconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder das erste Mal eine Taste/ein Achse des Gamepads verwendet wurde.
gamepaddisconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufereignisse
hashchange
-
Wird ausgelöst, wenn sich der Fragment-Identifikator 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 versteckt, während er im Prozess des Wechsels zur Anzeige eines anderen Dokuments aus dem Verlauf der Sitzung ist. Das passiert, beispielsweise, wenn der Benutzer auf die Zurück-Taste klickt oder wenn er auf die Vorwärts-Taste klickt, um im Sitzungsverlauf vorwärts zu navigieren.
pagereveal
-
Wird 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 aufgrund von Navigationsaufgaben sichtbar macht. Dies schließt nicht nur das erste Laden der Seite ein, sondern auch Situationen wie das Zurückkehren zur Seite, nachdem der Benutzer zu einer anderen innerhalb des gleichen Tabs navigiert hat.
pageswap
-
Wird ausgelöst, wenn ein Dokument entladen werden soll aufgrund einer Navigation.
popstate
-
Wird ausgelöst, wenn der aktive Verlaufseintrag geändert wird.
Lade- und Entladeereignisse
beforeunload
-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen entladen werden sollen.
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 untergeordnete Ressource entladen wird.
Manifest-Ereignisse
appinstalled
-
Wird ausgelöst, wenn der Browser eine Seite erfolgreich als Anwendung installiert hat.
beforeinstallprompt
-
Wird ausgelöst, wenn ein Benutzer aufgefordert wird, eine Webanwendung zu installieren.
Nachrichtenereignisse
message
-
Wird ausgelöst, wenn das Fenster eine Nachricht erhält, beispielsweise aus einem Aufruf von
Window.postMessage()
von einem anderen Browsingkontext. 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 gedruckt oder zur Druckvorschau angezeigt werden soll.
Promiseablehnungsereignisse
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, es jedoch keinen Handler gibt, um die Ablehnung abzufangen.
Scrollereignisse
scrollsnapchange
Experimentell-
Wird am Scrollcontainer ausgelöst, wenn am Ende eines Scrollvorgangs ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging
Experimentell-
Wird am Scrollcontainer ausgelöst, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel ansteht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.
Veraltete Ereignisse
orientationchange
Veraltet-
Wird ausgelöst, wenn sich die Orientierung des Geräts geändert hat.
vrdisplayactivate
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display in der Lage ist, präsentiert zu werden.
vrdisplayconnect
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät an den Computer angeschlossen 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. aus dem Präsentationsmodus in den Nicht-Präsentationsmodus wechselt oder umgekehrt.
Aufgeblasene Ereignisse
Nicht alle, die aufgeblasen werden, erreichen das Window
Objekt. Nur die folgenden tun dies und können auf dem Window
Objekt überwacht 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
Siehe DOM Referenz.
Zuhören von Ereignissen auf Window
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu hören:
- Einen Ereignis-Listener zum Element mit der
EventTarget.addEventListener
Methode hinzufügen. - Einen Ereignis-Handler zur
oneventname
-Eigenschaft des Elements in JavaScript zuweisen. - Ein mit
on
-Präfix versehenes Attribut zum Element im HTML hinzufügen.
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 aber eine spezifische Gruppe von Ereignissen, deren Listener hinzugefügt werden können, entweder zum <body>
(oder dem veralteten <frameset>
) Element, das dem Dokument des Window
gehört, wobei 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
Das bedeutet, die folgenden sind exakt gleichwertig:
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
geloggt.
Spezifikationen
Specification |
---|
HTML # the-window-object |