Window
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das Window-Interface repräsentiert ein Fenster, das ein DOM-Dokument enthält; Die document-Eigenschaft verweist auf das im Fenster geladene DOM-Dokument.
Ein Fenster für ein bestimmtes Dokument kann über die document.defaultView-Eigenschaft abgerufen werden.
Eine globale Variable, window, die das Fenster darstellt, in dem das Skript ausgeführt wird, wird im JavaScript-Code bereitgestellt.
Das Window-Interface ist die Heimat einer Vielzahl von Funktionen, Namensräumen, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Trotzdem ist das Window-Interface ein geeigneter Ort, um diese Elemente aufzunehmen, die global verfügbar sein müssen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem Tabbed-Browser wird jeder Tab durch ein eigenes Window-Objekt dargestellt; das globale window, das der JavaScript-Code sieht, läuft immer innerhalb des Tabs, in dem der Code läuft. Dennoch gelten auch in einem Tabbed-Browser einige Eigenschaften und Methoden für das gesamte Fenster, das den Tab enthält, wie etwa resizeTo() und innerHeight. Im Allgemeinen gilt alles, was nicht vernünftigerweise für einen Tab gelten kann, stattdessen für das Fenster.
Instanzeigenschaften
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 verknüpft ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Ressourcen für die Offline-Nutzung und das Erzeugen benutzerdefinierter 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 einen Verweis auf das
CookieStore-Objekt für den aktuellen Dokumentkontext zurück. Window.crashReportSchreibgeschützt Sicherer Kontext-
Gibt ein
CrashReportContext-Objekt zurück, das es ermöglicht, beliebige Daten für den aktuellen obersten Browsing-Kontext aufzuzeichnen, die dann zu einemCrashReporthinzugefügt und an einen Meldeendpunkt gesendet werden, wenn ein Browser-Absturz auftritt. Window.credentiallessSchreibgeschützt-
Gibt ein boolean zurück, das angibt, ob das aktuelle Dokument in einem credentialless
<iframe>geladen wurde. Siehe IFrame credentialless für weitere Details. Window.crossOriginIsolatedSchreibgeschützt-
Gibt ein boolean zurück, das angibt, ob sich die Website in einem Cross-Origin-Isolationszustand befindet.
Window.cryptoSchreibgeschützt-
Gibt das
Crypto-Objekt zurück, das mit dem globalen Objekt verknüpft ist. Window.customElementsSchreibgeschützt-
Gibt einen Verweis 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 einen Verweis auf das Dokument zurück, das das Fenster enthält.
Window.documentPictureInPictureSchreibgeschützt Sicherer Kontext-
Gibt einen Verweis auf das document Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.
Window.fenceSchreibgeschützt-
Gibt eine
Fence-Objektexemplar 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 Unterrahmen im aktuellen Fenster zurück.
Window.fullScreen-
Diese Eigenschaft zeigt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.
Window.historySchreibgeschützt-
Gibt einen Verweis auf das Verlauf-Objekt zurück.
Window.indexedDBSchreibgeschützt-
Bietet eine Möglichkeit für Anwendungen, asynchron auf Fähigkeiten 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 Bildlaufleiste.
Window.innerWidthSchreibgeschützt-
Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich, wenn gerendert, der vertikalen Bildlaufleiste.
Window.isSecureContextSchreibgeschützt-
Gibt ein boolean zurück, das anzeigt, ob der aktuelle Kontext sicher ist (
true) oder nicht (false). Window.launchQueueSchreibgeschützt-
Wenn eine fortschrittliche Webanwendung (PWA) mit einem
launch_handlerclient_mode-Wert vonfocus-existing,navigate-newodernavigate-existinggestartet wird, bietet dielaunchQueueZugriff auf dieLaunchQueue-Klasse, die es ermöglicht, eine benutzerdefinierte Startnavigation 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 einen Verweis auf das lokale Speicherobjekt zurück, das Daten speichert, die nur vom Urheber, der es erstellt hat, abgerufen werden können.
Window.location-
Ruft den Standort ab oder legt den aktuellen URL des Fensterobjekts fest.
Window.locationbarSchreibgeschützt-
Gibt das locationbar-Objekt zurück.
-
Gibt das menubar-Objekt zurück.
Window.mozInnerScreenXSchreibgeschützt-
Gibt die horizontale (X) Koordinate der oberen linken Ecke des Fensters im Ansichtsbereich in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor, um bei Bedarf an Bildschirm-Pixel anzupassen. Window.mozInnerScreenYSchreibgeschützt-
Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Fensters im Ansichtsbereich in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixelfür einen Umrechnungsfaktor, um bei Bedarf an Bildschirm-Pixel anzupassen. Window.name-
Ruft den Namen des Fensters ab oder legt ihn fest.
-
Gibt das aktuelle
window-verbundeneNavigation-Objekt zurück. Der Einstiegspunkt für die Navigation API. -
Gibt einen Verweis auf das navigator-Objekt zurück.
Window.opener-
Gibt einen Verweis auf das Fenster zurück, das dieses aktuelle Fenster geöffnet hat.
Window.originSchreibgeschützt-
Gibt den Ursprung des globalen Objekts, als Zeichenkette serialisiert, zurück.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem ursprungs-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 einen Verweis auf das übergeordnete Fenster des aktuellen Fensters oder Unterrahmens zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, das dietimingundnavigationAttribute enthält, die jeweils ein Objekt sind, das leistungsbezogene Daten bereitstellt. Siehe auch Verwenden der Navigation Timing API 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 Verwendung der Prioritized Task Scheduling API. Window.screenSchreibgeschützt-
Gibt einen Verweis auf das mit dem Fenster verbundene Bildschirmobjekt zurück.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben die horizontale Distanz von der linken Grenze des Ansichtsbereichs des Benutzers bis zur linken Seite des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben die vertikale Distanz von der oberen Grenze des Ansichtsbereichs des Benutzers bis zur oberen Seite des Bildschirms zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das scrollbars-Objekt zurück.
Window.scrollMaxXSchreibgeschützt-
Der maximale Versatz, zu dem das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus die Ansichtsbreite.
Window.scrollMaxYSchreibgeschützt-
Der maximale Versatz, zu dem das Fenster vertikal gescrollt werden kann (d.h. die Dokumenhöhe minus die Ansichtshöhe).
Window.scrollXSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits horizontal gescrollt wurde.
Window.scrollYSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits vertikal gescrollt wurde.
Window.selfSchreibgeschützt-
Gibt einen Objektverweis auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt einen Verweis auf das Sitzungsspeicherobjekt zurück, das Daten speichert, die nur von der Ursprungsadresse abgerufen werden können, die 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 mithilfe der Shared Storage API. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das den Einstiegspunkt in die Verwendung der Sprachsynthesefunktionalitä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 einen Verweis 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.viewportSchreibgeschützt-
Gibt eine
Viewport-Objektexemplar zurück, die Informationen über den aktuellen Zustand des Ansichtsbereichs des Geräts liefert. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-Objekt zurück, das den visuellen Ansichtsbereich für ein gegebenes Fenster repräsentiert. Window.windowSchreibgeschützt-
Gibt einen Verweis auf das aktuelle Fenster zurück.
window[0],window[1], etc.-
Gibt einen Verweis 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 verfügbar gemacht:
- Für jedes
<embed>,<form>,<iframe>,<img>und<object>-Element wird dername(wenn nicht leer) verfügbar gemacht. Zum Beispiel, wenn das Dokument<form name="my_form">enthält, dann gibtwindow["my_form"](und das äquivalentewindow.my_form) einen Verweis auf dieses Element zurück. - Für jedes HTML-Element wird die
id(wenn nicht leer) verfügbar gemacht.
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 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.eventSchreibgeschützt-
Gibt das aktuelle Ereignis zurück, welches das Ereignis ist, das momentan im JavaScript-Kontext verarbeitet wird, oder
undefined, wenn momentan kein Ereignis verarbeitet wird. Das direkt an die Ereignishandler übergebeneEvent-Objekt sollte stattdessen wann immer möglich verwendet werden. Window.externalSchreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter zum Browser hinzuzufügen.
Window.orientationSchreibgeschützt-
Gibt die Orientierung in Grad zurück (in 90-Grad-Schritten) des Ansichtsbereichs im Verhältnis zur natürlichen Orientierung des Geräts.
Window.status-
Ruft den Text in der Statusleiste am unteren Rand des Browsers ab oder legt ihn fest.
Instanzmethoden
Dieses Interface erbt Methoden vom EventTarget-Interface.
Window.atob()-
Dekodiert eine Zeichenkette von Daten, die unter Verwendung der Basis-64-Codierung codiert wurde.
Window.alert()-
Zeigt einen Alert-Dialog an.
Window.blur()-
Setzt den Fokus vom Fenster weg.
Window.btoa()-
Erstellt eine ASCII-Zeichenkette, die mithilfe von Basis-64-Codierung aus einer Binärdaten-Zeichenkette codiert wurde.
Window.cancelAnimationFrame()-
Ermöglicht das Abbrechen eines zuvor mit
Window.requestAnimationFramegeplanten Rückrufs. Window.cancelIdleCallback()-
Ermöglicht das Abbrechen eines zuvor geplanten Rückrufs mit
Window.requestIdleCallback. Window.clearInterval()-
Hebt die wiederholte Ausführung auf, die mit
Window.setInterval()eingestellt wurde. Window.clearTimeout()-
Hebt die verzögerte Ausführung auf, die mit
Window.setTimeout()eingestellt 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 verschiedener Bildquellen und gibt eine
Promisezurück, die in einemImageBitmapaufgelöst wird. Optional wird die Quelle auf das Rechteck von Pixeln zugeschnitten, die an (sx, sy) mit der Breite sw und der Höhe sh ihren Ursprung haben. Window.dump()-
Schreibt eine Nachricht in die Konsole.
Window.fetch()-
Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.
Window.fetchLater()-
Erstellt einen zurückgestellten Abruf, der gesendet wird, sobald die Seite verlassen wird (sie zerstört wird oder in den bfcache eintritt), oder nach einem angegebenen
activateAfter-Timer — was auch immer zuerst eintritt. Window.find()-
Sucht in einem 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()-
Ruft den Standard-berechneten Stil für das angegebene Element ab, wobei Autoren-Stylesheets ignoriert werden.
Window.getScreenDetails()Sicherer Kontext-
Gibt eine
Promisezurück, die sich mit einemScreenDetails-Objektexemplar erfüllt, das die Details aller Bildschirme bereitstellt, 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) repräsentiert.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die angegebene Media-Query-Zeichenkette 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 eine sichere Möglichkeit, dass ein Fenster eine Zeichenkette von Daten an ein anderes Fenster sendet, das nicht in derselben Domain wie das erste sein muss.
Window.print()-
Öffnet den Druckdialog, um das aktuelle Dokument zu drucken.
Window.prompt()-
Gibt den vom Benutzer in einem Eingabefeld eines Dialogs eingegebenen Text zurück.
Window.queryLocalFonts()Sicherer Kontext-
Gibt eine
Promisezurück, die sich mit einem Array vonFontData-Objekten erfüllt, die die lokal verfügbaren Schriftarten repräsentieren. Window.queueMicrotask()-
Wartet einen Mikroauftrag ein, um zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle in die Ereignisschleife des Browsers ausgeführt zu werden.
Window.reportError()-
Meldet einen Fehler in einem Skript und emuliert eine unbehandelte Ausnahme.
Window.requestAnimationFrame()-
Teilt dem Browser mit, dass eine Animation im Gange ist und fordert den Browser auf, ein Neuzeichnen des Fensters für den nächsten Animationsrahmen zu planen.
Window.requestIdleCallback()-
Ermöglicht die Planung von Aufgaben während der Ruhezeiten eines Browsers.
Window.requestResize()-
Aktualisiert die Größeninformationen, die von einem eingebetteten Dokument mit seinem einbettenden übergeordneten Element geteilt werden, jedoch nur, wenn das eingebettete Dokument sich entschieden hat, seine Größeninformationen zu teilen.
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()-
Scrollt das Dokument um die angegebene Anzahl von Zeilen.
Window.scrollByPages()-
Scrollt das aktuelle Dokument um die angegebene Anzahl von Seiten.
Window.scrollTo()-
Scrollt zu einem bestimmten Satz von Koordinaten im Dokument.
Window.setInterval()-
Plant eine Funktion zur Ausführung, jedes Mal wenn eine angegebene Anzahl von Millisekunden vergangen ist.
Window.setTimeout()-
Plant eine Funktion zur Ausführung nach einer bestimmten Zeitspanne.
Window.showDirectoryPicker()Sicherer Kontext-
Zeigt einen Verzeichnisauswahldialog an, der dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der dem Benutzer ermöglicht, eine Datei oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der dem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()-
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 Strukturklon-Algorithmus.
Veraltete Methoden
Window.captureEvents()-
Registriert das Fenster, um alle Ereignisse des angegebenen Typs zu erfassen.
Window.clearImmediate()-
Hebt die wiederholte Ausführung auf, die mit
setImmediate()eingestellt wurde. Window.releaseEvents()-
Gibt das Fenster frei, um Ereignisse eines bestimmten Typs abzufangen.
Window.requestFileSystem()-
Ermöglicht einer Website oder App, Zugriff auf ein sandboxed Dateisystem für eigenen Gebrauch zu erhalten.
Window.setImmediate()-
Führt eine Funktion aus, nachdem der Browser andere schwere Aufgaben beendet hat.
Window.setResizable()-
Macht nichts (no-op). Wird für Rückwärtskompatibilität mit Netscape 4.x beibehalten.
Window.webkitConvertPointFromNodeToPage()-
Transformiert einen
WebKitPointvom Koordinatensystem des Knotens zum Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()-
Transformiert einen
WebKitPointvom Koordinatensystem der Seite zum Koordinatensystem des Knotens.
Ereignisse
Hören Sie auf diese Ereignisse, indem Sie addEventListener() verwenden oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieses Interfaces zuweisen. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom Document, das sich im Fensterobjekt befindet, nach oben blubbern.
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 am globalen Scope-Objekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize-
Wird ausgelöst, wenn das Fenster in der Größe verändert wurde.
storage-
Wird ausgelöst, wenn ein Speicherbereich (
localStorageodersessionStorage) im Kontext eines anderen Dokuments geändert wurde.
Verbindung-Ereignisse
Geräteorientierungs-Ereignisse
devicemotionSicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und gibt die Menge an physischer Beschleunigungskraft an, die das Gerät empfängt, sowie die Rotationsrate, falls verfügbar.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor über die aktuelle Ausrichtung des Geräts im Vergleich zum Erdkordinatensystem verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor über die aktuelle absolute Ausrichtung des Geräts im Vergleich zum Erdkordinatensystem verfügbar sind.
Fokus-Ereignisse
Gamepad-Ereignisse
gamepadconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde oder das erste Mal ein Knopf/Achse des Gamepads benutzt wird.
gamepaddisconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufs-Ereignisse
hashchange-
Wird ausgelöst, wenn sich der Fragment-Identifikator der URL geändert hat (der Teil der URL, der mit
#beginnt und ihm folgt). pagehide-
Wird gesendet, wenn der Browser das aktuelle Dokument versteckt, während im Prozess des Wechsels zur Anzeige eines anderen Dokuments aus der Sitzungshistorie. Dies geschieht zum Beispiel, wenn der Benutzer die Zurück-Schaltfläche klickt oder wenn er die Vorwärts-Schaltfläche klickt, um in der Sitzungshistorie weiter zu navigieren.
pagereveal-
Wird ausgelöst, wenn ein Dokument erstmals gerendert wird, entweder beim Laden eines frischen Dokuments aus dem Netzwerk oder der Aktivierung eines Dokuments (entweder aus dem back/forward cache (bfcache) oder prerender).
pageshow-
Wird gesendet, wenn der Browser das Dokument durch Navigationsaufgaben sichtbar macht, einschließlich nicht nur, wenn die Seite erstmals geladen wird, sondern auch, wenn der Benutzer zur Seite zurücknavigiert, nachdem er zu einer anderen innerhalb desselben Tabs navigiert hat.
pageswap-
Wird ausgelöst, wenn ein Dokument wegen einer Navigation entladen wird.
popstate-
Wird ausgelöst, wenn sich der aktive Verlaufseintrag ändert.
Lade- & Entlade-Ereignisse
beforeunload-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen kurz davor stehen, entladen zu werden.
load-
Wird ausgelöst, wenn die gesamte Seite geladen ist, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.
unload-
Wird ausgelöst, wenn das Dokument oder eine kindliche Ressource entladen wird.
Manifest-Ereignisse
appinstalled-
Wird ausgelöst, wenn der Browser eine Seite erfolgreich als Anwendung installiert hat.
beforeinstallprompt-
Wird ausgelöst, wenn ein Benutzer darauf hingewiesen wird, eine Webanwendung zu installieren.
Nachrichten-Ereignisse
message-
Wird ausgelöst, wenn das Fenster eine Nachricht empfängt, etwa 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.
Druck-Ereignisse
afterprint-
Wird ausgelöst, nachdem das zugehörige Dokument gedruckt wurde oder die Druckvorschau geschlossen wurde.
beforeprint-
Wird ausgelöst, wenn das zugehörige Dokument gedruckt wird oder zur Druckvorschau vorbereitet wird.
Promise-Abweisungs-Ereignisse
rejectionhandled-
Wird gesendet, jedes Mal wenn ein JavaScript-
Promiseabgelehnt wird, egal ob ein Handler vorhanden ist, um die Ablehnung zu behandeln oder nicht. unhandledrejection-
Wird gesendet, wenn ein JavaScript-
Promiseabgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung zu behandeln.
Scroll-Ereignisse
scrollsnapchange-
Wird am Scrollcontainer am Ende eines Scrollvorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging-
Wird am Scrollcontainer ausgelöst, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel aussteht, d.h. es wird ausgewählt, wenn die aktuelle Scrollgeste endet.
Veraltete Ereignisse
orientationchange-
Wird ausgelöst, wenn sich die Ausrichtung des Geräts geändert hat.
vrdisplayactivate-
Wird ausgelöst, wenn ein Display zur Darstellung bereit ist.
vrdisplayconnect-
Wird ausgelöst, wenn ein kompatibles VR-Gerät an den Computer angeschlossen wurde.
vrdisplaydisconnect-
Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivate-
Wird ausgelöst, wenn ein Display nicht mehr dargestellt werden kann.
vrdisplaypresentchange-
Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert — d.h. von der Darstellung zur Nichtdarstellung oder umgekehrt.
Gebubbelte Ereignisse
Nicht alle Ereignisse, die gebubbelt werden, können das Window-Objekt erreichen. Nur die folgenden können dies tun und können auf dem Window-Objekt abgehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Ereignisse auf Window hören
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu hören:
- Fügen Sie dem Element einen Ereignis-Listener mit der Methode
EventTarget.addEventListenerhinzu. - Weisen Sie dem Element einen Ereignis-Handler in JavaScript zu dessen
oneventname-Eigenschaft zu. - Fügen Sie dem Element im HTML ein
on-präfixiertes Attribut 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 bestimmte Gruppe von Ereignissen, deren Listener dem <body>-Element (oder dem veralteten <frameset>-Element), das im Dokument des Window enthalten ist, mit der zweiten oder dritten Methode hinzugefügt werden können. Diese Ereignisse sind:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
Dies bedeutet, dass die folgenden im Wesentlichen 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
| Spezifikation |
|---|
| HTML> # the-window-object> |