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 zeigt auf das DOM-Dokument, das in diesem Fenster geladen ist.
Ein Fenster für ein bestimmtes Dokument kann mithilfe der document.defaultView-Eigenschaft abgerufen werden.
Eine globale Variable, window, die das Fenster repräsentiert, in dem das Skript ausgeführt wird, ist im JavaScript-Code verfügbar.
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 einzuschließen, die global verfügbar sein müssen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem Tab-Browser wird jedes Tab durch ein eigenes Window-Objekt repräsentiert; das globale window, das im JavaScript-Code innerhalb eines bestimmten Tabs sichtbar ist, repräsentiert immer das Tab, in dem der Code ausgeführt wird. Das gesagt, selbst in einem Tab-Browser gelten einige Eigenschaften und Methoden immer noch für das gesamte Fenster, das das Tab enthält, wie resizeTo() und innerHeight. Generell gilt, dass alles, was nicht vernünftigerweise auf ein Tab zutreffen kann, auf das Fenster zutrifft.
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 verknüpft ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Ressourcen zur 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 obersten Browsing-Kontext zu erfassen, die dann 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 credentialless
<iframe>geladen wurde. Siehe IFrame credentialless für weitere Details. Window.crossOriginIsolatedSchreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob die Website in einem Zustand der Cross-Origin-Isolierung ist.
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 bereits registrierte benutzerdefinierte Elemente abzurufen. 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 Document Picture-in-Picture-Fenster für den aktuellen Dokumentenkontext zurück.
Window.fenceSchreibgeschützt-
Gibt eine
Fence-Objektinstanz für den aktuellen Dokumentenkontext zurück. Nur für Dokumente verfügbar, die innerhalb eines<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 gibt an, ob das Fenster im Vollbildmodus angezeigt wird oder nicht.
Window.historySchreibgeschützt-
Gibt eine Referenz auf das History-Objekt zurück.
Window.indexedDBSchreibgeschützt-
Bietet einen Mechanismus für Anwendungen, um asynchron auf Funktionen von indizierten Datenbanken zuzugreifen; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Ermittelt die Höhe des Inhaltsbereichs des Browserfensters einschließlich der horizontalen Bildlaufleiste, falls gerendert.
Window.innerWidthSchreibgeschützt-
Ermittelt die Breite des Inhaltsbereichs des Browserfensters einschließlich der vertikalen Bildlaufleiste, falls gerendert.
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 dielaunchQueueZugriff auf dieLaunchQueue-Klasse, die es ermöglicht, eine benutzerdefinierte Startnavigationsbehandlung 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 eine Referenz auf das lokale Speicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur von der Ursprungsseite, die sie erstellt hat, zugänglich sind.
Window.location-
Ruft die Position oder die aktuelle URL des Fensterobjekts ab oder setzt diese.
Window.locationbarSchreibgeschützt-
Gibt das Locationbar-Objekt zurück.
-
Gibt das Menüleiste-Objekt zurück.
Window.mozInnerScreenXSchreibgeschützt-
Gibt die horizontale (X) Koordinate der oberen linken Ecke des Ansichtsbereichs des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln gemeldet. Siehe
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor, um bei Bedarf an Bildschirmpixel anzupassen. Window.mozInnerScreenYSchreibgeschützt-
Gibt die vertikale (Y) Koordinate der oberen linken Ecke des Ansichtsbereichs des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln gemeldet. Siehe
mozScreenPixelsPerCSSPixelfür einen Umrechnungsfaktor, um bei Bedarf an Bildschirmpixel anzupassen. Window.name-
Ruft den Namen des Fensters ab oder setzt ihn.
-
Gibt das
Navigation-Objekt zurück, das mit dem aktuellenwindowverknüpft ist. 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 String serialisiert.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem ursprungsbezogenen Agenten-Cluster gehört. Window.outerHeightSchreibgeschützt-
Ermittelt die Höhe des äußeren Teils des Browserfensters.
Window.outerWidthSchreibgeschützt-
Ermittelt die Breite des äußeren Teils des Browserfensters.
Window.pageXOffsetSchreibgeschützt-
Ein Alias für
window.scrollX. Window.pageYOffsetSchreibgeschützt-
Ein Alias für
window.scrollY. Window.parentSchreibgeschützt-
Gibt eine Referenz auf das übergeordnete Fenster des aktuellen Fensters oder Unterfensters zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, das die Attributetimingundnavigationeinschließt, von denen jedes ein Objekt ist, das leistungsbezogene Daten bereitstellt. Siehe auch Verwendung der Navigation Timing für zusätzliche Informationen und Beispiele. Window.personalbarSchreibgeschützt-
Gibt das Persönliche-Leiste-Objekt zurück.
Window.schedulerSchreibgeschützt-
Gibt das
Scheduler-Objekt zurück, das mit dem aktuellen Kontext verknüpft ist. Dies ist der Einstiegspunkt für die Verwendung der Prioritized Task Scheduling API. Window.screenSchreibgeschützt-
Gibt eine Referenz auf das Bildschirmobjekt zurück, das mit dem Fenster verknüpft ist.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Ansichtsbereichs des Benutzers zu den linken Seite des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Ansichtsbereichs des Benutzers zu oberen Seite des Bildschirms zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das Scrollleisten-Objekt zurück.
Window.scrollMaxXSchreibgeschützt-
Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, das heißt die Dokumentenbreite minus der Ansichtsbereichbreite.
Window.scrollMaxYSchreibgeschützt-
Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumentenhöhe minus der Ansichtsbereichhöhe).
Window.scrollXSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, die das Dokument bereits horizontal gescrollt wurde.
Window.scrollYSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, die das Dokument bereits vertikal gescrollt wurde.
Window.selfSchreibgeschützt-
Gibt eine Objektreferenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt eine Referenz auf das Sitzungspeicher-Objekt zurück, das verwendet wird, um Daten zu speichern, die nur von der Ursprungsseite, die sie erstellt hat, zugänglich sind.
-
Gibt das
WindowSharedStorage-Objekt für den aktuellen Ursprung zurück. Dies ist der Haupteinstiegspunkt, um Daten in gemeinsamen Speicher zu schreiben mithilfe der Shared Storage API. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das der Einstiegspunkt in die Verwendung der Web Speech API Sprachsynthesefunktionalität ist. Window.statusbarSchreibgeschützt-
Gibt das Statusleisten-Objekt zurück.
Window.toolbarSchreibgeschützt-
Gibt das Werkzeugleisten-Objekt zurück.
Window.topSchreibgeschützt-
Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.
Window.trustedTypesSchreibgeschützt-
Gibt das
TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verknüpft ist und den Einstiegspunkt für die Verwendung der Trusted Types API bietet. Window.viewportSchreibgeschützt-
Gibt eine
Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Ansichtsbereichs des Geräts bereitstellt. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-Objekt zurück, das den visuellen Ansichtsbereich für ein bestimmtes 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. Weitere Details finden Sie unterWindow.frames. - Benannte Eigenschaften
-
Einige Elemente im Dokument werden auch als Fenstereigenschaften dargestellt:
- Für jedes
<embed>,<form>,<iframe>,<img>, und<object>-Element wird seinname(falls nicht leer) dargestellt. Zum Beispiel, wenn das Dokument<form name="my_form">enthält, dann gebenwindow["my_form"](und sein Äquivalentwindow.my_form) eine Referenz auf dieses Element zurück. - Für jedes HTML-Element wird sein
id(falls nicht leer) dargestellt.
Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, dann wird eine
HTMLCollectionzurückgegeben, die alle enthält. Wenn eines der Elemente ein navigierbares<iframe>oder<object>ist, dann wird stattdessen diecontentWindowdes ersten solcher iframes zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.eventSchreibgeschützt-
Gibt das aktuelle Ereignis zurück, das momentan im Kontext des JavaScript-Codes behandelt wird, oder
undefined, wenn momentan kein Ereignis behandelt wird. DasEvent-Objekt, das direkt an Ereignis-Handler übergeben wird, sollte stattdessen wann immer möglich verwendet werden. Window.externalSchreibgeschützt-
Gibt ein Objekt zurück, das Funktionen zum Hinzufügen externer Suchanbieter zum Browser enthält.
Window.orientationSchreibgeschützt-
Gibt die Ausrichtung in Grad (in 90-Grad-Schritten) des Ansichtsbereichs relativ zur natürlichen Ausrichtung des Geräts zurück.
Window.status-
Ruft den Text in der Statusleiste am unteren Rand des Browsers ab oder setzt ihn.
Instanzmethoden
Diese Schnittstelle erbt Methoden von der EventTarget-Schnittstelle.
Window.atob()-
Dekodiert einen Datenstring, der mit Base-64-Codierung codiert wurde.
Window.alert()-
Zeigt ein Warnungsdialogfenster an.
Window.blur()-
Entzieht dem Fenster den Fokus.
Window.btoa()-
Erstellt einen Base-64-codierten ASCII-String aus einem Binärdatenstring.
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()-
Hebt die wiederholte Ausführung auf, die mit [
Window.setInterval()]/de/docs/Web/API/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 Dialogfenster mit einer Nachricht an, auf die der Benutzer antworten muss.
Window.createImageBitmap()-
Akzeptiert verschiedene Bildquellen und gibt ein
Promisezurück, das zu einemImageBitmapaufgelöst wird. Optional wird die Quelle auf das Rechteck von Pixeln beschnitten, das an (sx, sy) beginnt, mit einer Breite von sw und einer Höhe von sh. 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 dem bfcache bei), oder nach einem bereitgestellten
activateAfterTimeout – je nachdem, was zuerst auftritt. Window.find()-
Durchsucht ein Fenster nach einem angegebenen String.
Window.focus()-
Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()-
Erfasst den berechneten Stil für das angegebene Element. Der berechnete Stil zeigt die berechneten Werte aller CSS-Eigenschaften des Elements an.
Window.getDefaultComputedStyle()-
Erfasst den Standard-berechneten Stil für das angegebene Element, unter Berücksichtigung der Autoren-Stile.
Window.getScreenDetails()Sicherer Kontext-
Gibt ein
Promisezurück, das mit einerScreenDetails-Objektinstanz erfüllt wird, die die Einzelheiten aller Bildschirme repräsentiert, die dem Gerät des Benutzers zur Verfügung stehen. Window.getSelection()-
Gibt das Auswahlobjekt zurück, das das ausgewählte Element oder die ausgewählten Elemente repräsentiert.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die angegebene Mediaabfragezeichenfolge 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 einen Datenstring an ein anderes Fenster sendet, das nicht innerhalb derselben Domäne wie das erste sein muss.
Window.print()-
Öffnet das Druckdialogfenster, um das aktuelle Dokument zu drucken.
Window.prompt()-
Gibt den vom Benutzer in ein Eingabeaufforderungsdialogfenster 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 Schriftartgesichter repräsentieren. Window.queueMicrotask()-
Setzt eine Mikrotask in die Warteschlange zur Ausführung zu einem sicheren Zeitpunkt, bevor die Kontrolle an die Ereignisschleife des Browsers zurückgegeben wird.
Window.reportError()-
Meldet einen Fehler in einem Skript und simuliert eine nicht behandelte Ausnahme.
Window.requestAnimationFrame()-
Teilt dem Browser mit, dass eine Animation in Bearbeitung ist, und fordert, dass der Browser das Fenster für den nächsten Animationsframe neu zeichnet.
Window.requestIdleCallback()-
Ermöglicht die Planung von Aufgaben während der Ruhezeiten eines Browsers.
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 zu einem bestimmten Ort 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 vergeht.
Window.setTimeout()-
Plant die Ausführung einer Funktion nach einer bestimmten Zeitspanne.
Window.showDirectoryPicker()Sicherer Kontext-
Zeigt einen Verzeichnisauswähler an, mit dem der Benutzer ein Verzeichnis auswählen kann.
Window.showOpenFilePicker()Sicherer Kontext-
Zeigt einen Dateiauswähler an, der es einem Benutzer ermöglicht, eine Datei oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()Sicherer Kontext-
Zeigt einen Dateiauswähler an, der es einem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()-
Passt die Fenstergröße an den Inhalt an.
Window.stop()-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()-
Erstellt eine tiefe Kopie eines gegebenen Werts mithilfe des structured clone algorithm.
Veraltete Methoden
Window.captureEvents()-
Registriert das Fenster zum Erfassen aller Ereignisse des angegebenen Typs.
Window.clearImmediate()-
Hebt die wiederholte Ausführung auf, die mit
setImmediate()festgelegt wurde. Window.releaseEvents()-
Löst das Fenster von der Erfassung von Ereignissen eines bestimmten Typs.
Window.requestFileSystem()-
Ermöglicht einer Website oder App den Zugriff auf ein sandkastenbasiertes Dateisystem für den eigenen Gebrauch.
Window.setImmediate()-
Führt eine Funktion aus, nachdem der Browser andere schwere Aufgaben abgeschlossen hat.
Window.setResizable()-
Macht nichts (no-op). Wird zur 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 diese Ereignisse mit addEventListener() oder durch Zuweisen eines Ereignis-Handlers zur oneventname-Eigenschaft dieser Schnittstelle. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse vom Document kommen, das im Fensterobjekt enthalten ist.
error-
Wird ausgelöst, wenn eine Ressource fehlschlägt zu laden 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 beim 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.
Verbindungsevents
Geräteausrichtungsereignisse
devicemotionSicherer Kontext-
Wird in einem regelmäßigen Intervall ausgelöst und zeigt die Menge an physikalischer Beschleunigungskraft an, die das Gerät erhält, sowie die Rotationsrate, falls verfügbar.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometerausrichtungssensor verfügbar sind, die die aktuelle Geräteausrichtung im Vergleich zum Erdkoordinatenrahmen anzeigen.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometerausrichtungssensor verfügbar sind, die die aktuelle absolute Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen anzeigen.
Fokusereignisse
Gamepad-Ereignisse
gamepadconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde, oder wenn zum ersten Mal eine Taste/Achse des Gamepads benutzt wird.
gamepaddisconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufsevents
hashchange-
Wird ausgelöst, wenn sich die Fragmentkennung der URL geändert hat (der Teil der URL, der mit
#beginnt und diesem folgt). pagehide-
Wird gesendet, wenn der Browser das aktuelle Dokument versteckt, während im Prozess des Wechsels zu einem anderen Dokument aus dem Sitzungsverlauf. Dies geschieht zum Beispiel, wenn der Benutzer auf die Zurück-Schaltfläche klickt oder wenn er auf die Vorwärts-Schaltfläche klickt, um im Sitzungsverlauf vorwärts zu gehen.
pagereveal-
Wird ausgelöst, wenn ein Dokument zum ersten Mal gerendert wird, entweder wenn ein neues Dokument aus dem Netzwerk geladen oder ein Dokument aktiviert wird (entweder aus dem back/forward cache (bfcache) oder prerender).
pageshow-
Wird gesendet, wenn der Browser das Dokument sichtbar macht aufgrund von Navigationsaufgaben, einschließlich nicht nur, wenn die Seite zum ersten Mal geladen wird, sondern auch in Situationen, wie der Benutzer kehrt zur Seite zurück, nachdem er zu einer anderen innerhalb desselben Tabs navigiert hat.
pageswap-
Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation entladen wird.
popstate-
Wird ausgelöst, wenn der aktive Verlaufseintrag wechselt.
Lade- & Entladenevents
beforeunload-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen kurz vor dem Entladen stehen.
load-
Wird ausgelöst, wenn die gesamte Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets und Bilder.
unload-
Wird ausgelöst, wenn das Dokument oder eine Kindressource entladen wird.
Manifestereignisse
appinstalled-
Wird ausgelöst, wenn der Browser eine Seite erfolgreich als Anwendung installiert hat.
beforeinstallprompt-
Wird ausgelöst, wenn ein Benutzer kurz davor steht, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichtenevents
message-
Wird ausgelöst, wenn das Fenster eine Nachricht erhält, beispielsweise von einem Aufruf von
Window.postMessage()aus einem anderen Browsing-Kontext. messageerror-
Wird ausgelöst, wenn ein
Window-Objekt eine Nachricht erhält, die nicht deserialisiert werden kann.
Druckevents
afterprint-
Wird ausgelöst, nachdem das zugehörige Dokument begonnen hat zu drucken oder die Druckvorschau geschlossen wurde.
beforeprint-
Wird ausgelöst, wenn das zugehörige Dokument kurz davor ist, gedruckt oder für das Drucken in der Vorschau angezeigt zu werden.
Promise-Ablehnungsevents
rejectionhandled-
Wird jedes Mal gesendet, wenn ein JavaScript
Promiseabgelehnt wird, unabhängig davon, ob es einen Handler gibt, um die Ablehnung zu behandeln oder nicht. unhandledrejection-
Wird gesendet, wenn ein JavaScript
Promiseabgelehnt wird, aber es keinen Handler gibt, der die Ablehnung auffängt.
Scrollevents
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 ein neues Scroll-Snap-Ziel feststellt, das, d.h. ausgewählt wird, 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 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äsentationszustand eines VR-Geräts ändert – also von präsentieren zu nicht präsentieren oder umgekehrt.
Blasende Ereignisse
Nicht alle blasen-fähigen Ereignisse können das Window-Objekt erreichen. Nur die folgenden können und können auf dem Window-Objekt gehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Ereignisse auf Window hören
HTML-Elemente haben drei Möglichkeiten, Ereignisse zu hören:
- Fügen Sie dem Element einen Ereignis-Listener hinzu, indem Sie die Methode
EventTarget.addEventListenerverwenden. - Weisen Sie dem
oneventname-Eigenschaft des Elements in JavaScript einen Ereignis-Handler zu. - Fügen Sie dem Element im HTML ein mit
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 spezifische 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 Sie die zweite oder dritte Methode verwenden. 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 protokolliert.
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-window-object> |