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 document-Eigenschaft verweist auf das DOM-Dokument, das in diesem Fenster geladen ist.
Ein Fenster für ein bestimmtes Dokument kann über die document.defaultView-Eigenschaft abgerufen werden.
Eine globale Variable, window, die das Fenster repräsentiert, in dem das Skript ausgeführt wird, steht im JavaScript-Code zur Verfügung.
Die Window-Schnittstelle beherbergt eine Vielzahl von Funktionen, Namespaces, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Die Window-Schnittstelle ist jedoch ein geeigneter Ort, um solche Elemente aufzunehmen, die global verfügbar sein müssen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem Browser mit Registerkarten wird jede Registerkarte durch ein eigenes Window-Objekt repräsentiert; das globale window, das von JavaScript-Code in einer gegebenen Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Trotzdem gelten einige Eigenschaften und Methoden auch für das gesamte Fenster, das die Registerkarte enthält, wie z.B. resizeTo() und innerHeight. Im Allgemeinen betrifft alles, was nicht vernünftigerweise zu einer Registerkarte gehören kann, stattdessen das Fenster.
Instanzeigenschaften
Diese Schnittstelle erbt Eigenschaften von der EventTarget-Schnittstelle.
Beachten Sie, dass Eigenschaften, die Objekte sind (z.B. zum Überschreiben des Prototyps von eingebauten Elementen), in einem separaten Abschnitt unten aufgeführt sind.
Window.cachesSchreibgeschützt Sicherer Kontext-
Gibt das
CacheStorage-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Ressourcen für die Offline-Nutzung und das Erstellen benutzerdefinierter Antworten auf Anforderungen. 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 Meldeendpunkt gesendet werden, wenn ein Browser-Absturz auftritt. Window.credentiallessSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob das aktuelle Dokument in einem anmeldefreien
<iframe>geladen wurde. Siehe IFrame anmeldefrei für weitere Details. Window.crossOriginIsolatedSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob die Website sich in einem cross-origin Isolation-Zustand befindet.
Window.cryptoSchreibgeschützt-
Gibt das
Crypto-Objekt zurück, das mit dem globalen Objekt assoziiert 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 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 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 eine Referenz auf das Verlaufsobjekt zurück.
Window.indexedDBSchreibgeschützt-
Bietet einen Mechanismus für Anwendungen, um asynchron auf Funktionen von indizierten Datenbanken zuzugreifen; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Gibt die Höhe des Inhaltsbereichs des Browserfensters einschließlich, falls gerendert, der horizontalen Bildlaufleiste zurück.
Window.innerWidthSchreibgeschützt-
Gibt die Breite des Inhaltsbereichs des Browserfensters einschließlich, falls gerendert, der vertikalen Bildlaufleiste zurück.
Window.isSecureContextSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob der aktuelle Kontext sicher (
true) oder nicht (false) ist. Window.launchQueueSchreibgeschützt-
Wenn eine progressive Web-App (PWA) mit einem
launch_handlerclient_mode-Wert vonfocus-existing,navigate-newodernavigate-existinggestartet wird, bietet dielaunchQueueZugriff auf dieLaunchQueue-Klasse, die es ermöglicht, eine benutzerdefinierte Startrichtungsbehandlung für die PWA zu implementieren. Window.lengthSchreibgeschützt-
Gibt die Anzahl der Rahmen 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, die nur von der Ursprungsadresse abgerufen werden können, die es erstellt hat.
Window.location-
Holt/legt den Standort oder die aktuelle URL des Fensterobjektes 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 linken oberen Ecke des Ansichtsfensters des Fensters 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 linken oberen Ecke des Ansichtsfensters des Fensters 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-
Holt/legt den Namen des Fensters fest.
-
Gibt das aktuell
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 zurück, als Zeichenkette serialisiert.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem ursprungsbezogenen Agenten-Cluster gehört. Window.outerHeightSchreibgeschützt-
Gibt die Höhe der Außenseite des Browserfensters zurück.
Window.outerWidthSchreibgeschützt-
Gibt die Breite der Außenseite des Browserfensters zurück.
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 Unterrahmen des aktuellen Fensters zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, das dietiming- undnavigation-Attribute enthält, von denen jedes ein Objekt ist, 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 assoziiert ist. Dies ist der Einstiegspunkt für die Nutzung der Prioritized Task Scheduling API. Window.screenSchreibgeschützt-
Gibt eine Referenz auf das Bildschirmobjekt zurück, das mit dem Fenster assoziiert ist.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Ansichtsfensters des Benutzers bis zur linken Seite des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Ansichtsfensters 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, auf den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus der Ansichtsfensterbreite.
Window.scrollMaxYSchreibgeschützt-
Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus der Ansichtsfensterhöhe).
Window.scrollXSchreibgeschützt-
Gibt die Anzahl der horizontal bereits gescrollten Pixel des Dokuments zurück.
Window.scrollYSchreibgeschützt-
Gibt die Anzahl der vertikal bereits gescrollten Pixel des Dokuments zurück.
Window.selfSchreibgeschützt-
Gibt eine Objekt-Referenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt eine Referenz auf das Sitzungsspeicher-Objekt zurück, das zum Speichern von Daten verwendet wird, die nur von der Ursprungsadresse abgerufen werden können, die es 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 den Einstieg in die Nutzung der Sprachsynthese-Funktionen der Web Speech API bietet. 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 Fenster-Hierarchie zurück. Diese Eigenschaft ist nur lesbar.
Window.trustedTypesSchreibgeschützt-
Gibt das
TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt assoziiert ist und den Einstiegspunkt für die Nutzung der Trusted Types API bietet. Window.viewportSchreibgeschützt-
Gibt eine
Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Geräteansichtsfensters bereitstellt. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-Objekt zurück, das das visuelle Ansichtsfenster 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 Rahmen zurück. SieheWindow.framesfür weitere Details. - Benannte Eigenschaften
-
Einige Elemente im Dokument sind auch als Fenstereigenschaften verfügbar:
- Für jedes
<embed>,<form>,<iframe>,<img>und<object>-Element wird seinname(wenn nicht leer) exponiert. Zum Beispiel, wenn das Dokument<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 HTMLElement wird seine
id(wenn nicht leer) exponiert.
Wenn eine Eigenschaft mit einem einzelnen Element übereinstimmt, wird dieses Element direkt zurückgegeben. Wenn die Eigenschaft mit mehreren Elementen übereinstimmt, 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, das Ereignis, das derzeit vom JavaScript-Kontext der Anwendung gehandhabt wird, oder
undefined, wenn gerade kein Ereignis behandelt wird. DasEvent-Objekt, das direkt an Ereignishandler übergeben wird, sollte wann immer möglich stattdessen verwendet werden. Window.externalSchreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter zum Browser hinzuzufügen.
Window.orientationSchreibgeschützt-
Gibt die Ausrichtung in Grad (in 90-Grad-Schritten) des Viewports relativ zur natürlichen Ausrichtung des Geräts zurück.
Window.status-
Holt/legt den Text in der Statusleiste am unteren Rand des Browsers fest.
Instanzmethoden
Diese Schnittstelle erbt Methoden von der EventTarget-Schnittstelle.
Window.atob()-
Dekodiert einen Datenstring, der mit der base-64-Codierung kodiert wurde.
Window.alert()-
Zeigt ein Alarmdialogfeld an.
Window.blur()-
Entfernt den Fokus vom Fenster.
Window.btoa()-
Erstellt einen base-64-kodierten ASCII-String aus einem String aus binären Daten.
Window.cancelAnimationFrame()-
Ermöglicht es, einen zuvor mit
Window.requestAnimationFrameanberaumten Rückruf abzubrechen. Window.cancelIdleCallback()-
Ermöglicht es, einen zuvor mit
Window.requestIdleCallbackgeplanten Rückruf abzubrechen. Window.clearInterval()-
Hebt die wiederholte Ausführung auf, die mit
Window.setInterval()gesetzt wurde. Window.clearTimeout()-
Hebt die verzögerte Ausführung auf, 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 reagieren muss.
Window.createImageBitmap()-
Akzeptiert eine Vielzahl unterschiedlicher Bildquellen und gibt ein
Promisezurück, das in einemImageBitmapaufgelöst wird. Optional wird die Quelle auf das Rechteck von Pixeln beschnitten, das bei (sx, sy) mit der Breite sw und Höhe sh beginnt. Window.dump()-
Schreibt eine Nachricht in die Konsole.
Window.fetch()-
Startet den Vorgang des Abrufens einer Ressource aus dem Netzwerk.
Window.fetchLater()-
Erstellt einen zurückgestellten Abruf, der gesendet wird, sobald die Seite verlassen wird (sie wird zerstört oder geht in den bfcache) oder nach einem festgelegten
activateAfter-Timeout — je nachdem, was zuerst eintritt. Window.find()-
Sucht in einem Fenster nach einer bestimmten Zeichenfolge.
Window.focus()-
Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()-
Holt den berechneten Stil für das angegebene Element. Der berechnete Stil gibt die berechneten Werte aller CSS-Eigenschaften des Elements an.
Window.getDefaultComputedStyle()-
Holt den Standard-berechneten Stil für das angegebene Element, ignoriert dabei Autorenstile.
Window.getScreenDetails()Sicherer Kontext-
Gibt ein
Promisezurück, das mit einemScreenDetails-Objektinstanz erfüllt wird, die die Details aller Bildschirme darstellt, die dem Gerät des Benutzers zur Verfügung stehen. Window.getSelection()-
Gibt das Selectionsobjekt zurück, das die ausgewählten Elemente repräsentiert.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die angegebene Media Query-Zeichenfolge repräsentiert. Window.moveBy()-
Verschiebt das aktuelle Fenster um eine festgelegte Menge.
Window.moveTo()-
Verschiebt das Fenster zu den angegebenen Koordinaten.
Window.open()-
Öffnet ein neues Fenster.
Window.postMessage()-
Bietet eine sichere Möglichkeit für ein Fenster, einen Zeichenfolgen-Datensatz an ein anderes Fenster zu senden, das nicht in derselben Domäne wie das erste sein muss.
Window.print()-
Öffnet den Druckdialog zum Drucken des aktuellen Dokuments.
Window.prompt()-
Gibt den vom Benutzer in einem Eingabedialog 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 Schriftzeichen repräsentieren. Window.queueMicrotask()-
Wartet einen Mikroauftrag zur Ausführung zu einem sicheren Zeitpunkt, bevor die Steuerung in die Ereignisschleife des Browsers zurückkehrt, ein.
Window.reportError()-
Meldet einen Fehler in einem Skript und simuliert eine nicht behandelte Ausnahme.
Window.requestAnimationFrame()-
Teilt dem Browser mit, dass eine Animation im Gange ist und fordert, dass der Browser einen Neuzeichen-Zyklus des Fensters für den nächsten Animationsrahmen ansetzt.
Window.requestIdleCallback()-
Ermöglicht die Planung von Aufgaben während der Leerlaufzeiten eines Browsers.
Window.requestResize()-
Aktualisiert die Größeninformationen, die von einem eingebetteten Dokument mit seinem einbettenden Elternteil geteilt werden, aber nur, wenn das eingebettete Dokument zugestimmt hat, seine Größeninformationen zu teilen.
Window.resizeBy()-
Ändert die Größe des aktuellen Fensters um einen bestimmten Betrag.
Window.resizeTo()-
Ändert dynamisch die Größe des Fensters.
Window.scroll()-
Scrollt das Fenster zu einem bestimmten Platz im Dokument.
Window.scrollBy()-
Scrollt das Dokument im Fenster um die angegebene Menge.
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 Koordinatensatz im Dokument.
Window.setInterval()-
Plant die Ausführung einer Funktion jedes Mal, wenn eine bestimmte Anzahl von Millisekunden vergangen ist.
Window.setTimeout()-
Plant die Ausführung einer Funktion in einer bestimmten Zeit.
Window.showDirectoryPicker()Sicherer Kontext-
Zeigt ein Verzeichnis-Auswahlfeld an, das es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()Sicherer Kontext-
Zeigt ein Dateiauswahlfeld an, mit dem ein Benutzer eine oder mehrere Dateien auswählen kann.
Window.showSaveFilePicker()Sicherer Kontext-
Zeigt ein Dateiauswahlfeld an, das es einem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()-
Dimensioniert das Fenster entsprechend seinem Inhalt.
Window.stop()-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()-
Erstellt eine tiefe Kopie eines gegebenen Wertes unter Verwendung des strukturierten Kopier-Algorithmus.
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()-
Hebt die Erfassung von bestimmten Ereignistypen durch das Fenster auf.
Window.requestFileSystem()-
Ermöglicht einer Website oder App den Zugriff auf ein sandboxed Dateisystem für den eigenen Gebrauch.
Window.setImmediate()-
Führt eine Funktion aus, nachdem der Browser andere intensive Aufgaben abgeschlossen hat.
Window.setResizable()-
Macht nichts (kein Effekt). Beibehalten zur Rückwärtskompatibilität mit Netscape 4.x.
Window.webkitConvertPointFromNodeToPage()-
Transformiert einen
WebKitPointvom Koordinatensystem des Knotens in das Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()-
Transformiert einen
WebKitPointvom Koordinatensystem der Seite in das Koordinatensystem des Knotens.
Ereignisse
Hören Sie diese Ereignisse mit addEventListener() oder durch Zuweisung eines Ereignis-Listeners zur oneventname-Eigenschaft dieser Schnittstelle. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse aus dem Document, das im Fenster-Objekt enthalten ist, durch aufsteigen.
error-
Tritt auf, wenn eine Ressource nicht geladen wurde 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 Geltungsbereich-Objekt ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.
resize-
Wird ausgelöst, wenn das Fenster in der Größe geändert wurde.
storage-
Wird ausgelöst, wenn ein Speicherbereich (
localStorageodersessionStorage) im Kontext eines anderen Dokuments geändert wurde.
Verbindungsevents
Geräteorientierungsereignisse
devicemotionSicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und zeigt die physische Beschleunigungskraft an, die das Gerät erfährt sowie die Rotationsrate, falls verfügbar.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Orientierungssensor über die aktuelle Orientierung des Geräts im Vergleich zum Erdkoordinatenrahmen vorliegen.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Orientierungssensor über die aktuelle absolute Orientierung des Geräts im Vergleich zum Erdkoordinatenrahmen vorliegen.
Fokusevents
Gamepadevents
gamepadconnected-
Tritt auf, wenn der Browser erkennt, dass ein Gamepad angeschlossen wurde oder das erste Mal eine Taste/Achse des Gamepads benutzt wird.
gamepaddisconnected-
Tritt auf, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufsevents
hashchange-
Tritt auf, wenn sich der Fragment-Identifikator der URL geändert hat (der Teil der URL, der mit dem
#-Symbol beginnt und danach folgt). pagehide-
Wird gesendet, wenn der Browser das aktuelle Dokument versteckt, während im Prozess des Wechsels, um ein anderes Dokument aus dem Sitzungsverlauf anzuzeigen. 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 voranzuschreiten.
pagereveal-
Tritt auf, wenn ein Dokument zum ersten Mal gerendert wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder beim Aktivieren eines Dokuments (entweder aus back/forward cache (bfcache) oder prerender).
pageshow-
Wird gesendet, wenn der Browser das Dokument sichtbar macht aufgrund von Navigationen, einschließlich nicht nur wenn die Seite zum ersten Mal geladen wird, sondern auch Situationen wie wenn der Benutzer zur Seite zurücknavigiert, nachdem er zu einer anderen innerhalb derselben Registerkarte navigiert hat.
pageswap-
Tritt auf, wenn ein Dokument entladen wird aufgrund einer Navigation.
popstate-
Wird gesendet, wenn sich das aktive Verlaufsobjekt ändert.
Lade- und Entladeereignisse
beforeunload-
Tritt ein, wenn das Fenster, das Dokument und seine Ressourcen entladen werden sollen.
load-
Tritt auf, wenn die gesamte Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.
unload-
Tritt ein, wenn das Dokument oder eine untergeordnete Ressource entladen wird.
Manifest-Ereignisse
appinstalled-
Tritt ein, wenn der Browser erfolgreich eine Seite als Anwendung installiert hat.
beforeinstallprompt-
Wird ausgelöst, wenn ein Benutzer kurz davor ist, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichtenereignisse
message-
Tritt auf, wenn das Fenster eine Nachricht erhält, zum Beispiel von einem Aufruf an
Window.postMessage()aus einem anderen Browsingkontext. messageerror-
Tritt auf, wenn ein
Window-Objekt eine Nachricht empfängt, die nicht deserialisiert werden kann.
Druckereignisse
afterprint-
Tritt auf, nachdem das assoziierte Dokument mit dem Drucken begonnen hat oder die Druckvorschau geschlossen wurde.
beforeprint-
Wird ausgelöst, wenn das assoziierte Dokument gedruckt oder zur Druckanzeige vorbereitet wird.
Promise-Rejection-Ereignisse
rejectionhandled-
Wird jedes Mal gesendet, wenn ein JavaScript
Promiseabgelehnt wird, unabhängig davon, ob ein Handler vorhanden ist, der die Ablehnung fängt oder nicht. unhandledrejection-
Wird gesendet, wenn ein JavaScript
Promiseabgelehnt wird, aber kein Handler vorhanden ist, der die Ablehnung fängt.
Scrollereignisse
scrollsnapchange-
Wird am Scroll-Container am Ende einer Scroll-Operation ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchanging-
Wird am Scroll-Container ausgelöst, wenn der Browser bestimmt hat, dass ein neues Scroll-Snap-Ziel anhängig ist, 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 ändert.
vrdisplayactivate-
Wird ausgelöst, wenn ein Display präsentiert werden kann.
vrdisplayconnect-
Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden 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. es wechselt von präsentierend zu nicht präsentierend oder umgekehrt.
Geblendete Ereignisse
Nicht alle Ereignisse, die blasen können, erreichen das Window-Objekt. Nur die folgenden tun dies und können am Window-Objekt gehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Ereignisse auf Fenster hören
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu hören:
- Fügen Sie dem Element einen Ereignishandler mit der Methode
EventTarget.addEventListenerhinzu. - Weisen Sie dem
oneventname-Eigentum des Elements in JavaScript einen Ereignishandler zu. - Fügen Sie dem Element im HTML ein
on-präfixiertes Attribut hinzu.
Um auf 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> (oder dem veralteten <frameset>) Element des Dokuments des Window mit der zweiten oder dritten Methoden hinzugefügt werden können. Diese Ereignisse sind:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
Das bedeutet, dass die folgenden exakt 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.
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-window-object> |