Fenster
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 DOM-Dokument, das in diesem Fenster geladen ist.
Ein Fenster für ein bestimmtes Dokument kann mit der document.defaultView-Eigenschaft erhalten werden.
Eine globale Variable, window, die das Fenster repräsentiert, in dem das Skript ausgeführt wird, ist für JavaScript-Code zugänglich.
Das Window-Interface beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Das Window-Interface ist jedoch ein geeigneter Ort, um diese Elemente unterzubringen, 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 in einem bestimmten Tab ausgeführten JavaScript-Code gesehen wird, repräsentiert immer das Tab, in dem der Code ausgeführt wird. Das heißt, selbst in einem Tab-basierten Browser gelten einige Eigenschaften und Methoden weiterhin für das gesamte Fenster, das das Tab enthält, wie z.B. resizeTo() und innerHeight. Allgemein gilt: Alles, was nicht vernünftigerweise einem Tab zugeordnet werden kann, bezieht sich 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 aufgelistet 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 für die Offline-Nutzung und das Erstellen 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 Dokumentenkontext zurück. Window.crashReportSchreibgeschützt Sicherer Kontext-
Gibt ein
CrashReportContext-Objekt zurück, das es ermöglicht, beliebige Daten für den aktuellen Top-Level-Browsing-Kontext aufzuzeichnen, die dann zu einemCrashReporthinzugefügt und beim Absturz des Browsers an einen Berichterstattungspunkt gesendet werden. Window.credentiallessSchreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, 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 anzeigt, ob die Website sich in einem zustandslosen isolierten Zustand befindet (cross-origin isolation).
Window.cryptoSchreibgeschützt-
Gibt das
Crypto-Objekt zurück, das dem globalen Objekt zugeordnet ist. Window.customElementsSchreibgeschützt-
Gibt eine Referenz auf das
CustomElementRegistry-Objekt zurück, das zur Registrierung neuer benutzerdefinierter Elemente und zum Abrufen von Informationen über zuvor registrierte benutzerdefinierte Elemente verwendet werden kann. Window.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 Sicherer Kontext-
Gibt eine Referenz auf das Dokument 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. 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 Unterfenster 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 Verlauf-Objekt zurück.
Window.indexedDBSchreibgeschützt-
Bietet eine Mechanismus für Anwendungen, um asynchron auf die Fähigkeiten von indexierten Datenbanken zuzugreifen; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Ermittelt die Höhe des Inhaltsbereichs des Browserfensters einschließlich der, wenn dargestellt, horizontalen Bildlaufleiste.
Window.innerWidthSchreibgeschützt-
Ermittelt die Breite des Inhaltsbereichs des Browserfensters einschließlich der, wenn dargestellt, vertikalen Bildlaufleiste.
Window.isSecureContextSchreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob der aktuelle Kontext sicher (
true) ist oder nicht (false). Window.launchQueueSchreibgeschützt-
Wenn eine progressive Web-App (PWA) mit einem
launch_handlerclient_mode-Wert vonfocus-existing,navigate-newodernavigate-existinggestartet wird, bietet derlaunchQueueZugriff auf dieLaunchQueue-Klasse, die das Implementieren einer benutzerdefinierten Startnavigation für die PWA ermöglicht. 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 verwendet wird, um Daten zu speichern, auf die nur von der Ursprungsseite zugegriffen werden kann, die sie erstellt hat.
Window.location-
Holt oder setzt den Standort oder die aktuelle URL des Fensterobjekts.
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 Ansichtsfensters des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln gemeldet. Siehe
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel umzuwandeln. Window.mozInnerScreenYSchreibgeschützt-
Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Ansichtsfensters des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln gemeldet. Siehe
mozScreenPixelsPerCSSPixelfür einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel umzuwandeln. Window.name-
Holt oder setzt den Namen des Fensters.
-
Gibt das aktuelle, dem
windowzugeordneteNavigation-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 serialisiert zurück.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem ursprungsgebundenen Agentencluster gehört. Window.outerHeightSchreibgeschützt-
Ermittelt die Höhe außerhalb des Browserfensters.
Window.outerWidthSchreibgeschützt-
Ermittelt die Breite außerhalb 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 Element des aktuellen Fensters oder Unterfensters zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, das dietimingundnavigationAttribute beinhaltet, von denen jedes ein Objekt ist, das leistungsbezogene Daten bietet. 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 dem aktuellen Kontext zugeordnet ist. Dies ist der Einstiegspunkt für die Nutzung der Prioritized Task Scheduling API. Window.screenSchreibgeschützt-
Gibt eine Referenz auf das dem Fenster zugeordnete Bildschirmobjekt zurück.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Benutzerfensteransichtsbereichs zur linken Seite des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Benutzerfensteransichtsbereichs zur oberen Seite des Bildschirms zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das scrollbars-Objekt zurück.
Window.scrollMaxXSchreibgeschützt-
Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, also die Dokumentenbreite minus der Ansichtsbreite.
Window.scrollMaxYSchreibgeschützt-
Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumentenhöhe minus der Ansichthöhe).
Window.scrollXSchreibgeschützt-
Gibt die Anzahl der Pixel an, um die das Dokument bereits horizontal gescrollt wurde.
Window.scrollYSchreibgeschützt-
Gibt die Anzahl der Pixel an, um die das Dokument bereits vertikal gescrollt wurde.
Window.selfSchreibgeschützt-
Gibt eine Objektreferenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt eine Referenz auf das Sitzungspeicherobjekt zurück, das verwendet wird, um Daten zu speichern, auf die nur von der Ursprungsseite zugegriffen werden kann, die sie erstellt hat.
-
Gibt das
WindowSharedStorage-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt zum Schreiben von Daten in den gemeinsamen Speicher mit der Shared Storage API. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das der Einstiegspunkt für die Nutzung der Web Speech API-Sprachsynthesefunktionalität ist. 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 dem globalen Objekt zugeordnet ist, und bietet den Einstiegspunkt für die Nutzung der Trusted Types API. Window.viewportSchreibgeschützt-
Gibt eine
Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Gerätedisplays liefert. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-Objekt zurück, das das visuelle Ansichtsfenster für ein gegebenes Fenster repräsentiert. 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 Fenstereigenschaften exponiert:
- Für jedes
<embed>,<form>,<iframe>,<img>und<object>Element wird seinname(falls nicht leer) exponiert. Zum Beispiel, wenn das Dokument ein<form name="my_form">enthält, dann gibtwindow["my_form"](und sein Äquivalentwindow.my_form) eine Referenz auf dieses Element zurück. - Für jedes HTML-Element wird seine
id(falls nicht leer) exponiert.
Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird ein
HTMLCollectionzurückgegeben, das alle von ihnen enthält. Wenn eines der Elemente ein navigierbares<iframe>oder<object>ist, wird dascontentWindowdes ersten solchen iframes stattdessen zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.eventSchreibgeschützt-
Gibt das aktuelle Ereignis zurück, also das Ereignis, das derzeit vom JavaScript-Codekontext verarbeitet wird, oder
undefined, wenn derzeit kein Ereignis verarbeitet wird. Das direkt an Ereignishandler übergebeneEvent-Objekt sollte wann immer möglich anstelle dessen 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 (90-Grad-Schritten) des Ansichtsfensters relativ zur natürlichen Orientierung des Geräts zurück.
Window.status-
Holt oder setzt den Text in der Statusleiste am unteren Rand des Browsers.
Instanz-Methoden
Dieses Interface erbt Methoden vom EventTarget-Interface.
Window.atob()-
Dekodiert eine Zeichenfolge von Daten, die mit Base-64-Codierung kodiert wurde.
Window.alert()-
Zeigt ein Alarmdialogfeld an.
Window.blur()-
Setzt den Fokus vom Fenster weg.
Window.btoa()-
Erstellt eine Base-64-kodierte ASCII-Zeichenfolge aus einer Binärdaten-Zeichenfolge.
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()-
Bricht die wiederholte Ausführung ab, die mit
Window.setInterval()festgelegt wurde. Window.clearTimeout()-
Bricht die verzögerte Ausführung ab, die mit
Window.setTimeout()festgelegt wurde. Window.close()-
Schließt das aktuelle Fenster.
Window.confirm()-
Zeigt ein Dialogfeld mit einer Nachricht an, auf die der Benutzer reagieren muss.
Window.createImageBitmap()-
Akzeptiert eine Vielzahl verschiedener Bildquellen und gibt ein
Promisezurück, das sich in einImageBitmapauflöst. Optional wird die Quelle auf das Rechteck von Pixeln beschnitten, das bei (sx, sy) beginnt und eine Breite vonswund eine Höhe vonshhat. Window.dump()-
Schreibt eine Nachricht in die Konsole.
Window.fetch()-
Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.
Window.fetchLater()-
Erstellt einen aufgeschobenen Abruf, der gesendet wird, sobald die Seite verlassen wird (sie wird zerstört oder tritt in den bfcache ein), oder nach einer angegebenen
activateAfter-Zeitüberschreitung — je nachdem, was zuerst eintritt. Window.find()-
Sucht nach einer bestimmten Zeichenfolge in einem Fenster.
Window.focus()-
Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()-
Ermittelt den berechneten Stil für das angegebene Element. Der berechnete Stil gibt die berechneten Werte aller CSS-Eigenschaften des Elements an.
Window.getDefaultComputedStyle()-
Ermittelt den Standard-berechneten Stil für das angegebene Element, ohne die Stilblätter des Autors zu berücksichtigen.
Window.getScreenDetails()Sicherer Kontext-
Gibt ein
Promisezurück, das mit einemScreenDetails-Objekt erfüllt wird, das die Details aller dem Gerät des Benutzers zur Verfügung stehenden Bildschirme darstellt. Window.getSelection()-
Gibt das Auswahlelement zurück, das das/die ausgewählte(n) Element(e) darstellt.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die angegebene Medienabfrage-Zeichenfolge 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 einem anderen Fenster eine Zeichenfolge von Daten sendet, die nicht innerhalb 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 ein Eingabeaufforderungsdialog eingegebenen Text zurück.
Window.queryLocalFonts()Sicherer Kontext-
Gibt ein
Promisezurück, das mit einem Array vonFontData-Objekten erfüllt wird, die die lokal verfügbaren Schriftart-Gesichter darstellen. Window.queueMicrotask()-
Stellt eine Mikrotask zur Ausführung zu einer sicheren Zeit bereit, bevor die Kontrolle an die Ereignisschleife des Browsers zurückgegeben wird.
Window.reportError()-
Meldet einen Fehler in einem Skript, indem es eine unbehandelte Ausnahme simuliert.
Window.requestAnimationFrame()-
Teilt dem Browser mit, dass eine Animation in Bearbeitung ist, und fordert an, dass der Browser das Fenster für den nächsten Animationsframe neu zeichnet.
Window.requestIdleCallback()-
Ermöglicht das Planen von Aufgaben während der Leerlaufzeiten 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 zu einer bestimmten Position 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 die Ausführung einer Funktion jedes Mal, wenn eine bestimmte Anzahl von Millisekunden verstreicht.
Window.setTimeout()-
Plant die Ausführung einer Funktion nach einem bestimmten Zeitraum.
Window.showDirectoryPicker()Sicherer Kontext-
Zeigt einen Verzeichnisauswahlbereich an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der es einem Benutzer ermöglicht, eine oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der es einem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()-
Passt die Fenstergröße gemäß seinem Inhalt an.
Window.stop()-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()-
Erstellt eine tiefe Kopie eines gegebenen Werts unter Verwendung des strukturierten Klonalgorithmus.
Veraltete Methoden
Window.captureEvents()-
Registriert das Fenster, um alle Ereignisse eines bestimmten Typs zu erfassen.
Window.clearImmediate()-
Bricht die wiederholte Ausführung ab, die mit
setImmediate()festgelegt wurde. Window.releaseEvents()-
Löst das Fenster von der Erfassung von Ereignissen eines bestimmten Typs.
Window.requestFileSystem()-
Ermöglicht es einer Website oder App, Zugriff auf ein in einem Sandkasten befindliches Dateisystem für seinen eigenen Gebrauch zu erhalten.
Window.setImmediate()-
Führt eine Funktion aus, nachdem der Browser mit anderen schweren Aufgaben fertig ist.
Window.setResizable()-
Macht nichts (no-op). Wird zur Aufrechterhaltung der Rückwärtskompatibilität mit Netscape 4.x beibehalten.
Window.webkitConvertPointFromNodeToPage()-
Transformiert einen
WebKitPointaus dem Koordinatensystem des Knotens in das Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()-
Transformiert einen
WebKitPointaus dem Koordinatensystem der Seite in das Koordinatensystem des Knotens.
Veranstaltungen
Hören Sie diese Ereignisse mithilfe von addEventListener() oder durch Zuordnen eines Ereignislisteners zur oneventname-Eigenschaft dieser Schnittstelle. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom im Fensterobjekt enthaltenen Document heraufblasen.
error-
Wird ausgelöst, wenn eine Ressource nicht geladen werden konnte oder nicht verwendet werden kann. Zum Beispiel, wenn ein Skript einen Ausführungsfehler hat oder ein Bild nicht gefunden oder ungültig ist.
languagechange-
Wird am globalen Bereichsobjekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize-
Wird ausgelöst, wenn das Fenster neu dimensioniert wurde.
storage-
Wird ausgelöst, wenn ein Speicherbereich (
localStorageodersessionStorage) im Kontext eines anderen Dokuments geändert wurde.
Verbindungsevents
Ereignisse der Geräteausrichtung
devicemotionSicherer Kontext-
Wird in regelmäßigen Intervallen ausgelöst, was die Menge der physischen Beschleunigungskraft angibt, die das Gerät empfängt, und die Rotationsrate, falls verfügbar.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometerausrichtungssensor über die aktuelle Ausrichtung des Geräts im Vergleich zum Erdenkoordinatensystem verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometerausrichtungssensor über die absolute Ausrichtung des Geräts im Vergleich zum Erdenkoordinatensystem verfügbar sind.
Fokusevents
Gamepad-Ereignisse
gamepadconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder das erste Mal ein Button/Achse des Gamepads verwendet wird.
gamepaddisconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlauf-Ereignisse
hashchange-
Wird ausgelöst, wenn sich der Fragment-Bezeichner der URL geändert hat (der Teil der URL, der mit dem
#-Symbol beginnt und ihm folgt). pagehide-
Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während er dabei ist, ein anderes Dokument aus dem Verlauf der Sitzung an seiner Stelle anzuzeigen. Dies geschieht z.B., wenn der Benutzer auf die Zurück-Schaltfläche klickt oder wenn er auf die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf voranzukommen.
pagereveal-
Wird ausgelöst, wenn ein Dokument zum ersten Mal gerendert wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder beim Aktivieren eines Dokuments (entweder aus dem back/forward cache (bfcache) oder durch 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 der Benutzer navigiert zurück zur Seite, nachdem er zu einer anderen innerhalb derselben Registerkarte gegangen ist.
pageswap-
Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation entladen werden soll.
popstate-
Wird ausgelöst, wenn sich der aktive Verlaufseintrag ändert.
Lade- & Entlade-Events
beforeunload-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen gerade entladen werden.
load-
Wird ausgelöst, wenn die gesamte Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bildern.
unload-
Wird ausgelöst, wenn das Dokument oder eine Kindressource 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 gerade aufgefordert wird, eine Webanwendung zu installieren.
Nachrichten-Ereignisse
message-
Wird ausgelöst, wenn das Fenster eine Nachricht empfängt, z.B. von einem Aufruf an
Window.postMessage()aus einem anderen Browsing-Kontext. messageerror-
Wird ausgelöst, wenn ein
Window-Objekt eine Nachricht erhält, die nicht deserialisiert werden kann.
Druck-Ereignisse
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 angezeigt werden soll.
Promise-Abweisungsereignisse
rejectionhandled-
Wird jedes Mal gesendet, wenn ein JavaScript
Promiseabgelehnt wird, unabhängig davon, ob ein Behandler vorhanden ist, der die Ablehnung einfängt oder nicht. unhandledrejection-
Wird gesendet, wenn ein JavaScript
Promiseabgelehnt wird, es jedoch keinen Behandler gibt, der die Ablehnung einfängt.
Scroll-Ereignisse
scrollsnapchange-
Wird am Scroll-Container am Ende eines Scrollvorgangs ausgelöst, wenn ein neuer Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging-
Wird am Scroll-Container ausgelöst, wenn der Browser feststellt, dass ein neuer Scroll-Snap-Ziel bevorsteht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.
Veraltete Ereignisse
orientationchange-
Wird ausgelöst, wenn sich die Ausrichtung des Geräts geändert hat.
vrdisplayactivate-
Wird ausgelöst, wenn ein Display präsentiert werden kann.
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 präsentiert werden kann.
vrdisplaypresentchange-
Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert — d.h. vom Präsentieren zu Nicht-Präsentieren oder umgekehrt.
Bubblende Ereignisse
Nicht alle Ereignisse, die blubbern, können das Window-Objekt erreichen. Nur die folgenden tun dies und können am Window-Objekt abgehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Hören auf Ereignisse auf Window
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu hören:
- Fügen Sie dem Element einen Ereignislistener hinzu, indem Sie die Methode
EventTarget.addEventListenerverwenden. - Weisen Sie dem
oneventname-Eigenschaft des Elements einen Ereignishandler in JavaScript zu. - Fügen Sie dem Element im HTML ein mit "on" vorausgehendes Attribut hinzu.
Um auf 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 bestimmte 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 die zweite oder dritte Methode verwendet wird. Diese Ereignisse sind:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
Das bedeutet, dass das Folgende streng gleichwertig ist:
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
| Spezifikation |
|---|
| HTML> # the-window-object> |