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.
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 über die document.defaultView
-Eigenschaft abgerufen werden.
Eine globale Variable, window
, die das Fenster repräsentiert, in dem das Skript ausgeführt wird, wird dem JavaScript-Code zur Verfügung gestellt.
Die Window
-Schnittstelle beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters in Verbindung stehen. Die Window
-Schnittstelle ist jedoch ein geeigneter Ort, um diese Elemente, die global verfügbar sein müssen, einzuschließen. Viele dieser Elemente sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem Tab-basierten Browser wird jeder Tab durch ein eigenes Window
-Objekt dargestellt; das globale window
, das von JavaScript-Code gesehen wird, der innerhalb eines bestimmten Tabs ausgeführt wird, repräsentiert immer den Tab, in dem der Code ausgeführt wird. Das gesagt, auch in einem Tab-basierten Browser gelten einige Eigenschaften und Methoden weiterhin für das Gesamtfenster, das den Tab enthält, wie zum Beispiel resizeTo()
und innerHeight
. Allgemein gilt: Alles, was nicht vernünftigerweise auf einen Tab zutreffen kann, bezieht sich auf das Fenster stattdessen.
Instanzeigenschaften
Diese Schnittstelle erbt Eigenschaften von der EventTarget
-Schnittstelle.
Beachten Sie, dass Eigenschaften, die Objekte sind (zum Beispiel zum Überschreiben des Prototyps eingebauter Elemente), 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 verknüpft ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Assets für die Offline-Nutzung und das Generieren 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 zum
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 in einem credentialless
<iframe>
geladen wurde. Weitere Informationen finden Sie unter IFrame credentialless. Window.crossOriginIsolated
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob die Website sich in einem Cross-Origin-Isolation-Zustand 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 zuvor registrierte benutzerdefinierte Elemente abzurufen. 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 Instanz eines
Fence
-Objekts für den aktuellen Dokumentkontext zurück. Nur verfügbar für Dokumente, die in einem<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 eine Möglichkeit für Anwendungen, asynchron auf die Funktionen indizierter Datenbanken zuzugreifen; gibt ein
IDBFactory
-Objekt zurück. Window.innerHeight
Schreibgeschützt-
Gibt die Höhe des Inhaltsbereichs des Browserfensters einschließlich der horizontalen Bildlaufleiste zurück, falls diese gerendert wird.
Window.innerWidth
Schreibgeschützt-
Gibt die Breite des Inhaltsbereichs des Browserfensters einschließlich der vertikalen Bildlaufleiste zurück, falls diese gerendert wird.
Window.isSecureContext
Schreibgeschützt-
Gibt einen booleschen Wert 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
Zugang zurLaunchQueue
-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 verwendet wird, um Daten zu speichern, auf die nur von dem Ursprungsort, der es erstellt hat, zugegriffen werden kann.
Window.location
-
Ruft den Standort, oder 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 Ansichtsbereichs des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln gemeldet. Siehe
mozScreenPixelsPerCSSPixel
innsIDOMWindowUtils
für einen Umrechnungsfaktor zur Anpassung an Bildschirm-Pixel, falls erforderlich. Window.mozInnerScreenY
Schreibgeschützt Nicht standardisiert-
Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Ansichtsbereichs des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln gemeldet. Siehe
mozScreenPixelsPerCSSPixel
für einen Umrechnungsfaktor zur Anpassung an Bildschirm-Pixel, falls erforderlich. Window.name
-
Ruft den Namen des Fensters ab oder setzt ihn.
-
Gibt das mit dem aktuellen
window
verknüpfteNavigation
-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 ursprungs-gekapselten Agenten-Cluster gehört. Window.outerHeight
Schreibgeschützt-
Ruft die Höhe außerhalb des Browserfensters ab.
Window.outerWidth
Schreibgeschützt-
Ruft die Breite außerhalb 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, von denen jedes ein Objekt ist, das leistungsbezogene Daten bereitstellt. 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 verknüpft ist. Dies ist der Einstiegspunkt für die Verwendung der Prioritized Task Scheduling API. Window.screen
Schreibgeschützt-
Gibt eine Referenz auf das screen-Objekt zurück, das mit dem Fenster verknüpft ist.
Window.screenX
undWindow.screenLeft
Schreibgeschützt-
Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Benutzer-Browseransichtsbereichs zur linken Seite des Bildschirms zurück.
Window.screenY
undWindow.screenTop
Schreibgeschützt-
Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Benutzer-Browseransichtsbereichs 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 die Ansichtsbereichsbreite.
Window.scrollMaxY
Nicht standardisiert Schreibgeschützt-
Der maximale Versatz, zu dem das Fenster vertikal gescrollt werden kann (d.h. die Dokumentenhöhe minus die Ansichtsbereichshö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, auf die nur von dem Ursprungsort, der es erstellt hat, zugegriffen werden kann.
-
Gibt das
WindowSharedStorage
-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt, um Daten in einen gemeinsamen Speicher zu schreiben, der die Shared Storage API verwendet. Window.speechSynthesis
Schreibgeschützt-
Gibt ein
SpeechSynthesis
-Objekt zurück, das den Einstieg in die Verwendung der Web Speech API-Sprachsynthesefunktionalität darstellt. 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 verknüpft 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 Ansichtsbereich 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 finden Sie unterWindow.frames
.
Veraltete Eigenschaften
Window.event
Veraltet Schreibgeschützt-
Gibt das aktuelle Ereignis zurück, das Ereignis, das derzeit vom JavaScript-Code-Kontext behandelt wird, oder
undefined
, wenn derzeit kein Ereignis verarbeitet wird. DasEvent
-Objekt, das direkt an Ereignishandler übergeben wird, sollte stattdessen verwendet werden, wann immer möglich. 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 Ansichtsbereichs relativ 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.
Instanzmethoden
Diese Schnittstelle erbt Methoden von der EventTarget
-Schnittstelle.
Window.atob()
-
Dekodiert eine Zeichenfolge von Daten, die mithilfe der Base-64-Codierung kodiert wurde.
Window.alert()
-
Zeigt ein Warnungsdialogfeld an.
Window.blur()
Veraltet-
Defokussiert das Fenster.
Window.btoa()
-
Erstellt eine Base-64-kodierte ASCII-Zeichenfolge aus einer Zeichenfolge 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()
-
Hebt die wiederholte Ausführung auf, die mit
Window.setInterval()
festgelegt wurde. Window.clearTimeout()
-
Hebt die verzögerte Ausführung auf, 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 verschiedener 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) beginnt, mit einer Breite sw und einer Höhe sh. 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 navigiert wird (sie wird zerstört oder betritt den bfcache), oder nach einem angegebenen
activateAfter
-Timeout — je nachdem, was zuerst eintritt. Window.find()
Nicht standardisiert-
Sucht nach einer gegebenen Zeichenkette in einem Fenster.
Window.focus()
-
Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()
-
Holt den berechneten Stil für das angegebene Element. Der berechnete Stil gibt die berechneten Werte aller CSS-Eigenschaften des Elements an.
Window.getDefaultComputedStyle()
Nicht standardisiert-
Holt den Standard berechneten Stil für das angegebene Element und ignoriert Autoren-Stylesheets.
Window.getScreenDetails()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das sich mit einerScreenDetails
-Objektinstanz auflöst, die die Details aller Bildschirme repräsentiert, die auf dem Gerät des Benutzers verfügbar sind. 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-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 eine Datenzeichenfolge an ein anderes Fenster sendet, das sich nicht notwendigerweise in derselben Domäne wie das erste befindet.
Window.print()
-
Öffnet den Druckdialog, um das aktuelle Dokument zu drucken.
Window.prompt()
-
Gibt den Text zurück, den der Benutzer in ein Eingabedialogfeld eingegeben hat.
Window.queryLocalFonts()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das sich mit einem Array vonFontData
-Objekten auflöst, die die Schriftarten darstellen, die lokal verfügbar sind. Window.queueMicrotask()
-
Platziert eine Mikrotask in einer Warteschlange, die zu einem sicheren Zeitpunkt vor der Rückgabe der Kontrolle an die Ereignisschleife des Browsers ausgeführt werden soll.
Window.reportError()
-
Meldet einen Fehler in einem Skript und emuliert eine unbehandelte Ausnahme.
Window.requestAnimationFrame()
-
Sagt dem Browser, dass eine Animation im Gange ist, und fordert den Browser auf, einen Neuzeichen der Fenster 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 dynamisch die Größe des Fensters.
Window.scroll()
-
Scrollt das Fenster an einen 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 gegebene Anzahl von Millisekunden verstrichen ist.
Window.setTimeout()
-
Plant die Ausführung einer Funktion nach einer bestimmten Zeit.
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 Dateiauswahldialog an, der es dem Benutzer ermöglicht, eine oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der es dem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()
Nicht standardisiert-
Passt die Fenstergröße entsprechend dem Inhalt an.
Window.stop()
-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()
-
Erstellt eine tiefgehende Kopie eines gegebenen Wertes unter Verwendung des Structured Clone Algorithmus.
Veraltete Methoden
Window.captureEvents()
Veraltet-
Registriert das Fenster, um alle Ereignisse des angegebenen Typs zu erfassen.
Window.clearImmediate()
Nicht standardisiert Veraltet-
Hebt die wiederholte Ausführung auf, die mit
setImmediate()
festgelegt wurde. Window.releaseEvents()
Veraltet-
Lässt das Fenster aufhören, Ereignisse eines bestimmten Typs abzufangen.
Window.requestFileSystem()
Nicht standardisiert Veraltet-
Ermöglicht es einer Website oder App, Zugriff auf ein sandkastenbasiertes Dateisystem für ihre eigene Nutzung zu erhalten.
Window.setImmediate()
Nicht standardisiert Veraltet-
Führt eine Funktion aus, nachdem der Browser andere aufwändige Aufgaben beendet hat.
Window.setResizable()
Nicht standardisiert Veraltet-
Macht nichts (no-op). Beibehalten für die Rückwärtskompatibilität mit Netscape 4.x.
Window.showModalDialog()
Nicht standardisiert Veraltet-
Zeigt ein modales Dialogfeld an.
Window.webkitConvertPointFromNodeToPage()
Nicht standardisiert Veraltet-
Transformiert einen
WebKitPoint
vom Koordinatensystem des Knotens zum Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()
Nicht standardisiert Veraltet-
Transformiert einen
WebKitPoint
vom Koordinatensystem der Seite zum Koordinatensystem des Knotens.
Ereignisse
Hören Sie diese Ereignisse mit addEventListener()
oder durch Zuweisen eines Ereignislisteners zur oneventname
-Eigenschaft dieser Schnittstelle ab. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse aus dem im Fensterobjekt enthaltenen Document
aufsteigen.
error
-
Wird ausgelöst, wenn eine Ressource nicht geladen werden kann 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 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 modifiziert wurde.
Zwischenablage-Ereignisse
copy
-
Wird ausgelöst, wenn der Benutzer eine Kopieraktion über die Benutzeroberfläche des Browsers initiiert. Auch über die
oncopy
-Eigenschaft verfügbar. cut
-
Wird ausgelöst, wenn der Benutzer eine Ausschneideaktion über die Benutzeroberfläche des Browsers initiiert. Auch über die
oncut
-Eigenschaft verfügbar. paste
-
Wird ausgelöst, wenn der Benutzer eine Einfügeaktion über die Benutzeroberfläche des Browsers initiiert. Auch über die
onpaste
-Eigenschaft verfügbar.
Verbindung-Ereignisse
Geräteausrichtungen-Ereignisse
devicemotion
Sicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und gibt die Menge an physikalischer Beschleunigungskraft an, die das Gerät empfängt, sowie die Rotationsrate, falls verfügbar.
deviceorientation
Sicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Ausrichtungssensor über die aktuelle Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
deviceorientationabsolute
Sicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Ausrichtungssensor über die aktuelle absolute Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
Fokus-Ereignisse
Gamepad-Ereignisse
gamepadconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder das erste Mal, dass eine Taste/ein Achse des Gamepads verwendet wird.
gamepaddisconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufs-Ereignisse
hashchange
-
Wird ausgelöst, wenn sich der Fragmentbezeichner der URL geändert hat (der Teil der URL, der mit
#
beginnt und darauf folgt). pagehide
-
Wird gesendet, wenn der Browser das aktuelle Dokument versteckt, während er dabei ist, ein anderes Dokument aus dem Sitzungsverlauf an seiner Stelle anzuzeigen. Dies passiert zum Beispiel, wenn der Benutzer die Zurück-Schaltfläche klickt oder wenn er die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf voranzugehen.
pagereveal
-
Wird ausgelöst, wenn ein Dokument zum ersten Mal gerendert wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder bei der Aktivierung eines Dokuments (entweder aus back/forward cache (bfcache) oder prerender).
pageshow
-
Wird gesendet, wenn der Browser das Dokument aufgrund von Navigation tasks sichtbar macht, einschließlich nicht nur beim ersten Laden der Seite, sondern auch Situationen wie der Benutzer kehrt zur Seite zurück, nachdem er zu einem anderen innerhalb desselben Tabs navigiert hat.
pageswap
-
Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation entladen werden soll.
popstate
-
Wird ausgelöst, wenn der aktuelle Eintrag in der Verlaufshistorie sich ändert.
Lade- & Entlade-Ereignisse
beforeunload
-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen dabei sind, entladen zu werden.
load
-
Wird ausgelöst, wenn die gesamte Seite geladen ist, 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 erfolgreich eine Seite als Anwendung installiert hat.
beforeinstallprompt
-
Wird ausgelöst, wenn ein Benutzer dabei ist, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichten-Ereignisse
message
-
Wird ausgelöst, wenn das Fenster eine Nachricht erhält, zum Beispiel von einem Aufruf an
Window.postMessage()
aus einem anderen Browsing-Kontext. messageerror
-
Wird ausgelöst, wenn ein
Window
-Objekt eine Nachricht empfängt, die nicht deserialisiert werden kann.
Druck-Ereignisse
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 werden soll oder zur Druckvorschau bereit ist.
Promise-Ablehnungsereignisse
rejectionhandled
-
Wird gesendet, jedes Mal 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, aber kein Handler vorhanden ist, um die Ablehnung abzufangen.
Scroll-Ereignisse
scrollsnapchange
Experimentell-
Wird am Scrollcontainer am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Scrollsnap-Ziel ausgewählt wurde.
scrollsnapchanging
Experimentell-
Wird am Scrollcontainer ausgelöst, wenn der Browser ein neues Scrollsnap-Ziel bestimmt, das in Aussicht steht, d.h. ausgewählt wird, wenn die aktuelle Scrollgeste 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 Darstellungszustand eines VR-Geräts ändert - d.h. von Darstellen zu Nicht-Darstellen wechselt oder umgekehrt.
Aufgestiegene Ereignisse
Nicht alle Ereignisse, die aufsteigen können, erreichen das Window
-Objekt. Nur die folgenden können angehört und auf dem 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.
Ereignisabhörung auf Window
HTML-Elemente haben drei Möglichkeiten, Ereignisse zu hören:
- Fügen Sie einen Ereignislistener zu dem Element hinzu, indem Sie die Methode
EventTarget.addEventListener
verwenden. - Weisen Sie einen Ereignishandler der Eigenschaft
oneventname
des Elements in JavaScript zu. - Fügen Sie dem Element im HTML ein Attribut mit
on
-Präfix hinzu.
Um Ereignisse auf Window
-Objekten zu hören, können Sie im Allgemeinen nur die ersten beiden Methoden verwenden, da Window
kein entsprechendes HTML-Element hat. Es gibt jedoch eine spezielle Gruppe von Ereignissen, deren Listener zum <body>
(oder dem veralteten <frameset>
) Element hinzugefügt werden können, das dem Dokument des Window
gehört, mit 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
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
geloggt.
Spezifikationen
Specification |
---|
HTML # the-window-object |