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 im Fenster geladene DOM-Dokument.
Ein Fenster für ein bestimmtes Dokument kann mithilfe der document.defaultView
-Eigenschaft abgerufen werden.
Eine globale Variable, window
, die das Fenster repräsentiert, in dem das Skript ausgeführt wird, 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ächen-Fensters in Verbindung stehen. Dennoch ist das Window
-Interface ein geeigneter Ort, um diese Elemente zu inkludieren, 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 repräsentiert; das globale window
, das vom JavaScript-Code innerhalb einer gegebenen Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Dennoch gibt es selbst in einem Browser mit Registerkarten einige Eigenschaften und Methoden, die auf das gesamte Fenster, das die Registerkarte enthält, angewendet werden, wie z. B. resizeTo()
und innerHeight
. Im Allgemeinen gilt: Alles, was sich nicht sinnvoll auf eine Registerkarte beziehen lässt, bezieht sich stattdessen auf das Fenster.
Instanzeigenschaften
Dieses Interface erbt Eigenschaften von der EventTarget
-Schnittstelle.
Beachten Sie, dass Eigenschaften, die Objekte sind (z. B. zum Überschreiben des Prototyps von eingebauten Elementen), in einem separaten Abschnitt unten aufgeführt sind.
Window.caches
Schreibgeschützt Sicherer Kontext-
Gibt das
CacheStorage
-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Assets zur Offline-Verwendung und das Erzeugen 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 zurück. Window.credentialless
Schreibgeschützt Experimentell-
Gibt einen Boolean-Wert zurück, der angibt, ob das aktuelle Dokument in einem credentialless
<iframe>
geladen wurde. Siehe IFrame credentialless für weitere Details. Window.crossOriginIsolated
Schreibgeschützt-
Gibt einen Boolean-Wert zurück, der angibt, ob die Website in einem State der Cross-Origin-Isolation ist.
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 zur Registrierung neuer benutzerdefinierter Elemente und zum Abrufen von Informationen über bereits registrierte benutzerdefinierte Elemente verwendet werden kann. 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 für Dokumente verfügbar, die in ein<fencedframe>
eingebettet sind. Window.frameElement
Schreibgeschützt-
Gibt das Element zurück, in dem das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.
Window.frames
Schreibgeschützt-
Gibt ein Array der 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 Mechanismus für Anwendungen, um asynchron auf Fähigkeiten von indizierten Datenbanken zuzugreifen; gibt ein
IDBFactory
-Objekt zurück. Window.innerHeight
Schreibgeschützt-
Erhält die Höhe des Inhaltsbereichs des Browserfensters einschließlich, falls gerendert, des horizontalen Rollbalkens.
Window.innerWidth
Schreibgeschützt-
Erhält die Breite des Inhaltsbereichs des Browserfensters einschließlich, falls gerendert, des vertikalen Rollbalkens.
Window.isSecureContext
Schreibgeschützt-
Gibt einen Boolean zurück, der angibt, ob der aktuelle Kontext sicher (
true
) ist oder nicht (false
). 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, für die PWA angepasste Start-Navigationsbehandlung 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 von der Herkunft abgerufen werden können, die es erstellt hat.
Window.location
-
Ruft den Speicherort oder die aktuelle URL des Fensterobjekts ab bzw. setzt diesen.
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 Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixel
innsIDOMWindowUtils
für einen Umrechnungsfaktor, um dies bei Bedarf auf Bildschirm-Pixel anzupassen. 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-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixel
für einen Umrechnungsfaktor, um dies bei Bedarf auf Bildschirm-Pixel anzupassen. Window.name
-
Ruft den Namen des Fensters ab bzw. setzt diesen.
-
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, als Zeichenfolge serialisiert.
Window.originAgentCluster
Schreibgeschützt-
Gibt
true
zurück, wenn dieses Fenster zu einem nach Ursprung gruppierten Agenten-Cluster gehört. Window.outerHeight
Schreibgeschützt-
Erhält die Höhe der Außenseite des Browserfensters.
Window.outerWidth
Schreibgeschützt-
Erhält die Breite der Außenseite des Browserfensters.
Window.pageXOffset
Schreibgeschützt-
Ein Alias für
window.scrollX
. Window.pageYOffset
Schreibgeschützt-
Ein Alias für
window.scrollY
. Window.parent
Schreibgeschützt-
Gibt eine Referenz auf das übergeordnete Fenster oder Unterrahmen des aktuellen Fensters zurück.
Window.performance
Schreibgeschützt-
Gibt ein
Performance
-Objekt zurück, das dietiming
- undnavigation
-Attribute enthält, die jeweils ein Objekt mit leistungsbezogenen Daten sind. Siehe auch Using 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 mit dem aktuellen Kontext verbunden ist. Dies ist der Einstiegspunkt für die Nutzung der Prioritized Task Scheduling API. Window.screen
Schreibgeschützt-
Gibt eine Referenz auf das mit dem Fenster verbundene Bildschirmobjekt zurück.
Window.screenX
undWindow.screenLeft
Schreibgeschützt-
Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Browser-Viewports des Nutzers 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 Nutzers zur oberen Seite des Bildschirms zurück.
Window.scrollbars
Schreibgeschützt-
Gibt das Scrollbars-Objekt zurück.
Window.scrollMaxX
Nicht standardisiert Schreibgeschützt-
Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus der 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 der Viewport-Höhe).
Window.scrollX
Schreibgeschützt-
Gibt die Anzahl der Pixel zurück, die das Dokument bereits horizontal gescrollt wurde.
Window.scrollY
Schreibgeschützt-
Gibt die Anzahl der Pixel zurück, die das Dokument bereits vertikal gescrollt wurde.
Window.self
Schreibgeschützt-
Gibt eine Objektreferenz 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 von der Herkunft abgerufen werden können, die es erstellt hat.
-
Gibt das
WindowSharedStorage
-Objekt für die aktuelle Herkunft zurück. Dies ist der Haupteinstiegspunkt, um Daten mithilfe der Shared Storage API in einen geteilten Speicher zu schreiben. Window.speechSynthesis
Schreibgeschützt-
Gibt ein
SpeechSynthesis
-Objekt zurück, das den Einstiegspunkt für die Verwendung der Web Speech API-Sprachsynthesefunktionalität darstellt. Window.statusbar
Schreibgeschützt-
Gibt das Statusleiste-Objekt zurück.
Window.toolbar
Schreibgeschützt-
Gibt das Toolbar-Objekt zurück.
Window.top
Schreibgeschützt-
Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.
Window.trustedTypes
Schreibgeschützt-
Gibt das
TrustedTypePolicyFactory
-Objekt zurück, das mit dem globalen Objekt verbunden ist, und liefert den Einstiegspunkt für die Verwendung der Trusted Types API. Window.visualViewport
Schreibgeschützt-
Gibt ein
VisualViewport
-Objekt zurück, das den visuellen Viewport für ein gegebenes Fenster repräsentiert. Window.window
Schreibgeschützt-
Gibt eine Referenz auf das aktuelle Fenster zurück.
window[0]
,window[1]
usw.-
Gibt eine Referenz auf das
window
-Objekt in den Frames zurück. SieheWindow.frames
für weitere Details.
Veraltete Eigenschaften
Window.event
Veraltet Schreibgeschützt-
Gibt das aktuelle Ereignis zurück, das das Ereignis ist, das gerade vom JavaScript-Code-Kontext verarbeitet wird, oder
undefined
, wenn momentan kein Ereignis verarbeitet wird. DasEvent
-Objekt, das direkt an Ereignishandler übergeben wird, sollte wann immer möglich stattdessen 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 Orientierung in Grad (in 90-Grad-Schritten) des Viewports relativ zur natürlichen Orientierung des Geräts zurück.
Window.status
Veraltet-
Ruft den Text in der Statusleiste am unteren Rand des Browsers ab bzw. setzt diesen.
Instanzmethoden
Dieses Interface erbt Methoden von der EventTarget
-Schnittstelle.
Window.atob()
-
Dekodiert einen String, der mit Base-64-Codierung kodiert wurde.
Window.alert()
-
Zeigt ein Dialogfeld mit einer Warnung an.
Window.blur()
Veraltet-
Entfernt den Fokus vom Fenster.
Window.btoa()
-
Erstellt einen Base-64-codierten ASCII-String aus einem String 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ückrufs. Window.clearInterval()
-
Bricht die wiederholte Ausführung ab, die mit
Window.setInterval()
festgelegt wurde. Window.clearTimeout()
-
Bricht die verzögerte Ausführung ab, die mit
Window.setTimeout()
festgelegt wurde. Window.close()
-
Schließt das aktuelle Fenster.
Window.confirm()
-
Zeigt ein Dialogfeld mit einer Nachricht an, auf die der Benutzer antworten muss.
Window.createImageBitmap()
-
Akzeptiert verschiedene Bildquellen und gibt eine
Promise
zurück, die auf einImageBitmap
aufgelöst wird. Optional wird die Quelle auf das rechteckige Pixelstück, das an (sx, sy) mit der Breite sw und der Höhe sh beginnt, zugeschnitten. Window.dump()
Nicht standardisiert-
Schreibt eine Nachricht in die Konsole.
Window.fetch()
-
Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.
Window.find()
Nicht standardisiert-
Sucht nach einem angegebenen String 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 standardmäßig berechneten Stil für das angegebene Element ab und ignoriert dabei die Autoren-Stylesheets.
Window.getScreenDetails()
Experimentell Sicherer Kontext-
Gibt eine
Promise
zurück, die mit einemScreenDetails
-Objektinstanz erfüllt wird, das die Details aller Bildschirme darstellt, die dem Gerät des Nutzers zur Verfügung stehen. Window.getSelection()
-
Gibt das Selektionsobjekt, das die ausgewählten Elemente repräsentiert, zurück.
Window.matchMedia()
-
Gibt ein
MediaQueryList
-Objekt zurück, das die angegebene Mediaquery-Zeichenfolge 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 einem anderen Fenster eine Zeichenfolge von Daten sendet, die sich nicht im selben Domainbereich befinden muss wie das erste.
Window.print()
-
Öffnet das Druckdialogfeld, um das aktuelle Dokument zu drucken.
Window.prompt()
-
Gibt den vom Benutzer in einem Eingabedialogfeld eingegebenen Text zurück.
Window.queryLocalFonts()
Experimentell Sicherer Kontext-
Gibt eine
Promise
zurück, die mit einem Array vonFontData
-Objekten erfüllt wird, die die lokal verfügbaren Schriftarten darstellen. Window.queueMicrotask()
-
Fügt eine Mikrotask-Warteschlange hinzu, die zu einem sicheren Zeitpunkt vor der Rückkehr der Steuerung zur Ereignisschleife des Browsers ausgeführt wird.
Window.reportError()
-
Meldet einen Fehler in einem Skript und emuliert eine nicht behandelbare Ausnahme.
Window.requestAnimationFrame()
-
Teilt dem Browser mit, dass eine Animation im Gange ist, und fordert den Browser auf, einen Neuaufbau des Fensters für den nächsten Animationsrahmen 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 an eine bestimmte Stelle 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 eine Funktion, die jedes Mal ausgeführt wird, wenn eine gegebene Anzahl von Millisekunden verstreicht.
Window.setTimeout()
-
Plant eine Funktion, die nach einer bestimmten Zeitspanne ausgeführt wird.
Window.showDirectoryPicker()
Experimentell Sicherer Kontext-
Zeigt einen Verzeichnis-Picker an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiauswahl-Dialog an, der es dem Benutzer ermöglicht, eine Datei oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dialog zum Speichern von Dateien an, der es dem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()
Nicht standardisiert-
Passt das Fenster an seine Inhalte an.
Window.stop()
-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()
-
Erstellt eine tiefe Kopie eines gegebenen Wertes mithilfe des strukturierten Klonalen Algorithmus.
Veraltete Methoden
Window.captureEvents()
Veraltet-
Registriert das Fenster zum Abfangen aller Ereignisse des angegebenen Typs.
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, Zugriff auf ein sandboxed Dateisystem für ihren eigenen Gebrauch 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 (no-op). Wird aus Gründen der Abwärtskompatibilität mit Netscape 4.x beibehalten.
Window.showModalDialog()
Nicht standardisiert Veraltet-
Zeigt einen modalen Dialog an.
Window.webkitConvertPointFromNodeToPage()
Nicht standardisiert Veraltet-
Transformiert einen
WebKitPoint
vom Koordinatensystem des Knotens in das der Seite. Window.webkitConvertPointFromPageToNode()
Nicht standardisiert Veraltet-
Transformiert einen
WebKitPoint
vom Koordinatensystem der Seite in das des Knotens.
Ereignisse
Hören Sie diese Ereignisse mit addEventListener()
oder durch Zuordnung eines Ereignis-Listeners zur oneventname
-Eigenschaft dieses Interfaces ab. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse, die aus dem Document
im Fensterobjekt stammen, blubbern.
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 Gültigkeitsbereich-Objekt 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 verändert wurde.
Zwischenablage-Ereignisse
copy
-
Wird ausgelöst, wenn der Benutzer eine Kopier-Aktion über die Benutzeroberfläche des Browsers initiiert. Auch über die
oncopy
-Eigenschaft verfügbar. cut
-
Wird ausgelöst, wenn der Benutzer eine Ausschneide-Aktion über die Benutzeroberfläche des Browsers initiiert. Auch über die
oncut
-Eigenschaft verfügbar. paste
-
Wird ausgelöst, wenn der Benutzer eine Einfüge-Aktion über die Benutzeroberfläche des Browsers initiiert. Auch über die
onpaste
-Eigenschaft verfügbar.
Verbindungsereignisse
Geräteorientierungsereignisse
devicemotion
Sicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und zeigt die Menge der physischen Beschleunigungsstärke, die das Gerät erhält, und die Drehgeschwindigkeit an, wenn verfügbar.
deviceorientation
Sicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen Orientierung des Geräts im Vergleich zum Erd-Koordinatenrahmen verfügbar sind.
deviceorientationabsolute
Sicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen absoluten Orientierung des Geräts im Vergleich zum Erd-Koordinatenrahmen verfügbar sind.
Fokusereignisse
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 wird.
gamepaddisconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufsereignisse
hashchange
-
Wird 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 ein anderes Dokument aus dem Verlaufsverlauf der Sitzung geladen wird. Dies geschieht beispielsweise, wenn der Benutzer die Zurück-Taste klickt oder wenn er die Vorwärts-Taste klickt, um im Sitzungsgeschichtsverlauf voranzukommen.
pagereveal
-
Wird ausgelöst, wenn ein Dokument erstmals gerendert wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder bei der Aktivierung eines Dokuments (entweder aus dem back/forward cache (bfcache) oder prerender).
pageshow
-
Wird gesendet, wenn der Browser das Dokument aufgrund von Navigationsaufgaben sichtbar macht, einschließlich nicht nur, wenn die Seite erstmals geladen wird, sondern auch in Situationen, in denen der Benutzer nach dem Navigieren zu einer anderen Seite im selben Tab zur vorherigen Seite zurückkehrt.
pageswap
-
Wird ausgelöst, wenn ein Dokument kurz vor dem Entladen aufgrund einer Navigation steht.
popstate
-
Wird ausgelöst, wenn sich der aktive Verlaufseintrag ändert.
Lade- und Entlade-Ereignisse
beforeunload
-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen kurz vor dem Entladen stehen.
load
-
Wird ausgelöst, wenn die gesamte Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets-Bilder.
unload
Veraltet-
Wird ausgelöst, wenn das Dokument oder eine Kindressource 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 kurz davor steht, aufgefordert zu werden, eine Webanwendung zu installieren.
Messaging-Ereignisse
message
-
Wird ausgelöst, wenn das Fenster eine Nachricht erhält, beispielsweise durch einen Aufruf von
Window.postMessage()
aus einem anderen Durchsuchungskontext. 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 begonnen hat zu drucken oder die Druckvorschau geschlossen wurde.
beforeprint
-
Wird ausgelöst, wenn das zugehörige Dokument kurz vor dem Drucken oder der Vorschau gedruckt wird.
Promise-Abgelehnte Ereignisse
rejectionhandled
-
Wird jedes Mal gesendet, wenn ein JavaScript
Promise
abgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, um die Ablehnung zu erfassen oder nicht. unhandledrejection
-
Wird gesendet, wenn ein JavaScript
Promise
abgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung zu erfassen.
Scrollereignisse
scrollsnapchange
Experimentell-
Wird am Scroll-Container am Ende eines Scroll-Vorgangs ausgelöst, wenn ein neues Scrollsnap-Ziel ausgewählt wurde.
scrollsnapchanging
Experimentell-
Wird am Scroll-Container ausgelöst, wenn der Browser bestimmt, dass ein neues Scrollsnap-Ziel bevorsteht, 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 präsentiert werden kann.
vrdisplayconnect
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.
vrdisplaydisconnect
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivate
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display nicht mehr präsentiert werden kann.
vrdisplaypresentchange
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert — d.h. vom Präsentieren zum Nicht-Präsentieren oder umgekehrt.
Gebubbelte Ereignisse
Nicht alle Ereignisse, die bubbeln, können das Window
-Objekt erreichen. Nur die folgenden tun dies und können auf dem 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.
Ereignisse im Fenster lauschen
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu lauschen:
- Fügen Sie dem Element mit der Methode
EventTarget.addEventListener
einen Ereignis-Listener hinzu. - Weisen Sie dem
oneventname
-Eigenschaft des Elements in JavaScript einen Ereignis-Handler zu. - Fügen Sie dem Element im HTML ein Prefix-Attribut
on
hinzu.
Um Ereignissen auf Window
-Objekten zu lauschen, können in der Regel nur die ersten beiden Methoden verwendet werden, da es kein entsprechendes HTML-Element für Window
gibt. 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:
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, das als currentTarget
protokolliert wird.
Spezifikationen
Specification |
---|
HTML # the-window-object |