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 repräsentiert, 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 verbunden sind. Allerdings ist das Window-Interface ein geeigneter Ort, um diese Elemente einzuschließen, 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 von JavaScript-Code innerhalb einer bestimmten Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Das heißt, selbst in einem Browser mit Registerkarten gelten einige Eigenschaften und Methoden immer noch für das gesamte Fenster, das die Registerkarte enthält, wie z.B. resizeTo() und innerHeight. Im Allgemeinen bezieht sich alles, was nicht vernünftigerweise auf eine Registerkarte 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 Überschreiben des Prototyps von eingebauten Elementen), in einem separaten Abschnitt unten aufgeführt sind.
Window.cachesSchreibgeschü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 für die Offline-Nutzung und das Erstellen von benutzerdefinierten Antworten auf Anfragen. Window.clientInformationSchreibgeschützt-
Ein Alias für
Window.navigator. Window.closedSchreibgeschützt-
Diese Eigenschaft zeigt an, ob das aktuelle Fenster geschlossen ist oder nicht.
-
Gibt eine Referenz auf das
CookieStore-Objekt für den aktuellen Dokument-Kontext zurück. Window.credentiallessSchreibgeschützt Experimentell-
Gibt einen booleschen Wert zurück, der anzeigt, ob das aktuelle Dokument in einem credentialless
<iframe>geladen wurde. Weitere Informationen finden Sie unter IFrame credentialless. Window.crossOriginIsolatedSchreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob die Website in einem Cross-Origin-Isolationszustand ist.
Window.cryptoSchreibgeschützt-
Gibt das
Crypto-Objekt zurück, das mit dem globalen Objekt verbunden ist. Window.customElementsSchreibgeschützt-
Gibt eine Referenz auf das
CustomElementRegistry-Objekt zurück, das zum Registrieren neuer benutzerdefinierter Elemente und zum Abrufen von Informationen über bereits registrierte benutzerdefinierte Elemente verwendet werden kann. Window.devicePixelRatioSchreibgeschützt-
Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln im aktuellen Display zurück.
Window.documentSchreibgeschützt-
Gibt eine Referenz auf das Dokument zurück, das das Fenster enthält.
Window.documentPictureInPictureSchreibgeschützt Experimentell Sicherer Kontext-
Gibt eine Referenz auf das document Picture-in-Picture-Fenster für den aktuellen Dokument-Kontext zurück.
Window.fenceSchreibgeschützt Experimentell-
Gibt eine
Fence-Objektinstanz für den aktuellen Dokument-Kontext zurück. Nur für Dokumente verfügbar, die in einem<fencedframe>eingebettet sind. Window.frameElementSchreibgeschützt-
Gibt das Element zurück, in dem das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.
Window.framesSchreibgeschützt-
Gibt ein Array der Unterrahmen im aktuellen Fenster zurück.
Window.fullScreenNicht standardisiert-
Diese Eigenschaft zeigt an, ob das Fenster im Vollbild angezeigt wird oder nicht.
Window.historySchreibgeschützt-
Gibt eine Referenz auf das History-Objekt zurück.
Window.indexedDBSchreibgeschützt-
Bietet eine Mechanik für Anwendungen, um asynchron auf Funktionen indizierter Datenbanken zuzugreifen; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Ruft die Höhe des Inhaltsbereichs des Browserfensters ab, einschließlich, wenn gerendert, der horizontalen Scrollleiste.
Window.innerWidthSchreibgeschützt-
Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich, wenn gerendert, der vertikalen Scrollleiste.
Window.isSecureContextSchreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob der aktuelle Kontext sicher (
true) oder nicht sicher (false) ist. Window.launchQueueSchreibgeschützt Experimentell-
Wenn eine Progressive Web App (PWA) mit einem
launch_handlerclient_mode-Wert vonfocus-existing,navigate-newodernavigate-existinggestartet wird, bietet dielaunchQueueZugriff auf dieLaunchQueue-Klasse, die es ermöglicht, benutzerdefinierte Startnavigationen für die PWA zu implementieren. Window.lengthSchreibgeschützt-
Gibt die Anzahl der Frames im Fenster zurück. Siehe auch
window.frames. Window.localStorageSchreibgeschützt-
Gibt eine Referenz auf das lokale Speicherobjekt zurück, das zum Speichern von Daten verwendet wird, auf die nur der Ursprung zugreifen kann, der sie erstellt hat.
Window.location-
Ruft die Lage oder die aktuelle URL des Fensterobjekts ab/setzt diese.
Window.locationbarSchreibgeschützt-
Gibt das Locationbar-Objekt zurück.
-
Gibt das Menüleistenobjekt zurück.
Window.mozInnerScreenXSchreibgeschü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
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor zur Anpassung an Bildschirm-Pixel, falls erforderlich. Window.mozInnerScreenYSchreibgeschü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
mozScreenPixelsPerCSSPixelfür einen Umrechnungsfaktor zur Anpassung an Bildschirm-Pixel, falls erforderlich. Window.name-
Ruft den Namen des Fensters ab/setzt diesen.
-
Gibt das aktuelle
window-bezogeneNavigation-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.originSchreibgeschützt-
Gibt den Ursprung des globalen Objekts als Zeichenfolge serialisiert zurück.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem origin-gebundenen Agentencluster gehört. Window.outerHeightSchreibgeschützt-
Ruft die Höhe der Außenseite des Browserfensters ab.
Window.outerWidthSchreibgeschützt-
Ruft die Breite der Außenseite des Browserfensters ab.
Window.pageXOffsetSchreibgeschützt-
Ein Alias für
window.scrollX. Window.pageYOffsetSchreibgeschützt-
Ein Alias für
window.scrollY. Window.parentSchreibgeschützt-
Gibt eine Referenz auf das Elternfenster oder den übergeordneten Unterrahmen des aktuellen Fensters zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, das dietiming- und dienavigation-Attribute enthält, jeweils ein Objekt, das leistungsbezogene Daten bereitstellt. Siehe auch Using Navigation Timing für zusätzliche Informationen und Beispiele. Window.personalbarSchreibgeschützt-
Gibt das Personalbar-Objekt zurück.
Window.schedulerSchreibgeschü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.screenSchreibgeschützt-
Gibt eine Referenz auf das Bildschirmobjekt zurück, das mit dem Fenster verbunden ist.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Browser-Viewports bis zur linken Seite des Bildschirms in Bildschirmkoordinaten zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Browser-Viewports bis zur oberen Seite des Bildschirms in Bildschirmkoordinaten zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das Scrollbars-Objekt zurück.
Window.scrollMaxXNicht standardisiert Schreibgeschützt-
Der maximale Versatz, den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentenbreite minus der Viewportbreite.
Window.scrollMaxYNicht standardisiert Schreibgeschützt-
Der maximale Versatz, den das Fenster vertikal gescrollt werden kann, d.h. die Dokumentenhöhe minus der Viewporthöhe.
Window.scrollXSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, die das Dokument bereits horizontal gescrollt wurde.
Window.scrollYSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, die das Dokument bereits vertikal gescrollt wurde.
Window.selfSchreibgeschützt-
Gibt eine Objekt-Referenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt eine Referenz auf das Sitzungs-Speicherobjekt zurück, das zum Speichern von Daten verwendet wird, auf die nur der Ursprung zugreifen kann, der sie erstellt hat.
-
Gibt das
WindowSharedStorage-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt für das Schreiben von Daten in den gemeinsamen Speicher über die Shared Storage API. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das den Einstiegspunkt in die Verwendung der Sprachsynthese-Funktionalität der Web Speech API darstellt. Window.statusbarSchreibgeschützt-
Gibt das Statusleistenobjekt zurück.
Window.toolbarSchreibgeschützt-
Gibt das Toolbar-Objekt zurück.
Window.topSchreibgeschützt-
Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.
Window.trustedTypesSchreibgeschützt-
Gibt das
TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verbunden ist und den Einstiegspunkt für die Verwendung der Trusted Types API bietet. Window.viewportExperimentell Schreibgeschützt-
Gibt eine
Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Viewports des Geräts bereitstellt. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-Objekt zurück, das den visuellen Viewport für ein bestimmtes Fenster darstellt. Window.windowSchreibgeschü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. SieheWindow.framesfür mehr Details. - Benannte Eigenschaften
-
Einige Elemente im Dokument sind auch als Fenstereigenschaften verfügbar:
- Für jedes
<embed>,<form>,<iframe>,<img>und<object>Element wird dessenname(falls nicht leer) exponiert. Zum Beispiel, wenn das Dokument<form name="my_form">enthält, dann gibtwindow["my_form"](und das Äquivalentwindow.my_form) eine Referenz auf dieses Element zurück. - Für jedes HTML-Element wird dessen
id(falls nicht leer) exponiert.
Wenn eine Eigenschaft einem einzigen Element entspricht, wird das Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird eine
HTMLCollectionzurückgegeben, die alle enthält. Wenn eines der Elemente ein navigierbares<iframe>oder<object>ist, wird stattdessen dascontentWindowdes ersten solchen Iframes zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.eventVeraltet Schreibgeschützt-
Gibt das aktuelle Ereignis zurück, welches das Ereignis ist, das derzeit vom JavaScript-Code-Kontext behandelt wird, oder
undefined, wenn kein Ereignis derzeit behandelt wird. DasEvent-Objekt, das direkt an Event-Handler übergeben wird, sollte wann immer möglich stattdessen verwendet werden. Window.externalVeraltet Schreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, um externe Suchprovider zum Browser hinzuzufügen.
Window.orientationVeraltet Schreibgeschützt-
Gibt die Ausrichtung in Grad (in 90-Grad-Inkrementen) des Viewports relativ zur natürlichen Ausrichtung des Geräts zurück.
Window.statusVeraltet-
Ruft den Text in der Statusleiste am unteren Rand des Browsers ab/setzt diesen.
Instanz-Methoden
Dieses Interface erbt Methoden vom EventTarget-Interface.
Window.atob()-
Dekodiert eine Datenzeichenkette, die mit Base-64-Codierung codiert wurde.
Window.alert()-
Zeigt ein Alarmdialogfenster an.
Window.blur()Veraltet-
Verlagert den Fokus vom Fenster.
Window.btoa()-
Erstellt eine Base-64-kodierte ASCII-Zeichenkette aus einer Binärdaten-Zeichenkette.
Window.cancelAnimationFrame()-
Ermöglicht das Abbrechen eines zuvor mit
Window.requestAnimationFramegeplanten Rückrufs. Window.cancelIdleCallback()-
Ermöglicht das Abbrechen eines zuvor mit
Window.requestIdleCallbackgeplanten Rückrufs. Window.clearInterval()-
Hebt die mit
Window.setInterval()gesetzte wiederholte Ausführung auf. Window.clearTimeout()-
Hebt die mit
Window.setTimeout()gesetzte verzögerte Ausführung auf. 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
Promisezurück, die sich zu einemImageBitmapauflöst. Optional wird die Quelle auf das Rechteck der Pixel beschnitten, das bei (sx, sy) mit der Breiteswund der Höheshbeginnt. Window.dump()Nicht standardisiert-
Schreibt eine Nachricht in die Konsole.
Window.fetch()-
Startet den Prozess, eine Ressource aus dem Netzwerk abzurufen.
Window.fetchLater()Experimentell-
Erstellt einen verzögerten Abruf, der gesendet wird, sobald die Seite verlassen (zerstört oder in den bfcache überführt wird), oder nach einer bereitgestellten
activateAfter-Timeout - je nachdem, was zuerst eintritt. Window.find()Nicht standardisiert-
Durchsucht ein Fenster nach einer gegebenen Zeichenkette.
Window.focus()-
Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()-
Ruft den berechneten Stil für das angegebene Element ab. Der berechnete Stil zeigt die berechneten Werte aller CSS-Eigenschaften des Elements an.
Window.getDefaultComputedStyle()Nicht standardisiert-
Ruft den standardmäßigen berechneten Stil für das angegebene Element ab, wobei Autoren-Stylesheets ignoriert werden.
Window.getScreenDetails()Experimentell Sicherer Kontext-
Gibt eine
Promisezurück, die sich zu einemScreenDetails-Objekt auflöst, das die Details aller Bildschirme verfügbar für das Gerät des Benutzers darstellt. Window.getSelection()-
Gibt das Auswahlobjekt zurück, das das/die ausgewählte(n) Element(e) repräsentiert.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das der angegebenen Medienabfrage-Zeichenkette entspricht. Window.moveBy()-
Bewegt das aktuelle Fenster um eine angegebene Menge.
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 Datenzeichenkette an ein anderes Fenster sendet, das nicht unbedingt innerhalb derselben Domäne 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 Eingabedialog eingegeben hat.
Window.queryLocalFonts()Experimentell Sicherer Kontext-
Gibt eine
Promisezurück, die sich zu einem Array vonFontData-Objekten auflöst, die die lokal verfügbaren Schriftarten widerspiegeln. Window.queueMicrotask()-
Wartet einen Mikrotask, der zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle zur Ereignisschleife des Browsers ausgeführt wird.
Window.reportError()-
Meldet einen Fehler in einem Skript, indem er eine unbehandelte Ausnahme nachahmt.
Window.requestAnimationFrame()-
Sagt dem Browser, dass eine Animation im Gange ist, mit der Bitte, dass der Browser das Fenster für den nächsten Animationsrahmen neu zeichnet.
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 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 die Ausführung einer Funktion jedes Mal, wenn eine bestimmte Anzahl von Millisekunden vergeht.
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 Dateiwähler, der es einem Benutzer erlaubt, eine oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()Experimentell Sicherer Kontext-
Zeigt einen Dateiwähler, der es einem Benutzer erlaubt, eine Datei zu speichern.
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-
Hebt die mit
setImmediate()gesetzte wiederholte Ausführung auf. Window.releaseEvents()Veraltet-
Gibt das Fenster frei, um nicht mehr Ereignisse eines bestimmten Typs zu erfassen.
Window.requestFileSystem()Nicht standardisiert Veraltet-
Ermöglicht einer Website oder App den Zugriff auf ein sandboxed Dateisystem für die eigene Nutzung.
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). Für die Kompatibilität mit Netscape 4.x beibehalten.
Window.webkitConvertPointFromNodeToPage()Nicht standardisiert Veraltet-
Transformiert einen
WebKitPointvom Koordinatensystem des Knotens zum Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()Nicht standardisiert Veraltet-
Transformiert einen
WebKitPointvom Koordinatensystem der Seite zum Koordinatensystem des Knotens.
Ereignisse
Hören Sie diese Ereignisse mit addEventListener() oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen. Neben den unten aufgelisteten Ereignissen können viele Ereignisse vom im Fenster-Objekt enthaltenen Document geblubbert 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 oder ungültig ist.
languagechange-
Wird im globalen Kontextobjekt 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 (
localStorageodersessionStorage) im Kontext eines anderen Dokuments geändert wurde.
Verbindungserereignisse
Geräteausrichtungsereignisse
devicemotionSicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und zeigt die physische Kraft der Beschleunigung, die das Gerät erhält, sowie die Drehgeschwindigkeit an, falls verfügbar.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Ausrichtungssensor über die aktuelle Ausrichtung des Geräts im Vergleich zum Erdkoordinatensystem verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Ausrichtungssensor über die aktuelle absolute Ausrichtung des Geräts im Vergleich zum Erdkoordinatensystem verfügbar sind.
Fokuserreignisse
Gamepad-Ereignisse
gamepadconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde oder das erste Mal eine Taste/Achse des Gamepads benutzt wird.
gamepaddisconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufseereignisse
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 versteckt, während er im Begriff ist, an seiner Stelle ein anderes Dokument aus dem Verlauf der Sitzung anzuzeigen. Dies geschieht zum Beispiel, wenn der Benutzer auf die Schaltfläche Zurück klickt oder wenn sie auf die Schaltfläche Vorwärts klicken, um im Sitzungsverlauf weiterzugehen.
pagereveal-
Wird ausgelöst, wenn ein Dokument erstmals gerendert wird, entweder beim Laden eines frischen Dokuments aus dem Netzwerk oder beim Aktivieren eines Dokuments (entweder aus dem bfcache oder prerender).
pageshow-
Wird gesendet, wenn der Browser das Dokument aufgrund von Navigationsaufgaben sichtbar macht, einschließlich nicht nur beim ersten Laden der Seite, sondern auch in Situationen wie wenn der Benutzer zur Seite zurücknavigiert hat, nachdem er zu einer anderen innerhalb derselben Registerkarte navigiert ist.
pageswap-
Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation demnächst entladen werden soll.
popstate-
Wird ausgelöst, wenn der aktive Verlaufseintrag sich ändert.
Lade- & Entladeereignisse
beforeunload-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen demnächst entladen werden sollen.
load-
Wird ausgelöst, wenn die ganze Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.
unload-
Wird ausgelöst, wenn das Dokument oder eine Kinderressource entladen wird.
Manifest-Ereignisse
appinstalled-
Wird ausgelöst, wenn der Browser erfolgreich eine Seite als eine Anwendung installiert hat.
beforeinstallprompt-
Wird ausgelöst, wenn ein Benutzer im Begriff ist, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichtenereignisse
message-
Wird ausgelöst, wenn das Fenster eine Nachricht empfängt, beispielsweise durch einen Aufruf von
Window.postMessage()aus 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 Drucken begonnen hat oder die Druckvorschau geschlossen wurde.
beforeprint-
Wird ausgelöst, wenn das zugehörige Dokument gedruckt oder zur Vorschau gedruckt werden soll.
Promise-Ablehnungserereignisse
rejectionhandled-
Wird jedes Mal gesendet, wenn eine JavaScript
Promiseabgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, um die Ablehnung abzufangen oder nicht. unhandledrejection-
Wird gesendet, wenn eine JavaScript
Promiseabgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung abzufangen.
Srollereignisse
scrollsnapchangeExperimentell-
Wird am Scroll-Container am Ende eines Scroll-Vorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchangingExperimentell-
Wird am Scroll-Container ausgelöst, wenn der Browser feststellt, dass ein neues Scroll-Snap-Ziel in der Warteschlange steht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.
Veraltete Ereignisse
orientationchangeVeraltet-
Wird ausgelöst, wenn sich die Orientierung des Geräts geändert hat.
vrdisplayactivateVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display präsentiert werden kann.
vrdisplayconnectVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.
vrdisplaydisconnectVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivateVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display nicht mehr präsentiert werden kann.
vrdisplaypresentchangeVeraltet Nicht standardisiert-
Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert — d.h. von präsentiert zu nicht präsentiert oder umgekehrt.
Geblubberte Ereignisse
Nicht alle Ereignisse, die geblubbert werden können, erreichen das Window-Objekt. Die folgenden Ereignisse tun dies und können am Window-Objekt abgehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Abhören von Ereignissen am Window
HTML-Elemente haben drei Möglichkeiten, um Ereignisse abzuhören:
- Fügen Sie dem Element einen Ereignis-Listener mit der Methode
EventTarget.addEventListenerhinzu. - Weisen Sie dem Ereignis-Handler des Elements die
oneventname-Eigenschaft in JavaScript zu. - Fügen Sie dem Element im HTML ein Attribut mit dem Präfix
onhinzu.
Um Ereignisse bei Window-Objekten abzuhö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 dem <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:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
Dies bedeutet, dass die folgenden streng 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> |