Window
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
* Some parts of this feature may have varying levels of support.
Die Window
-Schnittstelle repräsentiert ein Fenster, das ein DOM-Dokument enthält; die document
-Eigenschaft verweist auf das DOM-Dokument, das in diesem Fenster geladen ist.
Ein Fenster für ein bestimmtes Dokument kann mit der document.defaultView
-Eigenschaft abgerufen werden.
Eine globale Variable, window
, die das Fenster darstellt, in dem das Skript ausgeführt wird, ist im JavaScript-Code verfügbar.
Die Window
-Schnittstelle beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Allerdings ist die Window
-Schnittstelle ein geeigneter Ort, um Elemente aufzunehmen, die global verfügbar sein müssen. Viele dieser Elemente sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem Browser mit Registerkarten wird jede Registerkarte durch ein eigenes Window
-Objekt repräsentiert; das globale window
, das vom JavaScript-Code in einer bestimmten Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code läuft. Nichtsdestotrotz gelten in einem Browser mit Registerkarten einige Eigenschaften und Methoden weiterhin für das gesamte Fenster, das die Registerkarte enthält, wie zum Beispiel resizeTo()
und innerHeight
. Im Allgemeinen beziehen sich alle Dinge, die nicht vernünftigerweise auf eine Registerkarte zutreffen können, auf das Fenster.
Instanzeigenschaften
Diese Schnittstelle erbt Eigenschaften von der EventTarget
-Schnittstelle.
Beachten Sie, dass Eigenschaften, die Objekte sind (z.B. für das Überschreiben des Prototyps von eingebauten Elementen), in einem separaten Abschnitt unten aufgeführt sind.
Window.caches
Schreibgeschützt Sicherer Kontext-
Gibt das
CacheStorage
-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Assets für die Offline-Nutzung und das Erstellen benutzerdefinierter Antworten auf Anfragen. Window.clientInformation
Schreibgeschützt-
Ein Alias für
Window.navigator
. Window.closed
Schreibgeschützt-
Diese Eigenschaft gibt an, ob das aktuelle Fenster geschlossen ist oder nicht.
-
Gibt eine Referenz auf das
CookieStore
-Objekt für den aktuellen Dokumentkontext zurück. Window.credentialless
Schreibgeschützt Experimentell-
Gibt einen booleschen Wert zurück, der anzeigt, ob das aktuelle Dokument innerhalb eines
credentialless
<iframe>
geladen wurde. Weitere Details siehe IFrame credentialless. Window.crossOriginIsolated
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob die Website sich in einem cross-origin-Isolationszustand befindet.
Window.crypto
Schreibgeschützt-
Gibt das
Crypto
-Objekt zurück, das mit dem globalen Objekt verbunden ist. Window.customElements
Schreibgeschützt-
Gibt eine Referenz auf das
CustomElementRegistry
-Objekt zurück, das verwendet werden kann, um neue benutzerdefinierte Elemente zu registrieren und Informationen über bereits registrierte benutzerdefinierte Elemente zu erhalten. Window.devicePixelRatio
Schreibgeschützt-
Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln im aktuellen Display zurück.
Window.document
Schreibgeschützt-
Gibt eine Referenz auf das Dokument zurück, das das Fenster enthält.
Window.documentPictureInPicture
Schreibgeschützt Experimentell Sicherer Kontext-
Gibt eine Referenz auf das document Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.
Window.fence
Schreibgeschützt Experimentell-
Gibt eine
Fence
-Objektinstanz für den aktuellen Dokumentkontext zurück. Nur verfügbar für in einem<fencedframe>
eingebettete Dokumente. Window.frameElement
Schreibgeschützt-
Gibt das Element zurück, in das das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.
Window.frames
Schreibgeschützt-
Gibt ein Array der Unterfenster im aktuellen Fenster zurück.
Window.fullScreen
Nicht standardisiert-
Diese Eigenschaft gibt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.
Window.history
Schreibgeschützt-
Gibt eine Referenz auf das Verlauf-Objekt zurück.
Window.indexedDB
Schreibgeschützt-
Bietet eine Möglichkeit für Anwendungen, asynchron auf die Funktionen von indizierten Datenbanken zuzugreifen; gibt ein
IDBFactory
-Objekt zurück. Window.innerHeight
Schreibgeschützt-
Ruft die Höhe des Inhaltsbereichs des Browserfensters ab, einschließlich des horizontalen Scrollbalkens, falls gerendert.
Window.innerWidth
Schreibgeschützt-
Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich des vertikalen Scrollbalkens, falls gerendert.
Window.isSecureContext
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob der aktuelle Kontext sicher (
true
) oder nicht (false
) ist. Window.launchQueue
Schreibgeschützt Experimentell-
Wenn eine progressive web app (PWA) mit einem
launch_handler
client_mode
-Wert vonfocus-existing
,navigate-new
odernavigate-existing
gestartet wird, bietet dielaunchQueue
Zugriff auf dieLaunchQueue
-Klasse, die es ermöglicht, benutzerdefinierte Startnavigationshandhabung für die PWA zu implementieren. Window.length
Schreibgeschützt-
Gibt die Anzahl der Rahmen im Fenster zurück. Siehe auch
window.frames
. Window.localStorage
Schreibgeschützt-
Gibt eine Referenz auf das lokale Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur von der Ursprungsquelle, die sie erstellt hat, abgerufen werden können.
Window.location
-
Ruft den Speicherort oder die aktuelle URL des Fensterobjekts ab/setzt diese.
Window.locationbar
Schreibgeschützt-
Gibt das Standortleistenobjekt zurück.
-
Gibt das Menüleistenobjekt zurück.
Window.mozInnerScreenX
Schreibgeschützt Nicht standardisiert-
Gibt die horizontale (X) Koordinate der oberen linken Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixel gemeldet. Siehe
mozScreenPixelsPerCSSPixel
innsIDOMWindowUtils
für einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel umzuwandeln. Window.mozInnerScreenY
Schreibgeschützt Nicht standardisiert-
Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixel gemeldet. Siehe
mozScreenPixelsPerCSSPixel
für einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel umzuwandeln. Window.name
-
Ruft den Namen des Fensters ab/setzt diesen.
-
Gibt das
Navigation
-Objekt zurück, das mit dem aktuellenwindow
verbunden ist. Der Einstiegspunkt für die Navigation API. -
Gibt eine Referenz auf das Navigatorobjekt zurück.
Window.opener
-
Gibt eine Referenz auf das Fenster zurück, das dieses aktuelle Fenster geöffnet hat.
Window.origin
Schreibgeschützt-
Gibt den Ursprung des globalen Objekts als Zeichenkette serialisiert zurück.
Window.originAgentCluster
Schreibgeschützt-
Gibt
true
zurück, wenn dieses Fenster zu einem ursprungsbasierten Agenten-Cluster gehört. Window.outerHeight
Schreibgeschützt-
Ruft die Höhe des Außenbereichs des Browserfensters ab.
Window.outerWidth
Schreibgeschützt-
Ruft die Breite des Außenbereichs des Browserfensters ab.
Window.pageXOffset
Schreibgeschützt-
Ein Alias für
window.scrollX
. Window.pageYOffset
Schreibgeschützt-
Ein Alias für
window.scrollY
. Window.parent
Schreibgeschützt-
Gibt eine Referenz auf das übergeordnete Fenster des aktuellen Fensters oder Unterrahmens zurück.
Window.performance
Schreibgeschützt-
Gibt ein
Performance
-Objekt zurück, das die Attributetiming
undnavigation
enthält, die jeweils ein Objekt sind, das leistungsbezogene Daten bereitstellt. Weitere Informationen und Beispiele finden Sie unter Verwendung der Navigation-Timing. Window.personalbar
Schreibgeschützt-
Gibt das personalbar-Objekt zurück.
Window.scheduler
Schreibgeschützt-
Gibt das
Scheduler
-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dies ist der Einstiegspunkt zur Verwendung der Priorisierten Aufgabenplanungs-API. Window.screen
Schreibgeschützt-
Gibt eine Referenz auf das Bildschirmobjekt zurück, das dem Fenster zugeordnet ist.
Window.screenX
undWindow.screenLeft
Schreibgeschützt-
Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Browser-Viewports des Benutzers zur linken Seite des Bildschirms zurück.
Window.screenY
undWindow.screenTop
Schreibgeschützt-
Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Browser-Viewports des Benutzers zur oberen Seite des Bildschirms zurück.
Window.scrollbars
Schreibgeschützt-
Gibt das Scrollbalkenobjekt zurück.
Window.scrollMaxX
Nicht standardisiert Schreibgeschützt-
Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus die Viewport-Breite.
Window.scrollMaxY
Nicht standardisiert Schreibgeschützt-
Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus die Viewport-Höhe).
Window.scrollX
Schreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits horizontal gescrollt wurde.
Window.scrollY
Schreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits vertikal gescrollt wurde.
Window.self
Schreibgeschützt-
Gibt eine Objekt-Referenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage
-
Gibt eine Referenz auf das Sitzungs-Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur von der Ursprungsquelle, die sie erstellt hat, abgerufen werden können.
-
Gibt das
WindowSharedStorage
-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt für das Schreiben von Daten in den gemeinsam genutzten Speicher mithilfe der Shared Storage API. Window.speechSynthesis
Schreibgeschützt-
Gibt ein
SpeechSynthesis
-Objekt zurück, das den Einstiegspunkt in das Verwenden der Sprachsynthesefunktionalität der Web Speech API darstellt. Window.statusbar
Schreibgeschützt-
Gibt das Statusleistenobjekt zurück.
Window.toolbar
Schreibgeschützt-
Gibt das Werkzeugleistenobjekt zurück.
Window.top
Schreibgeschützt-
Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.
Window.trustedTypes
Schreibgeschützt-
Gibt das
TrustedTypePolicyFactory
-Objekt zurück, das mit dem globalen Objekt verbunden ist und den Einstiegspunkt für die Verwendung der Trusted Types API bietet. Window.visualViewport
Schreibgeschützt-
Gibt ein
VisualViewport
-Objekt zurück, das den visuellen Viewport für ein bestimmtes Fenster repräsentiert. Window.window
Schreibgeschützt-
Gibt eine Referenz auf das aktuelle Fenster zurück.
window[0]
,window[1]
, etc.-
Gibt eine Referenz auf das
window
-Objekt in den Frames zurück. Weitere Details sieheWindow.frames
.
Veraltete Eigenschaften
Window.event
Veraltet Schreibgeschützt-
Gibt das aktuelle Ereignis zurück, das momentan vom JavaScript-Code bearbeitet wird, oder
undefined
, falls momentan kein Ereignis bearbeitet wird. Das direkt an Ereignishandler übergebeneEvent
-Objekt sollte stattdessen wann immer möglich verwendet werden. Window.external
Veraltet Schreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter zum Browser hinzuzufügen.
Window.orientation
Veraltet Schreibgeschützt-
Gibt die Ausrichtung in Grad (in 90-Grad-Schritten) des Viewports im Vergleich zur natürlichen Ausrichtung des Geräts zurück.
Window.status
Veraltet-
Ruft den Text in der Statusleiste am unteren Rand des Browsers ab/setzt diesen.
Instanzmethoden
Diese Schnittstelle erbt Methoden von der EventTarget
-Schnittstelle.
Window.atob()
-
Dekodiert einen Datenstring, der mit base-64-Codierung kodiert wurde.
Window.alert()
-
Zeigt ein Alarmdialogfeld an.
Window.blur()
Veraltet-
Entfernt den Fokus vom Fenster.
Window.btoa()
-
Erstellt einen base-64-codierten ASCII-String aus einem String mit Binärdaten.
Window.cancelAnimationFrame()
-
Ermöglicht es, einen zuvor mit
Window.requestAnimationFrame
geplanten Rückruf abzubrechen. Window.cancelIdleCallback()
-
Ermöglicht es, einen zuvor mit
Window.requestIdleCallback
geplanten Rückruf abzubrechen. Window.clearInterval()
-
Bricht die wiederholte Ausführung ab, die mit
Window.setInterval()
festgelegt wurde. Window.clearTimeout()
-
Bricht die verzögerte Ausführung ab, die mit
Window.setTimeout()
festgelegt wurde. Window.close()
-
Schließt das aktuelle Fenster.
Window.confirm()
-
Zeigt ein Dialogfenster mit einer Nachricht an, auf die der Benutzer antworten muss.
Window.createImageBitmap()
-
Akzeptiert eine Vielzahl von verschiedenen Bildquellen und gibt ein
Promise
zurück, das auf einImageBitmap
aufgelöst wird. Optional wird die Quelle auf das Rechteck von Pixeln zugeschnitten, das bei (sx, sy) mit der Breite sw und der Höhe sh beginnt. Window.dump()
Nicht standardisiert-
Schreibt eine Nachricht in die Konsole.
Window.fetch()
-
Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.
Window.fetchLater()
Experimentell-
Erstellt einen verzögerten Abruf, der gesendet wird, sobald die Seite verlassen wird (sie wird zerstört oder tritt in den bfcache ein) oder nach einem angegebenen
activateAfter
-Timeout — je nachdem, was zuerst eintritt. Window.find()
Nicht standardisiert-
Sucht nach einer gegebenen Zeichenfolge in einem Fenster.
Window.focus()
-
Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()
-
Ruft den berechneten Stil für das angegebene Element ab. Der berechnete Stil gibt die berechneten Werte aller CSS-Eigenschaften des Elements an.
Window.getDefaultComputedStyle()
Nicht standardisiert-
Ruft den Standard-berechneten Stil für das angegebene Element ab, wobei Autorenstile ignoriert werden.
Window.getScreenDetails()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das mit einemScreenDetails
-Objekt instanziiert wird, das die Details aller Bildschirme darstellt, die dem Gerät des Benutzers zur Verfügung stehen. Window.getSelection()
-
Gibt das Auswahlobjekt zurück, das die ausgewählten Elemente repräsentiert.
Window.matchMedia()
-
Gibt ein
MediaQueryList
-Objekt zurück, das die angegebenen Mediaquery-Zeichenfolgen repräsentiert. Window.moveBy()
-
Bewegt das aktuelle Fenster um einen angegebenen Betrag.
Window.moveTo()
-
Bewegt das Fenster zu den angegebenen Koordinaten.
Window.open()
-
Öffnet ein neues Fenster.
Window.postMessage()
-
Bietet eine sichere Möglichkeit, dass ein Fenster eine Datenkette an ein anderes Fenster sendet, das nicht innerhalb derselben Domäne wie das erste liegen muss.
Window.print()
-
Öffnet den Druckdialog, um das aktuelle Dokument zu drucken.
Window.prompt()
-
Gibt den vom Benutzer in einem Eingabeaufforderungsdialog eingegebenen Text zurück.
Window.queryLocalFonts()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das mit einem Array vonFontData
-Objekten erfüllt wird, die die lokal verfügbaren Schriftgesichter repräsentieren. Window.queueMicrotask()
-
Stellt einen Mikrotask in die Warteschlange, der zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle zur Ereignisschleife des Browsers ausgeführt wird.
Window.reportError()
-
Meldet einen Fehler in einem Skript, indem eine unbehandelte Ausnahme emuliert wird.
Window.requestAnimationFrame()
-
Signalisiert dem Browser, dass eine Animation im Gange ist, und beantragt, dass der Browser das Fenster für den nächsten Animationsframe neu zeichnet.
Window.requestIdleCallback()
-
Ermöglicht die Planung von Aufgaben während der Leerlaufzeiten eines Browsers.
Window.resizeBy()
-
Ändert die Größe des aktuellen Fensters um einen bestimmten Betrag.
Window.resizeTo()
-
Ändert die Größe des Fensters dynamisch.
Window.scroll()
-
Scrollt das Fenster zu einem bestimmten Ort im Dokument.
Window.scrollBy()
-
Scrollt das Dokument im Fenster um den angegebenen Betrag.
Window.scrollByLines()
Nicht standardisiert-
Scrollt das Dokument um die angegebene Anzahl von Zeilen.
Window.scrollByPages()
Nicht standardisiert-
Scrollt das aktuelle Dokument um die angegebene Anzahl von Seiten.
Window.scrollTo()
-
Scrollt zu einem bestimmten Satz von Koordinaten im Dokument.
Window.setInterval()
-
Plant die Ausführung einer Funktion, jedes Mal wenn eine bestimmte Anzahl von Millisekunden vergeht.
Window.setTimeout()
-
Plant die Ausführung einer Funktion zu einem bestimmten Zeitpunkt.
Window.showDirectoryPicker()
Experimentell Sicherer Kontext-
Zeigt einen Verzeichniswähler an, mit dem der Benutzer ein Verzeichnis auswählen kann.
Window.showOpenFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiwähler an, mit dem ein Benutzer eine oder mehrere Dateien auswählen kann.
Window.showSaveFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiwähler an, mit dem ein Benutzer eine Datei speichern kann.
Window.sizeToContent()
Nicht standardisiert-
Passt die Größe des Fensters basierend auf seinem Inhalt an.
Window.stop()
-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()
-
Erstellt eine tiefergehende Kopie eines bestimmten Werts mithilfe des strukturierten Klonalternatives.
Veraltete Methoden
Window.captureEvents()
Veraltet-
Registriert das Fenster, um alle Ereignisse eines bestimmten Typs zu erfassen.
Window.clearImmediate()
Nicht standardisiert Veraltet-
Bricht die wiederholte Ausführung ab, die mit
setImmediate()
festgelegt wurde. Window.releaseEvents()
Veraltet-
Löst das Fenster aus der Erfassung von Ereignissen eines bestimmten Typs.
Window.requestFileSystem()
Nicht standardisiert Veraltet-
Ermöglicht es einer Website oder App, auf ein sandkastiertes Dateisystem für den eigenen Gebrauch zuzugreifen.
Window.setImmediate()
Nicht standardisiert Veraltet-
Führt eine Funktion aus, nachdem der Browser andere umfangreiche Aufgaben abgeschlossen hat.
Window.setResizable()
Nicht standardisiert Veraltet-
Tut nichts (no-op). Wird aus Kompatibilitätsgründen mit Netscape 4.x beibehalten.
Window.webkitConvertPointFromNodeToPage()
Nicht standardisiert Veraltet-
Transformiert einen
WebKitPoint
aus dem Koordinatensystem des Knotens in das Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()
Nicht standardisiert Veraltet-
Transformiert einen
WebKitPoint
aus dem Koordinatensystem der Seite in das Koordinatensystem des Knotens.
Ereignisse
Hören Sie auf diese Ereignisse mit addEventListener()
oder indem Sie einen Ereignishandler der oneventname
-Eigenschaft dieser Schnittstelle zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom Document
gebubbelt werden, das im Fensterobjekt enthalten ist.
error
-
Wird ausgelöst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann. Beispielsweise, wenn ein Skript einen Ausführungsfehler hat oder ein Bild nicht gefunden oder ungültig ist.
languagechange
-
Wird im globalen Scope-Objekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize
-
Wird ausgelöst, wenn das Fenster in der Größe geändert wurde.
storage
-
Wird ausgelöst, wenn ein Speicherbereich (
localStorage
odersessionStorage
) im Kontext eines anderen Dokuments geändert wurde.
Verbindungsevents
Gerätorientierungsevents
devicemotion
Sicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und gibt die Menge der physischen Beschleunigungskraft an, die das Gerät erfährt, sowie die Rotationsrate, falls verfügbar.
deviceorientation
Sicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Orientierungssensor zur aktuellen Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
deviceorientationabsolute
Sicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Orientierungssensor zur aktuellen absoluten Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
Fokusevents
Gamepad-Events
gamepadconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder das erste Mal eine Taste/Achse des Gamepads benutzt wird.
gamepaddisconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufsevents
hashchange
-
Wird ausgelöst, wenn sich der Fragmentbezeichner der URL geändert hat (der Teil der URL, der mit dem
#
-Symbol beginnt und darauf folgt). pagehide
-
Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während es dabei ist, ein anderes Dokument aus dem Sitzungsverlauf anzuzeigen. Dies geschieht beispielsweise, wenn der Benutzer auf die Zurück-Schaltfläche klickt oder wenn er auf die Weiter-Schaltfläche klickt, um im Sitzungsverlauf vorwärts zu gehen.
pagereveal
-
Wird ausgelöst, wenn ein Dokument zum ersten Mal angezeigt wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder beim Aktivieren eines Dokuments (entweder aus dem back/forward cache (bfcache) oder prerender).
pageshow
-
Wird gesendet, wenn der Browser das Dokument aufgrund von Navigationstasks sichtbar macht, einschließlich nicht nur, wenn die Seite zum ersten Mal geladen wird, sondern auch Situationen, wie wenn der Benutzer zur Seite zurückkehrt, nachdem er zu einer anderen innerhalb desselben Tabs navigiert ist.
pageswap
-
Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation entladen wird.
popstate
-
Wird ausgelöst, wenn sich der aktive Verlaufseintrag ändert.
Lade- & Entladeereignisse
beforeunload
-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen im Begriff sind, entladen zu werden.
load
-
Wird ausgelöst, wenn die gesamte Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.
unload
Veraltet-
Wird ausgelöst, wenn das Dokument oder eine Kindressource entladen wird.
Manifest-Ereignisse
appinstalled
-
Wird ausgelöst, wenn der Browser erfolgreich eine Seite als Anwendung installiert hat.
beforeinstallprompt
-
Wird ausgelöst, wenn ein Benutzer kurz davor ist, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichtenereignisse
message
-
Wird ausgelöst, wenn das Fenster eine Nachricht empfängt, z.B. von einem Aufruf von
Window.postMessage()
von einem anderen Browsing-Kontext. messageerror
-
Wird ausgelöst, wenn ein
Window
-Objekt eine Nachricht erhält, die nicht deserialisiert werden kann.
Druckereignisse
afterprint
-
Wird ausgelöst, nachdem das zugehörige Dokument mit dem Drucken begonnen hat oder die Druckvorschau geschlossen wurde.
beforeprint
-
Wird ausgelöst, wenn das zugehörige Dokument kurz vor dem Ausdrucken oder der Vorschau steht.
Promise-Ablehnungsereignisse
rejectionhandled
-
Wird jedes Mal gesendet, wenn ein JavaScript-
Promise
abgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, der die Ablehnung abfängt oder nicht. unhandledrejection
-
Wird gesendet, wenn ein JavaScript-
Promise
abgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung abzufangen.
Scrollevents
scrollsnapchange
Experimentell-
Wird am Scrollcontainer am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging
Experimentell-
Wird am Scrollcontainer ausgelöst, wenn der Browser feststellt, dass ein neues Scroll-Snap-Ziel aussteht, d.h. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.
Veraltete Ereignisse
orientationchange
Veraltet-
Wird ausgelöst, wenn sich die Ausrichtung des Geräts ändert.
vrdisplayactivate
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display bereitgestellt werden kann.
vrdisplayconnect
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.
vrdisplaydisconnect
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivate
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display nicht mehr bereitgestellt werden kann.
vrdisplaypresentchange
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn sich der Präsentationszustand eines VR-Geräts ändert — d.h. von präsentierend zu nicht präsentierend wechselt oder umgekehrt.
Gebubbelte Ereignisse
Nicht alle Ereignisse, die gebubbelt werden, können das Window
-Objekt erreichen. Nur die folgenden tun dies und können am Window
-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
Siehe DOM-Referenz.
Über Events auf Window hören
HTML-Elemente haben drei Möglichkeiten, auf Ereignisse zu hören:
- Fügen Sie dem Element einen Event Listener mit der
EventTarget.addEventListener
Methode hinzu. - Weisen Sie dem Element in JavaScript einen Event Handler der
oneventname
-Eigenschaft zu. - Fügen Sie dem Element im HTML ein mit
on
-präfixiertes Attribut hinzu.
Um auf Ereignisse bei Window
-Objekten zu hören, können Sie im Allgemeinen nur die ersten zwei Methoden verwenden, da Window
kein entsprechendes HTML-Element hat. Allerdings gibt es eine spezifische Gruppe von Ereignissen, deren Listener dem <body>
(oder dem veralteten <frameset>
) Element hinzugefügt werden können, das dem von Window
s Dokument gehört, unter Verwendung der zweiten oder dritten Methode. Diese Ereignisse sind:
afterprint
beforeprint
beforeunload
blur
error
focus
hashchange
languagechange
load
message
messageerror
offline
online
pagehide
pagereveal
pageshow
pageswap
popstate
rejectionhandled
resize
scroll
storage
unhandledrejection
unload
Das bedeutet, dass die folgenden strikt gleichwertig sind:
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 |