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 zeigt auf das DOM-Dokument, das in diesem Fenster geladen ist.
Ein Fenster für ein bestimmtes Dokument kann mit der document.defaultView-Eigenschaft bezogen werden.
Eine globale Variable, window, die das Fenster darstellt, in dem das Skript ausgeführt wird, wird für JavaScript-Code bereitgestellt.
Das Window-Interface beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Dennoch ist das Window-Interface ein geeigneter Ort, um diese Elemente aufzunehmen, die global verfügbar sein müssen. Viele davon sind in der JavaScript Reference und der DOM Reference dokumentiert.
In einem Browser mit Registerkarten wird jede Registerkarte durch ihr eigenes Window-Objekt dargestellt; das globale window, das vom JavaScript-Code gesehen wird, der innerhalb einer bestimmten Registerkarte ausgeführt wird, stellt immer die Registerkarte dar, in der der Code ausgeführt wird. Das gesagt, selbst in einem Browser mit Registerkarten gelten einige Eigenschaften und Methoden immer noch auf das Gesamtfenster, das die Registerkarte enthält, wie resizeTo() und innerHeight. Im Allgemeinen betrifft alles, was nicht vernünftigerweise auf eine Registerkarte bezogen sein kann, stattdessen 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 weiter unten aufgelistet sind.
Window.cachesSchreibgeschü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 Erzeugen von benutzerdefinierten Antworten auf Anfragen. Window.clientInformationSchreibgeschützt-
Ein Alias für
Window.navigator. Window.closedSchreibgeschü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.credentiallessSchreibgeschü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.crossOriginIsolatedSchreibgeschützt-
Gibt einen Booleschen Wert zurück, der angibt, ob sich die Website in einem "cross-origin isolation state" befindet.
Window.cryptoSchreibgeschützt-
Gibt das
Crypto-Objekt zurück, das mit dem globalen Objekt verknüpft ist. Window.customElementsSchreibgeschü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 zu erhalten. 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 Dokumentkontext zurück.
Window.fenceSchreibgeschützt Experimentell-
Gibt eine
Fence-Objektinstanz für den aktuellen Dokumentkontext zurück. Nur für dokumente verfügbar, die in einem<fencedframe>eingebettet sind. Window.frameElementSchreibgeschützt-
Gibt das Element zurück, in das das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.
Window.framesSchreibgeschützt-
Gibt ein Array der Subframes im aktuellen Fenster zurück.
Window.fullScreenNicht standardisiert-
Diese Eigenschaft gibt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.
Window.historySchreibgeschützt-
Gibt eine Referenz auf das History-Objekt zurück.
Window.indexedDBSchreibgeschützt-
Bietet einen Mechanismus, mit dem Anwendungen asynchron auf Funktionen von indizierten Datenbanken zugreifen können; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Ermittelt die Höhe des Inhaltsbereichs des Browserfensters einschließlich, falls vorhanden, der horizontalen Bildlaufleiste.
Window.innerWidthSchreibgeschützt-
Ermittelt die Breite des Inhaltsbereichs des Browserfensters einschließlich, falls vorhanden, der vertikalen Bildlaufleiste.
Window.isSecureContextSchreibgeschützt-
Gibt einen Booleschen Wert zurück, der angibt, ob der aktuelle Kontext sicher ist (
true) oder nicht (false). 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 ermöglicht die Implementierung einer benutzerdefinierten Nahrfaceverwaltung für die PWA. 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 vom Ursprungsdokument zugegriffen werden kann, das es erstellt hat.
Window.location-
Ruft die Position oder die aktuelle URL des Fensterobjekts ab oder setzt sie.
Window.locationbarSchreibgeschützt-
Gibt das Locationbar-Objekt zurück.
-
Gibt das Menubar-Objekt zurück.
Window.mozInnerScreenXSchreibgeschü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
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, falls erforderlich. Window.mozInnerScreenYSchreibgeschü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
mozScreenPixelsPerCSSPixelfür einen Umrechnungsfaktor, falls erforderlich. Window.name-
Ruft den Namen des Fensters ab oder setzt ihn.
-
Gibt das mit diesem
windowassoziierteNavigation-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 zurück, serialisiert als Zeichenkette.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem Ursprungs-gekeyten Agentencluster gehört. Window.outerHeightSchreibgeschützt-
Ermittelt die Höhe der Außenseite des Browserfensters.
Window.outerWidthSchreibgeschützt-
Ermittelt die Breite der Außenseite des Browserfensters.
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 übergeordnete Fenster oder den übergeordneten Subframe des aktuellen Fensters zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, das dietiming- undnavigation-Attribute enthält, die jeweils ein Objekt sind, 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 verknüpft ist. Dies ist der Einstiegspunkt für die Verwendung des Prioritized Task Scheduling API. Window.screenSchreibgeschützt-
Gibt eine Referenz auf das Bildschirmobjekt zurück, das mit dem Fenster verknüpft ist.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Ansichtsbereichs des Browsers zur linken Seite des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Ansichtsbereichs des Browsers zur oberen Seite des Bildschirms zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das Scrollbars-Objekt zurück.
Window.scrollMaxXNicht standardisiert Schreibgeschützt-
Der maximale Versatz, bis zu dem das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus die Ansichtsbereichbreite.
Window.scrollMaxYNicht standardisiert Schreibgeschützt-
Der maximale Versatz, bis zu dem das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus die Ansichtsbereichhö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 ein Objekt zurück, das eine Referenz auf das Fensterobjekt selbst darstellt.
Window.sessionStorage-
Gibt eine Referenz auf das Sitzungsspeicherobjekt zurück, das zum Speichern von Daten verwendet wird, auf die nur vom Ursprungsdokument zugegriffen werden kann, das es erstellt hat.
-
Gibt das
WindowSharedStorage-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt zum Schreiben von Daten in den geteilten Speicher mithilfe des Shared Storage API. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das den Einstiegspunkt für die Nutzung der Sprachsynthese-Funktionalität der Web Speech API darstellt. Window.statusbarSchreibgeschützt-
Gibt das Statusbar-Objekt 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 verknüpft ist, und bietet den Einstiegspunkt für die Nutzung des Trusted Types API. Window.viewportExperimentell Schreibgeschützt-
Gibt eine
Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Geräteansichtsbereichs liefert. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-Objekt zurück, das den visuellen Ansichtsbereich für ein gegebenes Fenster darstellt. Window.windowSchreibgeschü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.framesfür weitere Details. - Benannte Eigenschaften
-
Einige Elemente im Dokument werden auch als Fenster-Eigenschaften exponiert:
- Für jedes
<embed>,<form>,<iframe>,<img>und<object>-Element wird seinname(sofern nicht leer) exponiert. Zum Beispiel, wenn das Dokument<form name="my_form">enthält, dann gibtwindow["my_form"](und das äquivalentewindow.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 einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird eine
HTMLCollectionzurückgegeben, die alle von ihnen enthält. Wenn eines der Elemente ein navigierbares<iframe>oder<object>ist, wird stattdessen dascontentWindowdes ersten solchen Frames zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.eventVeraltet Schreibgeschützt-
Gibt das aktuelle Ereignis zurück, welches das aktuell vom JavaScript-Code behandelte Ereignis darstellt, oder
undefined, wenn derzeit kein Ereignis behandelt wird. Wann immer möglich sollte stattdessen das direkt an Ereignishandler übergebeneEvent-Objekt verwendet werden. Window.externalVeraltet Schreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter zum Browser hinzuzufügen.
Window.orientationVeraltet Schreibgeschützt-
Gibt die Orientierung in Grad (in 90-Grad-Schritten) des Ansichtsbereichs relativ zur natürlichen Orientierung des Geräts zurück.
Window.statusVeraltet-
Ruft den Text in der Statusleiste unten im Browser ab oder setzt diesen.
Instanz-Methoden
Dieses Interface erbt Methoden vom EventTarget-Interface.
Window.atob()-
Dekodiert einen Datenstring, der mittels Base-64-Codierung kodiert wurde.
Window.alert()-
Zeigt ein Warnungsdialog an.
Window.blur()Veraltet-
Entfernt den Fokus vom Fenster.
Window.btoa()-
Erstellt einen Base-64-codierten ASCII-String aus einem String mit Binärdaten.
Window.cancelAnimationFrame()-
Ermöglicht es, einen zuvor mit
Window.requestAnimationFramegeplanten Rückruf abzubrechen. Window.cancelIdleCallback()-
Ermöglicht es, einen zuvor mit
Window.requestIdleCallbackgeplanten Rückruf abzubrechen. Window.clearInterval()-
Bricht die wiederholte Ausführung ab, die mit
Window.setInterval()gesetzt wurde. Window.clearTimeout()-
Bricht die verzögerte Ausführung ab, die mit
Window.setTimeout()gesetzt wurde. Window.close()-
Schließt das aktuelle Fenster.
Window.confirm()-
Zeigt einen Dialog mit einer Nachricht an, auf die der Benutzer antworten muss.
Window.createImageBitmap()-
Akzeptiert eine Vielzahl von unterschiedlichen Bildquellen und gibt ein
Promisezurück, das sich zu einemImageBitmapauflöst. Optional wird die Quelle auf das Rechteck der Pixel beschnitten, 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 zerstört oder tritt in den bfcache ein) oder nach einem angegebenen
activateAfter-Timeout – je nachdem, was zuerst eintritt. Window.find()Nicht standardisiert-
Sucht in einem Fenster nach einem bestimmten String.
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 und ignoriert Autoren-Stilblätter.
Window.getScreenDetails()Experimentell Sicherer Kontext-
Gibt ein
Promisezurück, das sich zu einemScreenDetails-Objekt auflöst, das die Details aller Bildschirme darstellt, die dem Gerät des Benutzers verfügbar sind. Window.getSelection()-
Gibt das Auswahlobjekt zurück, das das ausgewählte Element bzw. die ausgewählten Elemente darstellt.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die angegebene Medienabfragezeichenfolge darstellt. 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 für ein Fenster, eine Zeichenfolge von Daten an ein anderes Fenster zu senden, das nicht unbedingt im selben Domain-Bereich wie das erste Fenster sein muss.
Window.print()-
Öffnet das Druckdialogfeld, um das aktuelle Dokument zu drucken.
Window.prompt()-
Gibt den vom Benutzer in einem Eingabedialog eingegebenen Text zurück.
Window.queryLocalFonts()Experimentell Sicherer Kontext-
Gibt ein
Promisezurück, das sich zu einem Array vonFontData-Objekten auflöst, die die lokal verfügbaren Schriftarten darstellen. Window.queueMicrotask()-
Platziert eine Mikrotask in die Warteschlange, die zu einem sicheren Zeitpunkt ausgeführt wird, bevor die Steuerung zur Ereignisschleife des Browsers zurückkehrt.
Window.reportError()-
Meldet einen Fehler in einem Skript und emuliert eine unbehandelte Ausnahme.
Window.requestAnimationFrame()-
Fordert den Browser auf, eine Animation als in Arbeit anzusehen, indem er einen Neuzeichnungszyklus des Fensters für den nächsten Animationsframe anfordert.
Window.requestIdleCallback()-
Ermöglicht die Planung von Aufgaben während 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()-
Scrolled das Fenster an einen bestimmten Ort im Dokument.
Window.scrollBy()-
Scrolled das Dokument im Fenster um den angegebenen Betrag.
Window.scrollByLines()Nicht standardisiert-
Scrolled das Dokument um die angegebene Anzahl von Zeilen.
Window.scrollByPages()Nicht standardisiert-
Scrolled das aktuelle Dokument um die angegebene Anzahl von Seiten.
Window.scrollTo()-
Scrolled zu einem bestimmten Satz von Koordinaten im Dokument.
Window.setInterval()-
Plant die Ausführung einer Funktion in regelmäßigen Abständen, die durch eine bestimmte Anzahl von Millisekunden festgelegt sind.
Window.setTimeout()-
Plant die Ausführung einer Funktion zu einer bestimmten Zeit.
Window.showDirectoryPicker()Experimentell Sicherer Kontext-
Zeigt einen Verzeichnisauswahl-Dialog an, der dem Benutzer erlaubt, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()Experimentell Sicherer Kontext-
Zeigt einen Dateiauswahl-Dialog an, der einem Benutzer erlaubt, eine oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()Experimentell Sicherer Kontext-
Zeigt einen Dateiauswahl-Dialog an, der einem Benutzer erlaubt, eine Datei zu speichern.
Window.sizeToContent()Nicht standardisiert-
Ändert die Größe des Fensters entsprechend seinem Inhalt.
Window.stop()-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()-
Erstellt eine tiefe Kopie eines gegebenen Werts unter Verwendung des strukturieren Kopieralgorithmus.
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()gesetzt wurde. Window.releaseEvents()Veraltet-
Hebt die Erfassung spezifischer Ereignistypen durch das Fenster auf.
Window.requestFileSystem()Nicht standardisiert Veraltet-
Ermöglicht es einer Website oder Anwendung, Zugriff auf ein sandboxed Dateisystem für den eigenen Gebrauch zu erlangen.
Window.setImmediate()Nicht standardisiert Veraltet-
Führt eine Funktion aus, nachdem der Browser andere ressourcenintensive Aufgaben abgeschlossen hat.
Window.setResizable()Nicht standardisiert Veraltet-
Tut nichts (kein-Op). Wird für die Rückwärtskompatibilitä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 durch Zuordnen eines Ereignisbehandlungsprogramms zur oneventname-Eigenschaft dieses Interface. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom im Fensterobjekt enthaltenen Document überbubbeln.
error-
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-
Ausgelöst am globalen Scope-Objekt, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize-
Ausgelöst, wenn das Fenster in der Größe verändert wurde.
storage-
Ausgelöst, wenn ein Speicherbereich (
localStorageodersessionStorage) im Kontext eines anderen Dokuments geändert wurde.
Verbindungsevents
Geräteorientierungsevents
devicemotionSicherer Kontext-
In regelmäßigen Abständen ausgelöst und zeigt die Menge an physikalischer Beschleunigungsstärke an, die das Gerät erfährt, sowie die Rotationsrate, falls vorhanden.
deviceorientationSicherer Kontext-
Ausgelöst, wenn frische Daten vom Magnetometersensor zur Orientierung des Geräts im Vergleich zum Erdkoordinatensystem verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Ausgelöst, wenn frische Daten vom Magnetometersensor zur absoluten Orientierung des Geräts im Vergleich zum Erdkoordinatensystem verfügbar sind.
Fokusevents
Gamepad-Events
gamepadconnected-
Ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder zum ersten Mal eine Taste/Achse des Gamepads verwendet wird.
gamepaddisconnected-
Ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Historie-Events
hashchange-
Ausgelöst, wenn sich der Fragment-Identifier der URL geändert hat (der Teil der URL, der mit dem
#-Symbol beginnt und diesem folgt). pagehide-
Gesendet, wenn der Browser das aktuelle Dokument während des Prozesses des Wechsels zu einem anderen Dokument aus dem Sitzungsverlauf ausblendet. Dies geschieht zum Beispiel, wenn der Benutzer auf die Zurück-Schaltfläche klickt oder wenn er auf die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf vorwärts zu navigieren.
pagereveal-
Ausgelöst, wenn ein Dokument zum ersten Mal gerendert wird, entweder wenn ein frisches Dokument aus dem Netzwerk geladen wird oder ein Dokument aktiviert wird (entweder aus der back/forward cache (bfcache) oder prerender).
pageshow-
Gesendet, wenn der Browser das Dokument aufgrund von Navigation sichtbar macht, einschließlich nicht nur, wenn die Seite zuerst geladen wird, sondern auch Situationen wie der Benutzer, der zur Seite zurücknavigiert, nachdem er zu einer anderen innerhalb desselben Tabs navigiert hat.
pageswap-
Ausgelöst, wenn ein Dokument gerade ausgeladen wird, aufgrund einer Navigation.
popstate-
Ausgelöst, wenn sich der aktive Geschichteeintrag ändert.
Lade- und Entladeevents
beforeunload-
Ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen kurz davor sind, entladen zu werden.
load-
Ausgelöst, wenn die gesamte Seite geladen worden ist, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.
unload-
Ausgelöst, wenn das Dokument oder eine Kindressource entladen wird.
Manifest-Events
appinstalled-
Ausgelöst, wenn der Browser erfolgreich eine Seite als Anwendung installiert hat.
beforeinstallprompt-
Ausgelöst, wenn ein Benutzer dazu aufgefordert wird, eine Webanwendung zu installieren.
Messaging-Events
message-
Ausgelöst, wenn das Fenster eine Nachricht erhält, zum Beispiel von einem Aufruf an
Window.postMessage()aus einem anderen Browsing-Kontext. messageerror-
Ausgelöst, wenn ein
Window-Objekt eine Nachricht erhält, die nicht deserialisiert werden kann.
Druck-Events
afterprint-
Ausgelöst, nachdem das zugehörige Dokument zu drucken begonnen hat oder die Druckvorschau geschlossen wurde.
beforeprint-
Ausgelöst, wenn das zugehörige Dokument kurz davor ist, gedruckt oder zur Druckvorschau hinzugefügt zu werden.
Ablehnung von Versprechen-Events
rejectionhandled-
Gesendet jedes Mal, wenn ein JavaScript
Promiseverworfen wird, unabhängig davon, ob ein Behandler vorhanden ist, um die Ablehnung zu erfassen oder nicht. unhandledrejection-
Gesendet, wenn ein JavaScript
Promiseverworfen wird, aber kein Behandler vorhanden ist, um die Ablehnung zu erfassen.
Scroll-Events
scrollsnapchangeExperimentell-
Ausgelöst am Scrollcontainer am Ende einer Scrolloperation, wenn ein neues Scrollziel ausgewählt wurde.
scrollsnapchangingExperimentell-
Ausgelöst am Scrollcontainer, wenn der Browser feststellt, dass ein neues Scrollziel ansteht, d.h. es wird ausgewählt, wenn das aktuelle Scrollgestus endet.
Veraltete Events
orientationchangeVeraltet-
Ausgelöst, wenn sich die Orientierung des Geräts geändert hat.
vrdisplayactivateVeraltet Nicht standardisiert-
Ausgelöst, wenn ein Display präsentiert werden kann.
vrdisplayconnectVeraltet Nicht standardisiert-
Ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.
vrdisplaydisconnectVeraltet Nicht standardisiert-
Ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivateVeraltet Nicht standardisiert-
Ausgelöst, wenn ein Display nicht mehr präsentiert werden kann.
vrdisplaypresentchangeVeraltet Nicht standardisiert-
Ausgelöst, wenn sich der Präsentationszustand eines VR-Geräts ändert – also von Präsentation zu Nicht-Präsentation oder umgekehrt.
Geblähte Events
Nicht alle Ereignisse, die geblättert werden können, können das Window-Objekt erreichen. Nur die folgenden tun dies und können am Window-Objekt gehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM Reference.
Ereignisse auf Window lauschen
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu hören:
- Ein Ereignislistener zum Element hinzufügen, indem die Methode
EventTarget.addEventListenerverwendet wird. - Ein Ereignisbehandlungsprogramm der
oneventname-Eigenschaft des Elements in JavaScript zuweisen. - Ein
on-präfixiertes Attribut im HTML zum Element hinzufügen.
Um auf Ereignisse auf Window-Objekten zu lauschen, können Sie allgemein nur die ersten zwei Methoden verwenden, da Window kein entsprechendes HTML-Element hat. Es gibt jedoch eine spezifische Gruppe von Ereignissen, deren Listener dem <body> (oder dem veralteten <frameset>) Element, das dem Dokument des Window gehört, mit der zweiten oder dritten Methode hinzugefügt werden kann. Diese Ereignisse sind:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
Dies bedeutet, dass die folgenden Beispiele 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, dass das Window-Objekt als currentTarget protokolliert wird.
Spezifikationen
| Specification |
|---|
| HTML> # the-window-object> |