Fenster
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 document.defaultView
-Eigenschaft abgerufen werden.
Eine globale Variable, window
, die das Fenster repräsentiert, in dem das Skript läuft, ist im JavaScript-Code verfügbar.
Das Window
-Interface beherbergt eine Vielzahl von Funktionen, Namensräumen, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächen-Fensters assoziiert sind. Jedoch ist das Window
-Interface ein geeigneter Ort, um diese Elemente aufzunehmen, die global verfügbar sein müssen. Viele dieser Funktionen sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem Browser mit Tabs wird jeder Tab durch ein eigenes Window
-Objekt repräsentiert; das globale window
, das vom JavaScript-Code gesehen wird, der innerhalb eines gegebenen Tabs läuft, repräsentiert immer den Tab, in dem der Code ausgeführt wird. Das gesagt, selbst in einem Browser mit Tabs gelten einige Eigenschaften und Methoden weiterhin für das Gesamtfenster, das den Tab enthält, wie resizeTo()
und innerHeight
. Im Allgemeinen bezieht sich alles, was nicht vernünftigerweise auf einen Tab zutreffen kann, stattdessen auf das Fenster.
Instanz-Eigenschaften
Dieses Interface erbt Eigenschaften vom EventTarget
-Interface.
Beachten Sie, dass Eigenschaften, die Objekte sind (z.B. zum Überlagern 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 zur Offline-Nutzung und das Erzeugen von benutzerdefinierten 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 angibt, ob das aktuelle Dokument innerhalb eines credentialless
<iframe>
geladen wurde. Siehe IFrame credentialless für weitere Details. Window.crossOriginIsolated
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob die Website sich in einem Zustande der cross-origin Isolation 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, 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 in der aktuellen Anzeige 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 Instanz des
Fence
-Objekts für den aktuellen Dokumentkontext zurück. Nur für Dokumente verfügbar, die innerhalb eines<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 Unterrahmen 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 Verlaufsobjekt zurück.
Window.indexedDB
Schreibgeschützt-
Bietet einen Mechanismus für Anwendungen, asynchron auf die Fähigkeiten von indexierten Datenbanken zuzugreifen; gibt ein
IDBFactory
-Objekt zurück. Window.innerHeight
Schreibgeschützt-
Ruft die Höhe des Inhaltsbereichs des Browserfensters ab, einschließlich der horizontalen Scrollleiste, falls dargestellt.
Window.innerWidth
Schreibgeschützt-
Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich der vertikalen Scrollleiste, falls dargestellt.
Window.isSecureContext
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob der aktuelle Kontext sicher (
true
) oder unsicher (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, bietetlaunchQueue
Zugriff auf dieLaunchQueue
-Klasse, die es ermöglicht, eine benutzerdefinierte Startnavigationsbehandlung 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 verwendet wird, um Daten zu speichern, die nur vom Ursprungsort aus abgerufen werden können, der es erstellt hat.
Window.location
-
Ruft den Ort bzw. die aktuelle URL des Fensterobjekts ab oder setzt diese.
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 zu Bildschirm-Pixeln bei Bedarf. 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 zu Bildschirm-Pixeln bei Bedarf. Window.name
-
Ruft den Namen des Fensters ab oder setzt ihn.
-
Gibt das aktuelle
window
's zugehörigeNavigation
-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 die Ursprungsadresse des globalen Objekts zurück, serialisiert als Zeichenkette.
Window.originAgentCluster
Schreibgeschützt-
Gibt
true
zurück, wenn dieses Fenster zu einem ursprünglich-geschlüsselten 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 Elternfenster des aktuellen Fensters oder Unterrahmens zurück.
Window.performance
Schreibgeschützt-
Gibt ein
Performance
-Objekt zurück, das dietiming
- undnavigation
-Attribute enthält, von denen jedes ein Objekt ist, das leistungsbezogene Daten bereitstellt. Siehe auch The Navigation Timing API für zusätzliche Informationen und Beispiele. Window.personalbar
Schreibgeschützt-
Gibt das personalbar-Objekt zurück.
Window.scheduler
Schreibgeschützt-
Gibt das mit dem aktuellen Kontext verbundene
Scheduler
-Objekt zurück. Dies ist der Einstiegsort für die Verwendung 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 Ansichtsbereichs des Browsers zur linken Seite des Bildschirms zurück.
Window.screenY
undWindow.screenTop
Schreibgeschützt-
Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Ansichtsbereichs 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, zu dem das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus der Ansichtsfensterbreite.
Window.scrollMaxY
Nicht standardisiert Schreibgeschützt-
Der maximale Versatz, zu dem das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthö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 Objektreferenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage
-
Gibt eine Referenz auf das Sitzungspeicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur vom Ursprungsort aus abgerufen werden können, der es erstellt hat.
-
Gibt das
WindowSharedStorage
-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt zum Schreiben von Daten in den freigegebenen Speicher mithilfe der Shared Storage API. Window.speechSynthesis
Schreibgeschützt-
Gibt ein
SpeechSynthesis
-Objekt zurück, das der Einstiegspunkt für die Verwendung der Sprachsynthesefunktionalität der Web Speech API 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 mit dem globalen Objekt assoziierte
TrustedTypePolicyFactory
-Objekt zurück, das der Einstiegspunkt für die Verwendung der Trusted Types API ist. Window.visualViewport
Schreibgeschützt-
Gibt ein
VisualViewport
-Objekt zurück, das 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 Rahmen zurück. SieheWindow.frames
für weitere Details. - Benannte Eigenschaften
-
Einige Elemente im Dokument werden auch als Fenstereigenschaften bereitgestellt:
- Für jedes
<embed>
,<form>
,<iframe>
,<img>
und<object>
-Element wird dessenname
(falls nicht leer) bereitgestellt. Zum Beispiel, wenn das Dokument<form name="my_form">
enthält, dann gibtwindow["my_form"]
(und dessen Äquivalentwindow.my_form
) eine Referenz auf dieses Element zurück. - Für jedes HTML-Element wird dessen
id
(falls nicht leer) bereitgestellt.
Wenn eine Eigenschaft einem einzigen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird ein
HTMLCollection
zurückgegeben, die alle enthält. Wenn eines der Elemente ein navigierbares<iframe>
oder<object>
ist, wird stattdessen dascontentWindow
des ersten solchen iframes zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.event
Veraltet Schreibgeschützt-
Gibt das aktuelles Ereignis zurück, das Ereignis, das derzeit vom Kontext des JavaScript-Codes behandelt wird, oder
undefined
, wenn derzeit kein Ereignis behandelt wird. DasEvent
-Objekt, das direkt an Ereignis-Handler übergeben wird, sollte wann immer möglich anstelle dessen 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 Drehung in Grad (in 90-Grad-Schritten) des Ansichtsfensters 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 oder setzt ihn.
Instanz-Methoden
Dieses Interface erbt Methoden vom EventTarget
-Interface.
Window.atob()
-
Dekodiert einen Datenstring, der mit Base-64-Codierung kodiert wurde.
Window.alert()
-
Zeigt einen Alarmdialog an.
Window.blur()
Veraltet-
Entfernt den Fokus vom Fenster.
Window.btoa()
-
Erzeugt einen Base-64-codierten ASCII-String aus einem String von Binärdaten.
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 einen Dialog mit einer Nachricht an, auf die der Benutzer reagieren muss.
Window.createImageBitmap()
-
Akzeptiert verschiedene Bildquellen und gibt ein
Promise
zurück, das zu einemImageBitmap
aufgelöst wird. Optionale wird die Quelle auf das Rechteck der Pixel mit Ursprung bei (sx, sy) mit Breite sw und Höhe sh zugeschnitten. Window.dump()
Nicht standardisiert-
Schreibt eine Nachricht in die Konsole.
Window.fetch()
-
Startet den Vorgang des Abrufens einer Ressource aus dem Netzwerk.
Window.fetchLater()
Experimentell-
Erstellt einen verzögerten Abruf, der gesendet wird, sobald die Seite verlassen wird (entweder zerstört oder in den bfcache verschoben wird), oder nach einem angegebenen
activateAfter
-Timeout - was auch immer zuerst eintritt. Window.find()
Nicht standardisiert-
Sucht nach einem bestimmten 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 Standard berechneten Stil für das angegebene Element ab, ohne Berücksichtigung von Autoren-Stylesheets.
Window.getScreenDetails()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das mit einemScreenDetails
-Objekt gefüllt ist, das die Details aller auf dem Gerät des Benutzers verfügbaren Bildschirme repräsentiert. Window.getSelection()
-
Gibt das Auswahlobjekt zurück, das die ausgewählten Elemente repräsentiert.
Window.matchMedia()
-
Gibt ein
MediaQueryList
-Objekt zurück, das die angegebene Media Query-String repräsentiert. 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 einen sicheren Weg für ein Fenster, eine Datenzeichenkette an ein anderes Fenster zu senden, das nicht innerhalb derselben Domain wie das erste liegen muss.
Window.print()
-
Öffnet den Druckdialog, um das aktuelle Dokument zu drucken.
Window.prompt()
-
Gibt den Text zurück, den der Benutzer in einem Eingabefeld-Dialog eingegeben hat.
Window.queryLocalFonts()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das mit einem Array vonFontData
-Objekten erfüllt ist, die die lokal verfügbaren Schriftarten repräsentieren. Window.queueMicrotask()
-
Fügt eine Mikroaufgabe zur Ausführung zu einem sicheren Zeitpunkt hinzu, bevor die Kontrolle an die Eventschleife des Browsers zurückgegeben wird.
Window.reportError()
-
Meldet einen Fehler in einem Skript und emuliert eine nicht abgefangene Ausnahme.
Window.requestAnimationFrame()
-
Informiert den Browser, dass eine Animation in Bearbeitung ist, und fordert den Browser auf, ein Neuzeichnen des Fensters für den nächsten Animationsrahmen zu planen.
Window.requestIdleCallback()
-
Ermöglicht die Planung von Aufgaben während der Leerlaufzeiten des 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 Koordinatenwert 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 in einem angegebenen Zeitraum.
Window.showDirectoryPicker()
Experimentell Sicherer Kontext-
Zeigt einen Verzeichnisauswähler an, mit dem der Benutzer ein Verzeichnis auswählen kann.
Window.showOpenFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiauswähler an, mit dem ein Benutzer eine oder mehrere Dateien auswählen kann.
Window.showSaveFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiauswähler an, mit dem ein Benutzer eine Datei speichern kann.
Window.sizeToContent()
Nicht standardisiert-
Passt das Fenster an seinen Inhalt an.
Window.stop()
-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()
-
Erstellt eine tiefe Kopie eines angegebenen Wertes unter Verwendung des strukturierten Kopieralgorithmus.
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-
Gibt das Fenster aus dem Festhalten von Ereignissen eines bestimmten Typs frei.
Window.requestFileSystem()
Nicht standardisiert Veraltet-
Ermöglicht es einer Website oder App, Zugriff auf ein sandkastiertes Dateisystem für den eigenen Gebrauch zu erhalten.
Window.setImmediate()
Nicht standardisiert Veraltet-
Führt eine Funktion aus, nachdem der Browser andere aufwendige Aufgaben abgeschlossen hat.
Window.setResizable()
Nicht standardisiert Veraltet-
Tut nichts (no-op). Wird zur Rückwärtskompatibilität mit Netscape 4.x beibehalten.
Window.webkitConvertPointFromNodeToPage()
Nicht standardisiert Veraltet-
Wandelt einen
WebKitPoint
vom Koordinatensystem des Knotens in das der Seite um. Window.webkitConvertPointFromPageToNode()
Nicht standardisiert Veraltet-
Wandelt einen
WebKitPoint
vom Koordinatensystem der Seite in das des Knotens um.
Ereignisse
Hören Sie diese Ereignisse durch die Verwendung der Methode addEventListener()
oder durch Zuweisen eines Ereignis-Handlers zur oneventname
-Eigenschaft dieser Schnittstelle. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom im Fensterobjekt enthaltenen Document
gebubbelt werden.
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 Scope-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.
Verbindungsevents
Gerätorientierungsevents
devicemotion
Sicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und zeigt die Menge der physischen Beschleunigungskräfte an, die auf das Gerät wirken, sowie die Rotationsrate, falls verfügbar.
deviceorientation
Sicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
deviceorientationabsolute
Sicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen absoluten Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
Fokusevents
Gamepad-Ereignisse
gamepadconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder zum ersten Mal eine Taste/Achse des Gamepads verwendet wird.
gamepaddisconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
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 er gerade dabei ist, ein anderes Dokument aus dem Sitzungsverlauf an seiner Stelle anzuzeigen. Dies geschieht zum Beispiel, wenn der Benutzer die Zurück-Schaltfläche klickt oder die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf weiterzugehen.
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, einschließlich nicht nur, wenn die Seite erstmals geladen wird, sondern auch in Situationen wie dem Zurücknavigieren des Benutzers zur Seite, nachdem er innerhalb desselben Tabs zu einer anderen Seite navigiert ist.
pageswap
-
Wird ausgelöst, wenn ein Dokument entladen werden soll, weil eine Navigation stattfindet.
popstate
-
Wird ausgelöst, wenn der aktive Verlaufseintrag geändert wird.
Lade- & Entlade-Ereignisse
beforeunload
-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen gerade 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 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 im Begriff ist, aufgefordert zu werden, eine Web-Anwendung zu installieren.
Messaging-Ereignisse
message
-
Wird ausgelöst, wenn das Fenster eine Nachricht erhält, zum Beispiel von einem Aufruf von
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 das Drucken gestartet hat oder die Druckvorschau geschlossen wurde.
beforeprint
-
Wird ausgelöst, wenn das zugehörige Dokument gedruckt oder zur Druckvorschau angezeigt wird.
Ereignisse bei Ablehnung von Versprechen
rejectionhandled
-
Wird jedes Mal gesendet, wenn ein JavaScript-
Promise
abgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, um die Ablehnung zu behandeln, oder nicht. unhandledrejection
-
Wird gesendet, wenn ein JavaScript-
Promise
abgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung zu behandeln.
Scrollereignisse
scrollsnapchange
Experimentell-
Wird am Scroll-Container am Ende eines Scroll-Vorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging
Experimentell-
Wird am Scroll-Container ausgelöst, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel aussteht, d.h. es wird ausgewählt, sobald die aktuelle Scroll-Geste beendet ist.
Veraltete Ereignisse
orientationchange
Veraltet-
Wird ausgelöst, wenn sich die Ausrichtung 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 – also von „präsentierend“ zu „nicht präsentierend“ geht, oder umgekehrt.
Gebubbelte Ereignisse
Nicht alle Ereignisse, die gebubbelt werden, können das Window
-Objekt erreichen. Nur die folgenden können am Window
-Objekt gehö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.
Lauschen auf Ereignisse auf Window
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu lauschen:
- Fügen Sie einen Event-Listener zum Element hinzu, indem Sie die Methode
EventTarget.addEventListener
verwenden. - Weisen Sie einen Event-Handler der
oneventname
-Eigenschaft des Elements in JavaScript zu. - Fügen Sie dem Element im HTML ein Attribut mit dem Präfix
on
hinzu.
Um auf Ereignisse auf Window
-Objekten zu lauschen, können Sie im Allgemeinen nur die ersten beiden Methoden verwenden, da Window
kein entsprechendes HTML-Element hat. Es gibt jedoch eine spezielle Gruppe von Ereignissen, deren Listener dem <body>
-Element (oder dem veralteten <frameset>
-Element) zugewiesen werden können, das im Dokument des Window
-Objekts enthalten ist, indem Sie die zweite oder dritte Methode verwenden. Diese Ereignisse sind:
afterprint
beforeprint
beforeunload
blur
error
focus
hashchange
languagechange
load
message
messageerror
offline
online
pagehide
pagereveal
pageshow
pageswap
popstate
rejectionhandled
resize
scroll
storage
unhandledrejection
unload
Dies bedeutet, dass die folgenden strikt 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
, das protokolliert wird.
Spezifikationen
Specification |
---|
HTML # the-window-object |