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.
Die Window-Schnittstelle repräsentiert ein Fenster, das ein DOM-Dokument enthält; die Eigenschaft document verweist auf das im Fenster geladene DOM-Dokument.
Ein Fenster für ein gegebenes Dokument kann über die Eigenschaft document.defaultView erhalten werden.
Eine globale Variable window, die das Fenster repräsentiert, in dem das Skript ausgeführt wird, wird dem JavaScript-Code zur Verfügung gestellt.
Die Window-Schnittstelle beherbergt eine Vielzahl von Funktionen, Namensräumen, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters in Verbindung stehen. Dennoch ist die Window-Schnittstelle ein geeigneter Ort, um diese Elemente einzufügen, die global verfügbar sein müssen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem tab-basierten Browser wird jedes Tab durch ein eigenes Window-Objekt repräsentiert; das globale window, das vom JavaScript-Code innerhalb eines bestimmten Tabs gesehen wird, repräsentiert immer das Tab, in dem der Code ausgeführt wird. Trotzdem gelten auch in einem tab-basierten Browser einige Eigenschaften und Methoden für das gesamte Fenster, das das Tab enthält, wie resizeTo() und innerHeight. Im Allgemeinen bezieht sich alles, was nicht vernünftigerweise zu einem Tab gehören kann, stattdessen auf das Fenster.
Instanz-Eigenschaften
Diese Schnittstelle erbt Eigenschaften von der Schnittstelle EventTarget.
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 Assets zur Offline-Nutzung und das Generieren 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 eine Referenz 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 Berichts-Endpunkt gesendet werden, wenn ein Browser-Absturz auftritt. Window.credentiallessSchreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob das aktuelle Dokument in einem credentialless
<iframe>geladen wurde. Siehe IFrame credentialless für weitere Einzelheiten. Window.crossOriginIsolatedSchreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, 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 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 auf dem aktuellen Display zurück.
Window.documentSchreibgeschützt-
Gibt eine Referenz auf das Dokument zurück, das das Fenster enthält.
Window.documentPictureInPictureSchreibgeschützt Sicherer Kontext-
Gibt eine Referenz auf das Document Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.
Window.fenceSchreibgeschützt-
Gibt eine
Fence-Objektinstanz für den aktuellen Dokumentkontext zurück. Verfügbar nur für Dokumente, 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 Unterframes im aktuellen Fenster zurück.
Window.fullScreen-
Diese Eigenschaft zeigt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.
Window.historySchreibgeschützt-
Gibt eine Referenz auf das Verlaufsobjekt zurück.
Window.indexedDBSchreibgeschützt-
Bietet einen Mechanismus, mit dem Anwendungen asynchron auf die Möglichkeiten von indizierten Datenbanken zugreifen können; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Ruft die Höhe des Inhaltsbereichs des Browserfensters einschließlich, falls vorhanden, der horizontalen Scrollleiste ab.
Window.innerWidthSchreibgeschützt-
Ruft die Breite des Inhaltsbereichs des Browserfensters einschließlich, falls vorhanden, der vertikalen Scrollleiste ab.
Window.isSecureContextSchreibgeschützt-
Gibt ein boolesches Ergebnis zurück, das anzeigt, ob der aktuelle Kontext sicher ist (
true) oder nicht (false). Window.launchQueueSchreibgeschützt-
Wenn eine progressive 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 Launch-Navigation 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 Lokalspeicher-Objekt zurück, das verwendet wird, um Daten zu speichern, die nur von der Ursprungsquelle abgerufen werden können, die sie erstellt hat.
Window.location-
Ruft den Standort oder die aktuelle URL des Fensterobjekts ab/legt sie 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 Viewports des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor zu Bildschirm-Pixeln, falls erforderlich. Window.mozInnerScreenYSchreibgeschützt-
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 zu Bildschirm-Pixeln, falls erforderlich. Window.name-
Ruft den Namen des Fensters ab/legt ihn fest.
-
Gibt das aktuelle
window's 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.originSchreibgeschützt-
Gibt den Ursprung des globalen Objekts als Zeichenkette zurück.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem ursprungs-kodierten Agenten-Cluster gehört. Window.outerHeightSchreibgeschützt-
Ruft die Höhe des Äußeren des Browserfensters ab.
Window.outerWidthSchreibgeschützt-
Ruft die Breite des Äußeren 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 Elternobjekt des aktuellen Fensters oder Unterrahmens zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, zu dem die Attributetimingundnavigationgehören, von denen jedes ein Objekt ist, das leistungsbezogene Daten bereitstellt. Siehe auch Verwenden der Navigations-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 Priorisierte Task Scheduling-API. Window.screenSchreibgeschützt-
Gibt eine Referenz auf das Bildschirminfo-Objekt zurück, das mit dem Fenster verknüpft ist.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Benutzeransichtsfensters zum linken Rand des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Benutzeransichtsfensters zum oberen Rand 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, das heißt die Dokumentbreite minus der Viewport-Breite.
Window.scrollMaxYSchreibgeschützt-
Der maximale Versatz, zu dem das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus der Viewport-Hö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 eine Objekt-Referenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt eine Referenz auf das Session-Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur von der Ursprungsquelle 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 geteilten Speicher mithilfe der Shared Storage API. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das den Einstieg in die Nutzung 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 eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist nur lesbar.
Window.trustedTypesSchreibgeschützt-
Gibt das
TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verbunden ist, und bietet den Einstiegspunkt in die Nutzung der Trusted Types API. Window.viewportSchreibgeschützt-
Gibt eine
Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Gerätevieports bietet. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewportObjekt zurück, das das visuelle Viewport für ein gegebenes 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 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(wenn nicht leer) exponiert. Wenn das Dokument beispielsweise<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 seine
id(wenn nicht leer) exponiert.
Falls 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 iframe zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.eventSchreibgeschützt-
Gibt das aktuelle Ereignis zurück, das derzeit im JavaScript-Kontext behandelt wird, oder
undefined, wenn derzeit kein Ereignis behandelt wird. DasEvent-Objekt, das direkt an Event-Handler übergeben wird, sollte stattdessen verwendet werden, wann immer möglich. Window.externalSchreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter dem Browser hinzuzufügen.
Window.orientationSchreibgeschützt-
Gibt die Orientierung in Grad (in 90 Grad Inkrementen) des Viewports relativ zur natürlichen Orientierung des Geräts zurück.
Window.status-
Ruft den Text in der Statusleiste unten im Browser ab/setzt ihn fest.
Instanz-Methoden
Diese Schnittstelle erbt Methoden von der Schnittstelle EventTarget.
Window.atob()-
Dekodiert eine Datenzeichenkette, die unter Verwendung der Base-64-Codierung kodiert wurde.
Window.alert()-
Zeigt ein Warn-Dialogfeld an.
Window.blur()-
Entzieht dem Fenster den Fokus.
Window.btoa()-
Erstellt eine Base-64-kodierte ASCII-Zeichenkette aus einer Zeichenkette binärer Daten.
Window.cancelAnimationFrame()-
Ermöglicht es Ihnen, einen zuvor mit
Window.requestAnimationFramegeplanten Callback abzubrechen. Window.cancelIdleCallback()-
Ermöglicht es Ihnen, einen zuvor mit
Window.requestIdleCallbackgeplanten Callback abzubrechen. Window.clearInterval()-
Hebt die wiederholte Ausführung auf, die mit
Window.setInterval()festgelegt wurde. Window.clearTimeout()-
Hebt die verzögerte Ausführung auf, die mit
Window.setTimeout()festgelegt wurde. Window.close()-
Schließt das aktuelle Fenster.
Window.confirm()-
Zeigt ein Dialogfeld mit einer Nachricht an, auf die der Benutzer antworten muss.
Window.createImageBitmap()-
Akzeptiert eine Vielzahl unterschiedlicher Bildquellen und gibt ein
Promisezurück, das sich in einImageBitmapauflöst. Optional wird die Quelle auf das Pixelrechteck mit Ursprung bei (sx, sy) mit Breite sw und Höhe sh zugeschnitten. Window.dump()-
Schreibt eine Nachricht in die Konsole.
Window.fetch()-
Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.
Window.fetchLater()-
Erstellt einen verzögerten Abruf, der gesendet wird, sobald die Seite navigiert wird (sie wird zerstört oder tritt in den bfcache ein), oder nach einer bereitgestellten
activateAfter-Zeitüberschreitung — je nachdem, was zuerst eintritt. Window.find()-
Sucht nach einer gegebenen Zeichenkette in einem Fenster.
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, indem Autor-Stilblätter ignoriert werden.
Window.getScreenDetails()Sicherer Kontext-
Gibt ein
Promisezurück, das sich mit einemScreenDetails-Objekt auflöst, das die Details aller auf dem Gerät des Benutzers verfügbaren Bildschirme darstellt. Window.getSelection()-
Gibt das Auswahl-Objekt zurück, das die ausgewählten Elemente darstellt.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die angegebene Media-Abfrage-Zeichenkette 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, dass ein Fenster eine Datenzeichenkette an ein anderes Fenster sendet, das nicht innerhalb desselben Domänennamens wie das erste sein muss.
Window.print()-
Öffnet das Druckdialogfeld, um das aktuelle Dokument zu drucken.
Window.prompt()-
Gibt den Text zurück, den der Benutzer in einem Eingabeaufforderungs-Dialog eingegeben hat.
Window.queryLocalFonts()Sicherer Kontext-
Gibt ein
Promisezurück, das sich mit einem Array vonFontData-Objekten auflöst, die die lokal verfügbaren Schriftarten darstellen. Window.queueMicrotask()-
Stellt eine Microtask zur Ausführung zu einer sicheren Zeit vor der Rückkehr der Kontrolle in die Ereignisschleife des Browsers in die Warteschlange.
Window.reportError()-
Meldet einen Fehler in einem Skript und emuliert eine unbehandelte Ausnahme.
Window.requestAnimationFrame()-
Sagt dem Browser, dass eine Animation im Gange ist und fordert den Browser auf, ein Neuzeichnen des Fensters für den nächsten Animationsrahmen zu planen.
Window.requestIdleCallback()-
Ermöglicht die Planung von Aufgaben während der Ruhephasen eines Browsers.
Window.requestResize()-
Aktualisiert die Größeninformationen, die von einem eingebetteten Dokument mit seinem einbettenden Elternteil geteilt werden, jedoch nur, wenn das eingebettete Dokument sich zum Teilen seiner Größeninformationen entschieden hat.
Window.resizeBy()-
Ändert die Größe des aktuellen Fensters um einen bestimmten Betrag.
Window.resizeTo()-
Ändert die Fenstergröße 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, die jedes Mal ausgeführt wird, wenn eine bestimmte Anzahl von Millisekunden verstreicht.
Window.setTimeout()-
Plant eine Funktion, die nach einer bestimmten Zeit ausgeführt wird.
Window.showDirectoryPicker()Sicherer Kontext-
Zeigt einen Verzeichnis-Picker an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()Sicherer Kontext-
Zeigt einen Dateipicker an, mit dem ein Benutzer eine Datei oder mehrere Dateien auswählen kann.
Window.showSaveFilePicker()Sicherer Kontext-
Zeigt einen Dateipicker an, der es einem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()-
Passt die Fenstergröße entsprechend dem Inhalt an.
Window.stop()-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()-
Erstellt eine tiefe Kopie eines gegebenen Wertes unter Verwendung des strukturierten Klonalalgorithmus.
Veraltete Methoden
Window.captureEvents()-
Registriert das Fenster, um alle Ereignisse eines bestimmten Typs zu erfassen.
Window.clearImmediate()-
Hebt die wiederholte Ausführung auf, die mit
setImmediate()festgelegt wurde. Window.releaseEvents()-
Löst das Fenster aus, um Ereignisse eines bestimmten Typs nicht mehr zu erfassen.
Window.requestFileSystem()-
Ermöglicht es einer Webseite oder einer App, Zugriff auf ein Sandbox-Dateisystem für ihre eigene Verwendung zu erhalten.
Window.setImmediate()-
Führt eine Funktion aus, nachdem der Browser andere aufwendige Aufgaben abgeschlossen hat.
Window.setResizable()-
Tut nichts (no-op). Aus Gründen der Abwä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 diese Ereignisse mit addEventListener() ab oder indem Sie einen Ereignis-Listener der oneventname-Eigenschaft dieser Schnittstelle zuweisen. Abgesehen von den unten aufgeführten Ereignissen, können viele Ereignisse von dem Document, das im Fenster-Objekt enthalten ist, hochsteigen.
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 beim globalen Bereichsobjekt, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize-
Ausgelöst, wenn das Fenster neu dimensioniert wurde.
storage-
Ausgelöst, wenn ein Speicherbereich (
localStorageodersessionStorage) im Kontext eines anderen Dokuments geändert wurde.
Verbindungs-Ereignisse
Geräteorientierungs-Ereignisse
devicemotionSicherer Kontext-
In regelmäßigen Intervallen ausgelöst, um die Menge der physikalischen Beschleunigungskräfte zu zeigen, die das Gerät empfängt und die Rotationsgeschwindigkeit, falls verfügbar.
deviceorientationSicherer Kontext-
Ausgelöst, wenn frische Daten von dem Magnetometer-Orientierungssensor über die aktuelle Orientierung des Geräts im Vergleich zum Erd-Koordinatenrahmen verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor über die aktuelle absolute Orientierung des Geräts im Vergleich zum Erd-Koordinatenrahmen verfügbar sind.
Fokus-Ereignisse
Gamepad-Ereignisse
gamepadconnected-
Ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde oder das erste Mal eine Taste/Achse des Gamepads benutzt wird.
gamepaddisconnected-
Ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlauf-Ereignisse
hashchange-
Ausgelöst, wenn sich der Fragment-Identifikator der URL geändert hat (der Teil der URL beginnend mit und folgend nach dem
#-Symbol). pagehide-
Gesendet, wenn der Browser das aktuelle Dokument ausblendet, während er dabei ist, ein anderes Dokument aus dem Sitzungssverlauf an dessen Stelle anzuzeigen. Dies geschieht beispielsweise, wenn der Benutzer auf die Zurück-Schaltfläche klickt oder wenn er auf die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf voranzugehen.
pagereveal-
Ausgelöscht, wenn ein Dokument erstmals gerendert wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder der Aktivierung eines Dokuments (entweder aus back/forward cache (bfcache) oder prerender).
pageshow-
Gesendet, wenn der Browser das Dokument aufgrund von Navigationsaufgaben sichtbar macht, einschließlich nicht nur, wenn die Seite zuerst geladen wird, sondern auch Situationen wie der Benutzer navigiert zurück zur Seite, nachdem er zu einer anderen innerhalb desselben Tabs navigiert ist.
pageswap-
Ausgelöst, wenn ein Dokument aufgrund einer Navigation entladen werden soll.
popstate-
Ausgelöst, wenn der aktive Verlaufseintrag geändert wird.
Lade- & Entlade-Ereignisse
beforeunload-
Ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen fast entladen sind.
load-
Ausgelöst, wenn die ganze Seite geladen ist, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.
unload-
Ausgelöst, wenn das Dokument oder eine Kindeinheit entladen wird.
Manifest-Ereignisse
appinstalled-
Ausgelöst, wenn der Browser eine Seite erfolgreich als Anwendung installiert hat.
beforeinstallprompt-
Ausgelöst, wenn ein Benutzer kurz davor ist, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichten-Ereignisse
message-
Ausgelöst, wenn das Fenster eine Nachricht erhält, zum Beispiel durch einen Aufruf von
Window.postMessage()aus einem anderen Browsing-Kontext. messageerror-
Ausgelöst, wenn ein
Window-Objekt eine Nachricht erhält, die nicht deserialisiert werden kann.
Druck-Ereignisse
afterprint-
Ausgelöst, nachdem das zugehörige Dokument mit dem Drucken oder der Druckvorschau begonnen hat.
beforeprint-
Ausgelöst, wenn das zugehörige Dokument gedruckt wird oder zur Druckvorschau bereit ist.
Promise-Ablehnungs-Ereignisse
rejectionhandled-
Gesendet, jedes Mal, wenn ein JavaScript
Promiseabgelehnt wird, unabhängig davon, ob ein Handler darauf wartet, die Ablehnung zu behandeln oder nicht. unhandledrejection-
Gesendet, wenn ein JavaScript
Promiseabgelehnt wird, aber kein Handler vorhanden ist, der die Ablehnung behandelt.
Scroll-Ereignisse
scrollsnapchange-
Ausgelöst beim Scroll-Container nach Abschluss eines Scroll-Vorgangs, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging-
Ausgelöst beim Scroll-Container, wenn der Browser feststellt, dass ein neuer Scroll-Snap-Ziel aussteht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.
Veraltete Ereignisse
orientationchange-
Ausgelöst, wenn sich die Orientierung des Geräts ändert.
vrdisplayactivate-
Ausgelöst, wenn ein Display präsentiert werden kann.
vrdisplayconnect-
Ausgelöst, wenn ein kompatibles VR-Gerät an den Computer angeschlossen wurde.
vrdisplaydisconnect-
Ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivate-
Ausgelöst, wenn ein Display nicht mehr präsentiert werden kann.
vrdisplaypresentchange-
Ausgelöst, wenn der Präsentationszustand eines VR-Geräts wechselt — d.h. von präsent zu nicht präsent, oder umgekehrt.
Hochstrebende Ereignisse
Nicht alle Ereignisse, die hochstreben, können das Window-Objekt erreichen. Nur die folgenden tun es und können am Window-Objekt abgehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Überwachung von Ereignissen auf Window
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu hören:
- Durch hinzufügen eines Ereignis-Listeners zum Element mithilfe der Methode
EventTarget.addEventListener. - Durch zuweisen eines Ereignis-Handlers zur
oneventnameEigenschaft des Elements in JavaScript. - Durch hinzufügen eines
on-prefixierten Attributs zum Element im HTML.
Um Ereignisse auf Window-Objekten zu hören, können Sie im Allgemeinen nur die ersten beiden Methoden verwenden, da es kein entsprechendes HTML-Element für Window gibt. Es gibt jedoch eine besondere Gruppe von Ereignissen, bei denen Listener zum <body> (oder dem veralteten <frameset>) Element hinzugefügt werden können, das dem Dokument des Window-Objekts gehört, indem die zweite oder dritte Methode verwendet wird. Diese Ereignisse sind:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
Das bedeutet, dass die folgenden strikt äquivalent 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.
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-window-object> |