Window
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 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 mit der document.defaultView
-Eigenschaft abgerufen werden.
Eine globale Variable, window
, die das Fenster darstellt, in dem das Skript ausgeführt wird, ist für JavaScript-Code verfügbar.
Das Window
-Interface beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verknüpft sind. Doch das Window
-Interface ist ein geeigneter Platz, um diese Elemente einzubeziehen, 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 ihr eigenes Window
-Objekt repräsentiert; das globale window
, das von JavaScript-Code innerhalb einer bestimmten Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Dennoch, selbst in einem Browser mit Registerkarten, gelten einige Eigenschaften und Methoden immer noch für das gesamte Fenster, das die Registerkarte enthält, wie zum Beispiel resizeTo()
und innerHeight
. Im Allgemeinen bezieht sich alles, was sich nicht vernünftigerweise auf eine Registerkarte beziehen kann, stattdessen auf das Fenster.
Instanzeigenschaften
Dieses Interface erbt Eigenschaften vom EventTarget
-Interface.
Beachten Sie, dass Eigenschaften, die Objekte sind (z.B. für das Überschreiben des Prototyps von eingebauten Elementen), in einem separaten Abschnitt unten aufgeführt sind.
Window.caches
Schreibgeschützt Sicherer Kontext-
Gibt das
CacheStorage
-Objekt zurück, das mit dem aktuellen Kontext 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 zeigt an, ob das aktuelle Fenster geschlossen ist oder nicht.
-
Gibt eine Referenz auf das
CookieStore
-Objekt für den aktuellen Dokumentenkontext zurück. Window.credentialless
Schreibgeschützt Experimentell-
Gibt einen booleschen Wert zurück, der angibt, ob das aktuelle Dokument in einem glaubensunabhängigen
<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 plattformübergreifenden Isolationszustand befindet.
Window.crypto
Schreibgeschützt-
Gibt das
Crypto
-Objekt zurück, das mit dem globalen Objekt verknüpft 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 zuvor registrierte benutzerdefinierte Elemente verwendet werden kann. Window.devicePixelRatio
Schreibgeschützt-
Gibt das Verhältnis zwischen physikalischen Pixeln und geräteunabhängigen Pixeln auf dem 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 Dokumentenkontext zurück.
Window.fence
Schreibgeschützt Experimentell-
Gibt eine
Fence
-Objektinstanz für den aktuellen Dokumentenkontext zurück. Nur für Dokumente verfügbar, 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 zeigt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.
Window.history
Schreibgeschützt-
Gibt eine Referenz auf das Historien-Objekt zurück.
Window.indexedDB
Schreibgeschützt-
Bietet eine Mechanismus für Anwendungen, um asynchron auf Funktionen von indizierten Datenbanken zuzugreifen; gibt ein
IDBFactory
-Objekt zurück. Window.innerHeight
Schreibgeschützt-
Ermittelt die Höhe des Inhaltsbereichs des Browserfensters, einschließlich, wenn gerendert, der horizontalen Bildlaufleiste.
Window.innerWidth
Schreibgeschützt-
Ermittelt die Breite des Inhaltsbereichs des Browserfensters, einschließlich, wenn gerendert, der vertikalen Bildlaufleiste.
Window.isSecureContext
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob der aktuelle Kontext sicher (
true
) oder nicht (false
) ist. Window.launchQueue
Schreibgeschützt Experimentell-
Wenn eine Progressive Web App (PWA) mit einem
launch_handler
client_mode
-Wert vonfocus-existing
,navigate-new
odernavigate-existing
gestartet wird, bietet dielaunchQueue
Zugriff auf dieLaunchQueue
-Klasse, die es ermöglicht, benutzerdefinierte Startnavigation für die PWA zu implementieren. Window.length
Schreibgeschützt-
Gibt die Anzahl der Frames im Fenster zurück. Siehe auch
window.frames
. Window.localStorage
Schreibgeschützt-
Gibt eine Referenz auf das lokale Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur vom Ursprung, der sie erstellt hat, abgerufen werden können.
Window.location
-
Ruft den Standort oder die aktuelle URL des Fensterobjekts ab/setzt diese.
Window.locationbar
Schreibgeschützt-
Gibt das Standortleisten-Objekt zurück.
-
Gibt das Menüleisten-Objekt zurück.
Window.mozInnerScreenX
Schreibgeschützt Nicht standardisiert-
Gibt die horizontale (X) Koordinate der linken oberen Ecke des Ansichtsbereichs des Fensters in Bildschirmkoordinaten zurück. Diese Werte werden in CSS-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixel
innsIDOMWindowUtils
für einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, falls nötig. Window.mozInnerScreenY
Schreibgeschützt Nicht standardisiert-
Gibt die vertikale (Y) Koordinate der linken oberen Ecke des Ansichtsbereichs des Fensters in Bildschirmkoordinaten zurück. Diese Werte werden in CSS-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixel
für einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, falls nötig. Window.name
-
Ruft den Namen des Fensters ab/setzt diesen.
-
Gibt das aktuell mit dem
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 ursprungsbasierenden Agentencluster gehört. Window.outerHeight
Schreibgeschützt-
Ermittelt die Höhe der Außenseite des Browserfensters.
Window.outerWidth
Schreibgeschützt-
Ermittelt 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 Element 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 Using Navigation Timing für zusätzliche Informationen und Beispiele. Window.personalbar
Schreibgeschützt-
Gibt das Persönliche Leisten-Objekt zurück.
Window.scheduler
Schreibgeschützt-
Gibt das
Scheduler
-Objekt zurück, das mit dem aktuellen Kontext assoziiert ist. Dies ist der Einstiegspunkt für die Verwendung der Prioritized Task Scheduling API. Window.screen
Schreibgeschützt-
Gibt eine Referenz auf das Bildschirm-Objekt zurück, das mit dem Fenster verbunden ist.
Window.screenX
undWindow.screenLeft
Schreibgeschützt-
Beide Eigenschaften geben die horizontale Entfernung von der linken Begrenzung des Ansichtsfelds des Benutzers zum linken Rand des Bildschirms zurück.
Window.screenY
undWindow.screenTop
Schreibgeschützt-
Beide Eigenschaften geben die vertikale Entfernung von der oberen Begrenzung des Ansichtsfelds des Benutzers zum oberen Rand des Bildschirms zurück.
Window.scrollbars
Schreibgeschützt-
Gibt das Bildlaufleisten-Objekt zurück.
Window.scrollMaxX
Nicht standardisiert Schreibgeschützt-
Der maximale Offset, um den das Fenster horizontal gescrollt werden kann, das heißt die Dokumentbreite minus die Ansichtsfeldbreite.
Window.scrollMaxY
Nicht standardisiert Schreibgeschützt-
Der maximale Offset, um den das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus die Ansichtsfeldhöhe).
Window.scrollX
Schreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits horizontal gescrollt wurde.
Window.scrollY
Schreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits vertikal gescrollt wurde.
Window.self
Schreibgeschützt-
Gibt eine Objekt-Referenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage
-
Gibt eine Referenz auf das Sitzungsspeicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur vom Ursprung, der sie erstellt hat, abgerufen werden können.
-
Gibt das
WindowSharedStorage
-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt zum Schreiben von Daten in gemeinsamen Speicher mithilfe der Shared Storage API. Window.speechSynthesis
Schreibgeschützt-
Gibt ein
SpeechSynthesis
-Objekt zurück, das der Einstiegspunkt für die Verwendung der Web Speech API-Sprachausgabefunktionalität ist. Window.statusbar
Schreibgeschützt-
Gibt das Statusleisten-Objekt zurück.
Window.toolbar
Schreibgeschützt-
Gibt das Symbolleisten-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 bietet den Einstiegspunkt für die Verwendung der Trusted Types API. Window.viewport
Experimentell Schreibgeschützt-
Gibt eine
Viewport
-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Geräteansichtsfelds bereitstellt. Window.visualViewport
Schreibgeschützt-
Gibt ein
VisualViewport
-Objekt zurück, das das visuelle Ansichtsfeld für ein bestimmtes Fenster darstellt. 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. - Benannte Eigenschaften
-
Einige Elemente im Dokument sind auch als Window-Eigenschaften exponiert:
- Für jedes
<embed>
,<form>
,<iframe>
,<img>
, und<object>
-Element wird seinname
(falls nicht leer) exponiert. Zum Beispiel, wenn das Dokument<form name="my_form">
enthält, dann gebenwindow["my_form"]
(und äquivalentwindow.my_form
) eine Referenz auf dieses Element zurück. - Für jedes HTML-Element wird seine
id
(falls nicht leer) exponiert.
Wenn eine Eigenschaft einem Einzelnelement entspricht, wird dieses Element direkt zurückgegeben. Entspricht die Eigenschaft mehreren Elementen, wird eine
HTMLCollection
zurückgegeben, die alle von ihnen 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 aktuelle Ereignis zurück, das ist das Ereignis, das momentan vom JavaScript-Codekontext verarbeitet wird, oder
undefined
, falls momentan kein Ereignis verarbeitet wird. DasEvent
-Objekt, das direkt an Ereignishandler übergeben wird, 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 Orientierung in Grad (in 90-Grad-Schritten) des Ansichtsfelds 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/setzt diesen.
Instanzmethoden
Dieses Interface erbt Methoden vom EventTarget
-Interface.
Window.atob()
-
Dekodiert einen Datenstring, der unter Verwendung der Base-64-Codierung kodiert wurde.
Window.alert()
-
Zeigt einen Benachrichtigungsdialog an.
Window.blur()
Veraltet-
Setzt den Fokus vom Fenster weg.
Window.btoa()
-
Erstellt einen Base-64-codierten ASCII-String aus einem String binärer Daten.
Window.cancelAnimationFrame()
-
Erlaubt das Abbrechen eines zuvor mit
Window.requestAnimationFrame
geplanten Rückrufs. Window.cancelIdleCallback()
-
Erlaubt 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 eine Vielzahl von verschiedenen Bildquellen und gibt ein
Promise
zurück, das zu einemImageBitmap
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 gelöscht oder tritt in den bfcache ein), oder nach einer bereitgestellten
activateAfter
-Zeitspanne — je nachdem, was zuerst eintritt. Window.find()
Nicht standardisiert-
Sucht nach einem angegebenen String in einem Fenster.
Window.focus()
-
Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()
-
Ermittelt 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-
Ermittelt den Standard-berechneten Stil für das angegebene Element und ignoriert Autoren-Stilblätter.
Window.getScreenDetails()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das mit einemScreenDetails
-Objekt aufgelöst wird, das die Details aller Bildschirme repräsentiert, die dem Gerät des Benutzers zur Verfügung stehen. Window.getSelection()
-
Gibt das Auswahlobjekt zurück, das das/die ausgewählte/n Element/e darstellt.
Window.matchMedia()
-
Gibt ein
MediaQueryList
-Objekt zurück, das die angegebene Media-Abfragezeichenkette 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 Mechanismus, damit ein Fenster eine Datenzeichenfolge an ein anderes Fenster senden kann, das nicht innerhalb derselben Domäne wie das erste sein muss.
Window.print()
-
Öffnet den Druckdialog, um das aktuelle Dokument zu drucken.
Window.prompt()
-
Gibt den vom Benutzer eingegebenen Text in einem Eingabedialog zurück.
Window.queryLocalFonts()
Experimentell Sicherer Kontext-
Gibt ein
Promise
zurück, das zu einem Array vonFontData
-Objekten aufgelöst wird, die die lokal verfügbaren Schriftarten darstellen. Window.queueMicrotask()
-
Wartet einen Mikrotask zur Ausführung zu einem sicheren Zeitpunkt, bevor die Kontrolle zur Ereignisschleife des Browsers zurückkehrt, ein.
Window.reportError()
-
Meldet einen Fehler in einem Skript und emuliert eine nicht behandelte Ausnahme.
Window.requestAnimationFrame()
-
Teilt dem Browser mit, dass eine Animation im Gange ist und fordert, dass der Browser das Fenster für den nächsten Animationsframe neu zeichnet.
Window.requestIdleCallback()
-
Ermöglicht das Planen 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 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 verstrichen ist.
Window.setTimeout()
-
Plant die Ausführung einer Funktion nach einer bestimmten Zeitspanne.
Window.showDirectoryPicker()
Experimentell Sicherer Kontext-
Zeigt einen Verzeichnisauswähler an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiauswähler an, der es einem Benutzer ermöglicht, eine oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()
Experimentell Sicherer Kontext-
Zeigt einen Dateiauswähler an, mit dem ein Benutzer eine Datei speichern kann.
Window.sizeToContent()
Nicht standardisiert-
Passt die Größe des Fensters an seinen Inhalt an.
Window.stop()
-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()
-
Erstellt eine tiefe Kopie eines gegebenen Wertes unter Verwendung des strukturierten Kopieralgorithmus.
Veraltete Methoden
Window.captureEvents()
Veraltet-
Registriert das Fenster, um alle Ereignisse des angegebenen 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 vom Abfangen von Ereignissen eines bestimmten Typs.
Window.requestFileSystem()
Nicht standardisiert Veraltet-
Ermöglicht es einer Website oder App, auf ein sandkasten-geschütztes Dateisystem für den eigenen Gebrauch zuzugreifen.
Window.setImmediate()
Nicht standardisiert Veraltet-
Führt eine Funktion aus, nachdem der Browser andere schwere Aufgaben abgeschlossen hat.
Window.setResizable()
Nicht standardisiert Veraltet-
Macht nichts (no-op). Wurde für die Rückwärtskompatibilität mit Netscape 4.x beibehalten.
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 Zuweisen eines Ereignis-Listeners zur oneventname
-Eigenschaft dieser Schnittstelle. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse von dem im Window
-Objekt enthaltenen Document
aufsteigen.
error
-
Wird ausgelöst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann. Zum Beispiel, wenn ein Skript einen Ausführungsfehler hat, oder ein Bild nicht gefunden oder ungültig ist.
languagechange
-
Wird am globalen Geltungsbereichsobjekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize
-
Wird ausgelöst, wenn das Fenster in seiner Größe verändert wurde.
storage
-
Wird ausgelöst, wenn ein Speicherbereich (
localStorage
odersessionStorage
) im Kontext eines anderen Dokuments modifiziert wurde.
Verbindungsevents
Geräteorientierungsevents
devicemotion
Sicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und zeigt die Menge der physischen Kraft der Beschleunigung an, die das Gerät empfängt, und die Rotationsrate, falls verfügbar.
deviceorientation
Sicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Origungssensor über die aktuelle Orientierung des Geräts im Vergleich zum Erdrichterahmen verfügbar sind.
deviceorientationabsolute
Sicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Origungssensor über die aktuelle absolute Orientierung des Geräts im Vergleich zum Erdkoordinatensystem verfügbar sind.
Fokussierungsevents
Gamepad-Ereignisse
gamepadconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde, oder das erste Mal ein Knopf/Achse des Gamepads verwendet wird.
gamepaddisconnected
-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad vom Computer getrennt wurde.
Verlaufsevents
hashchange
-
Wird ausgelöst, wenn sich der Fragmentbezeichner der URL ändert (der Teil der URL, der mit dem
#
-Symbol beginnt und ihm folgt). pagehide
-
Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während ein anderer Tab im Sitzungsspeicher angezeigt wird. Dies passiert zum Beispiel, wenn der Benutzer auf die Zurück-Schaltfläche klickt oder auf die Vorwärts-Schaltfläche, um im Sitzungsverlauf weiterzumachen.
pagereveal
-
Wird ausgelöst, wenn ein Dokument erstmals gerendert wird, entweder wenn ein frisches Dokument aus dem Netzwerk geladen wird oder ein Dokument aktiviert wird (entweder aus 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 zum ersten Mal geladen wird, sondern auch Situationen wie Benutzer, die zur Seite zurückgehen, nachdem sie zu einer anderen innerhalb desselben Tabs navigiert sind.
pageswap
-
Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation entladen werden soll.
popstate
-
Wird ausgelöst, wenn sich der aktive Eintrag im Verlauf ändert.
Lade- & Entlade-Events
beforeunload
-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen gleich entladen 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 davor steht, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichtenevents
message
-
Wird ausgelöst, wenn das Fenster eine Nachricht empfängt, beispielsweise von einem Aufruf zu
Window.postMessage()
von einem anderen Browsing-Kontext. messageerror
-
Wird ausgelöst, wenn ein
Window
-Objekt eine Nachricht empfängt, die nicht deserialisiert werden kann.
Druckereignisse
afterprint
-
Wird ausgelöst, nachdem das zugehörige Dokument mit dem Druck begonnen hat oder die Druckvorschau geschlossen wurde.
beforeprint
-
Wird ausgelöst, wenn das zugehörige Dokument gleich gedruckt werden soll oder für den Druckvorgang angezeigt wird.
Ereignisse der Versprechensablehnung
rejectionhandled
-
Wird jedes Mal gesendet, wenn ein JavaScript
Promise
abgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, um die Ablehnung abzufangen oder nicht. unhandledrejection
-
Wird gesendet, wenn ein JavaScript
Promise
abgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung abzufangen.
Bildlaufereignisse
scrollsnapchange
Experimentell-
Wird am Bildlaufcontainer am Ende eines Bildlaufindizierungsoperations ausgelöst, wenn ein neuer Bildlaufindizierungsbereich ausgewählt wurde.
scrollsnapchanging
Experimentell-
Wird am Bildlaufcontainer ausgelöst, wenn der Browser bestimmt, dass ein neuer Bildlaufindizierungsbereich in Arbeit ist, d.h. er wird ausgewählt, wenn die aktuelle Bildlaufgeste 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 an den Computer angeschlossen wurde.
vrdisplaydisconnect
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivate
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display nicht mehr präsentiert werden kann.
vrdisplaypresentchange
Veraltet Nicht standardisiert-
Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert — d.h. es wechselt von präsentierend zu nicht präsentierend, oder umgekehrt.
Ereignisse, die aufsteigen
Nicht alle Ereignisse, die aufsteigen, können das Window
-Objekt erreichen. Nur die folgenden Events können dies tun 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.
Ereignisse auf dem Fenster hören
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu hören:
- Fügen Sie dem Element einen Ereignis-Listener mit der
EventTarget.addEventListener
-Methode hinzu. - Weisen Sie dem
oneventname
-Eigenschaft des Elements in JavaScript einen Ereignis-Handler zu. - Fügen Sie dem Element ein
on
-präfixiertes Attribut im HTML hinzu.
Um auf Ereignisse auf Window
-Objekten zu hören, können Sie im Allgemeinen nur die ersten zwei Methoden verwenden, da Window
kein entsprechendes HTML-Element hat. Es gibt jedoch eine spezifische Gruppe von Ereignissen, deren Listener zum <body>
(oder dem veralteten <frameset>
) Element hinzugefügt werden können, das dem Dokument des Window
gehört, 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
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> |
Browser-Kompatibilität
Loading…