Window
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Das Window Interface repräsentiert ein Fenster, das ein DOM-Dokument enthält; die document-Eigenschaft verweist auf das DOM-Dokument, das in diesem Fenster geladen ist.
Ein Fenster für ein gegebenes Dokument kann über die Eigenschaft document.defaultView abgerufen werden.
Eine globale Variable, window, die das Fenster, in dem das Skript ausgeführt wird, repräsentiert, wird im JavaScript-Code bereitgestellt.
Das Window-Interface beherbergt eine Vielzahl von Funktionen, Namensräumen, Objekten und Konstruktoren, die nicht notwendigerweise direkt mit dem Konzept eines Benutzeroberflächenfensters verbunden sind. Das Window-Interface ist jedoch ein geeigneter Ort, um diese Elemente aufzunehmen, die global verfügbar sein müssen. Viele davon sind im JavaScript Reference und im DOM Reference dokumentiert.
In einem Browser mit Registerkarten wird jede Registerkarte durch ihr eigenes Window-Objekt repräsentiert; das globale window, das durch JavaScript-Code in einer gegebenen Registerkarte gesehen wird, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Dennoch gelten auch in einem Browser mit Registerkarten einige Eigenschaften und Methoden für das gesamte Fenster, das die Registerkarte enthält, wie resizeTo() und innerHeight. Im Allgemeinen gilt: Alles, was nicht vernünftigerweise einer Registerkarte zugeordnet werden kann, bezieht sich stattdessen auf das Fenster.
Instanzeigenschaften
Dieses Interface erbt Eigenschaften vom EventTarget-Interface.
Beachten Sie, dass Eigenschaften, die Objekte sind (z.B. zum Überschreiben des Prototyps von eingebauten Elementen), in einem separaten Abschnitt unten aufgeführt sind.
Window.cachesSchreibgeschützt Sicherer Kontext-
Gibt das
CacheStorage-Objekt zurück, das mit dem aktuellen Kontext verknüpft ist. Dieses Objekt ermöglicht Funktionen wie das Speichern von Assets für die Offline-Nutzung und das Erzeugen von benutzerdefinierten Antworten auf Anfragen. Window.clientInformationSchreibgeschützt-
Ein Alias für
Window.navigator. Window.closedSchreibgeschützt-
Diese Eigenschaft gibt 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 einemCrashReporthinzugefügt und an einen Meldepunkt gesendet werden, wenn ein Browserabsturz auftritt. Window.credentiallessSchreibgeschützt-
Gibt einen Boolean zurück, der anzeigt, ob das aktuelle Dokument innerhalb eines kreditlosen
<iframe>geladen wurde. Siehe IFrame credentialless für weitere Details. Window.crossOriginIsolatedSchreibgeschützt-
Gibt einen Boolean-Wert zurück, der anzeigt, ob die Website in einem Zustand der Cross-Origin-Isolation 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 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, das das Fenster enthält, zurück.
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 Instanz des
Fence-Objekts für den aktuellen Dokumentkontext zurück. Nur für Dokumente verfügbar, die innerhalb eines<fencedframe>eingebettet sind. Window.frameElementSchreibgeschützt-
Gibt das Element zurück, in das das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.
Window.framesSchreibgeschützt-
Gibt ein Array der Unterrahmen im aktuellen Fenster zurück.
Window.fullScreen-
Diese Eigenschaft gibt 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 asynchronen Zugriff auf Fähigkeiten von indizierten Datenbanken zu erhalten; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Liefert die Höhe des Inhaltsbereichs des Browserfensters, einschließlich der horizontalen Scrollleiste, falls gerendert.
Window.innerWidthSchreibgeschützt-
Liefert die Breite des Inhaltsbereichs des Browserfensters, einschließlich der vertikalen Scrollleiste, falls gerendert.
Window.isSecureContextSchreibgeschützt-
Gibt einen Boolean zurück, der angibt, ob der aktuelle Kontext sicher (
true) oder nicht sicher (false) ist. Window.launchQueueSchreibgeschützt-
Wenn eine progressive Web-App (PWA) mit einem
launch_handlerclient_mode-Wert vonfocus-existing,navigate-newodernavigate-existinggestartet wird, stellt dielaunchQueueZugang zurLaunchQueueKlasse, die es ermöglicht, eine benutzerdefinierte Startnavigation für die PWA zu implementieren. Window.lengthSchreibgeschützt-
Gibt die Anzahl der Frames im Fenster zurück. Siehe auch
window.frames. Window.localStorageSchreibgeschützt-
Gibt eine Referenz auf das lokale Speichersystem zurück, das verwendet wird, um Daten zu speichern, die nur von dem Ursprung, der sie erstellt hat, abgerufen werden können.
Window.location-
Ruft den Standort oder die aktuelle URL des Fensterobjekts ab/setzt ihn.
Window.locationbarSchreibgeschützt-
Gibt das Standortleistenobjekt zurück.
-
Gibt das Menüleistenobjekt 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-Pixel angegeben. Siehe
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, falls erforderlich. 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-Pixel angegeben. Siehe
mozScreenPixelsPerCSSPixelfür einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, falls erforderlich. Window.name-
Ruft den Namen des Fensters ab/setzt ihn.
-
Gibt das aktuelle
window's zugehörigeNavigation-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, serialisiert als Zeichenfolge.
Window.originAgentClusterSchreibgeschützt-
Gibt
truezurück, wenn dieses Fenster zu einem ursprungsschlüsselbasierten Agenten-Cluster gehört. Window.outerHeightSchreibgeschützt-
Ruft die Höhe des äußeren Bereichs des Browserfensters ab.
Window.outerWidthSchreibgeschützt-
Ruft die Breite des äußeren Bereichs 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 übergeordnete Fenster des aktuellen Fensters oder Unterrahmens zurück.
Window.performanceSchreibgeschützt-
Gibt ein
Performance-Objekt zurück, das dietiming- undnavigation-Attribute enthält, die jeweils ein Objekt sind, das leistungsbezogene Daten bereitstellt. Siehe auch Using Navigation Timing für zusätzliche Informationen und Beispiele. Window.personalbarSchreibgeschützt-
Gibt das Persönliche-Leistenobjekt 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 verbunden ist.
Window.screenXundWindow.screenLeftSchreibgeschützt-
Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Benutzer-Browserfensters zur linken Seite des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Benutzer-Browserfensters zur oberen Seite des Bildschirms zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das Scrollleistenobjekt zurück.
Window.scrollMaxXSchreibgeschützt-
Der maximale Offset, auf den das Fenster horizontal gescrollt werden kann, das heißt, die Dokumentbreite minus der Ansichtsfensterbreite.
Window.scrollMaxYSchreibgeschützt-
Der maximale Offset, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus der Ansichtsfensterhö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 Objekt-Referenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt eine Referenz auf das Sitzungsspeicherobjekt zurück, das verwendet wird, um Daten zu speichern, die nur von dem Ursprung, der sie erstellt hat, abgerufen werden können.
-
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 Verwendung der Web Speech API Sprachsynthesefunktionalität ist. Window.statusbarSchreibgeschützt-
Gibt das Statusleistenobjekt zurück.
Window.toolbarSchreibgeschützt-
Gibt das Werkzeugleistenobjekt 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 bietet den Einstieg in die Verwendung der Trusted Types API. Window.viewportSchreibgeschützt-
Gibt eine Instanz des
Viewport-Objekts zurück, das Informationen über den aktuellen Zustand des Geräte-Ansichtsfensters liefert. 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], 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 dargestellt:
- Für jedes
<embed>,<form>,<iframe>,<img>und<object>-Element wird dessenname(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 HTML-Element wird dessen
id(wenn nicht leer) exponiert.
Wenn eine Eigenschaft einem einzelnen Element entspricht, wird dieses Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird eine
HTMLCollectionzurückgegeben, die alle enthält. Wenn eines der Elemente ein navigierbares<iframe>oder<object>ist, dann wird dascontentWindowdes ersten solchen iframes stattdessen zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.eventSchreibgeschützt-
Gibt das aktuelle Event zurück, das aktuell von JavaScript-Code gehandhabt wird, oder
undefined, wenn derzeit kein Event gehandhabt wird. DasEvent-Objekt, das direkt an Event-Handler übergeben wird, sollte stattdessen stets verwendet werden, wenn möglich. 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 (in 90-Grad-Schritten) des Ansichtsfensters relativ zur natürlichen Orientierung des Geräts zurück.
Window.status-
Ruft den Text in der Statusleiste am unteren Rand des Browsers ab/setzt ihn.
Instanzmethoden
Dieses Interface erbt Methoden vom EventTarget-Interface.
Window.atob()-
Dekodiert einen Datenstring, der mit base-64-Codierung kodiert wurde.
Window.alert()-
Zeigt einen Warnungsdialog an.
Window.blur()-
Entfernt den Fokus vom Fenster.
Window.btoa()-
Erstellt einen base-64 kodierten ASCII-String aus einem binären Datenstring.
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()gesetzt wurde. Window.clearTimeout()-
Bricht die verzögerte Ausführung ab, 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 antworten muss.
Window.createImageBitmap()-
Akzeptiert verschiedene Bildquellen und gibt ein
Promisezurück, das auf einImageBitmapaufgelöst wird. Optional wird die Quelle auf das Rechteck der Pixel zugeschnitten, die bei (sx, sy) beginnen und eine Breite von sw und eine Höhe von sh haben. Window.dump()-
Schreibt eine Nachricht in die Konsole.
Window.fetch()-
Startet den Prozess zum Abrufen einer Ressource aus dem Netzwerk.
Window.fetchLater()-
Erstellt einen zurückgestellten Abruf, der gesendet wird, sobald die Seite navigiert wird (entweder zerstört wird oder in den bfcache eintritt), oder nach einem bereitgestellten
activateAfter-Timeout — je nachdem, was zuerst eintritt. Window.find()-
Sucht nach einem gegebenen String in einem Fenster.
Window.focus()-
Richtet den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()-
Ruft den berechneten Stil für das angegebene Element ab. Berechneter Stil gibt die berechneten Werte aller CSS-Eigenschaften des Elements an.
Window.getDefaultComputedStyle()-
Ruft den standardmäßig berechneten Stil für das angegebene Element ab und ignoriert dabei Autor-Stile.
Window.getScreenDetails()Sicherer Kontext-
Gibt ein
Promisezurück, das mit einemScreenDetails-Objekt aufgelöst wird, das die Details aller dem Gerät des Benutzers verfügbaren Bildschirme darstellt. Window.getSelection()-
Gibt das Auswahlobjekt zurück, das die ausgewählten Elemente darstellt.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die angegebene Medienabfragezeichenfolge 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 ein Datenstring an ein anderes Fenster sendet, das nicht innerhalb derselben Domäne wie das erste liegen muss.
Window.print()-
Öffnet den Druckdialog, um das aktuelle Dokument zu drucken.
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 aufgelöst wird, die die lokal verfügbaren Schriftarten darstellen. Window.queueMicrotask()-
Fügt eine Mikroaufgabe in die Warteschlange ein, die zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle zur Ereignisschleife des Browsers ausgeführt wird.
Window.reportError()-
Meldet einen Fehler in einem Skript, emuliert eine nicht behandelte Ausnahme.
Window.requestAnimationFrame()-
Teilt dem Browser mit, dass eine Animation in Bearbeitung 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 Leerlaufzeiten eines Browsers.
Window.requestResize()-
Aktualisiert die Größeninformationen eines eingebetteten Dokuments mit seinem einbettenden Elternteil, jedoch nur, wenn das eingebettete Dokument sich entschieden hat, seine Größeninformationen zu teilen.
Window.resizeBy()-
Ändert die Größe des aktuellen Fensters um einen bestimmten Betrag.
Window.resizeTo()-
Ändert die Größe des Fensters dynamisch.
Window.scroll()-
Scrolled das Fenster zu einer bestimmten Stelle im Dokument.
Window.scrollBy()-
Scrolled das Dokument im Fenster um den angegebenen Betrag.
Window.scrollByLines()-
Scrolled das Dokument um die angegebene Anzahl von Zeilen.
Window.scrollByPages()-
Scrolled das aktuelle Dokument um die angegebene Anzahl von Seiten.
Window.scrollTo()-
Scrolled zu einer bestimmten Menge von Koordinaten im Dokument.
Window.setInterval()-
Plant die Ausführung einer Funktion jedes Mal, wenn eine gegebene Anzahl von Millisekunden vergeht.
Window.setTimeout()-
Plant eine Funktion zur Ausführung in einer gegebenen Zeitspanne.
Window.showDirectoryPicker()Sicherer Kontext-
Zeigt ein Verzeichnis-Auswahlfenster an, das dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()Sicherer Kontext-
Zeigt ein Dateiauswahlfenster an, das dem Benutzer ermöglicht, eine Datei oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()Sicherer Kontext-
Zeigt ein Dateiauswahlfenster an, das dem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()-
Passt die Größe des Fensters an seinen Inhalt an.
Window.stop()-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()-
Erstellt einen tiefen Klon eines angegebenen Werts unter Verwendung des strukturierten Klonalgorithmus.
Veraltete Methoden
Window.captureEvents()-
Registriert das Fenster, um alle Events des angegebenen Typs zu erfassen.
Window.clearImmediate()-
Bricht die wiederholte Ausführung ab, die mit
setImmediate()gesetzt wurde. Window.releaseEvents()-
Gibt das Fenster frei, aus dem Ereignisse eines bestimmten Typs abgefangen werden.
Window.requestFileSystem()-
Erlaubt einer Website oder App, auf ein sandboxed Dateisystem für den eigenen Gebrauch zuzugreifen.
Window.setImmediate()-
Führt eine Funktion aus, nachdem der Browser andere schwere Aufgaben abgeschlossen hat.
Window.setResizable()-
Macht nichts (no-op). Behalten zur Rückwärtskompatibilität mit Netscape 4.x.
Window.webkitConvertPointFromNodeToPage()-
Transformiert einen
WebKitPointvom Koordinatensystem eines Knotens zum Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()-
Transformiert einen
WebKitPointvom Koordinatensystem der Seite zum Koordinatensystem eines Knotens.
Ereignisse
Hören Sie auf diese Ereignisse mit addEventListener() oder durch Zuordnung eines Ereignis-Handlers zur oneventname-Eigenschaft dieses Interfaces. Neben den unten aufgeführten Ereignissen können viele Ereignisse aus dem im Fensterobjekt enthaltenen Document blubbern.
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 werden kann oder ungültig ist.
languagechange-
Wird am globalen Gültigkeitsbereichsobjekt 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äteorientierungsereignisse
devicemotionSicherer Kontext-
Wird regelmäßig ausgelöst und gibt die Menge an physikalischer Beschleunigungskraft an, die das Gerät erhält, sowie die Rotationsrate, wenn vorhanden.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen absoluten Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
Fokusereignisse
Gamepad-Ereignisse
gamepadconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde oder das erste Mal eine Taste/Achse des Gamepads verwendet wird.
gamepaddisconnected-
Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.
Verlaufereignisse
hashchange-
Wird ausgelöst, wenn sich der Fragmentbezeichner der URL geändert hat (der Teil der URL, der mit dem
#-Symbol beginnt und folgt). pagehide-
Wird gesendet, wenn der Browser das aktuelle Dokument versteckt, während er im Prozess des Umschaltens auf die Anzeige eines anderen Dokuments aus dem Verlaufsspeicher des Sitzungsverlaufs ist. Dies passiert zum Beispiel, wenn der Benutzer auf die Zurück-Taste klickt oder wenn er auf die Vorwärts-Taste klickt, um im Sitzungsverlauf vorwärts zu springen.
pagereveal-
Wird ausgelöst, wenn ein Dokument das erste Mal gerendert wird, entweder beim Laden eines neuen Dokuments aus dem Netzwerk oder Aktivieren eines Dokuments (entweder aus dem back/forward cache (bfcache) oder prerender).
pageshow-
Wird gesendet, wenn der Browser das Dokument sichtbar macht durch Navigationsaufgaben, einschließlich nicht nur, wenn die Seite zuerst geladen wird, sondern auch Situationen, wie z.B. die Navigation des Benutzers zurück zur Seite, nachdem er zu einer anderen innerhalb derselben Registerkarte navigiert ist.
pageswap-
Wird ausgelöst, wenn ein Dokument im Begriff ist, aufgrund einer Navigation entladen zu werden.
popstate-
Wird ausgelöst, wenn sich der aktive Verlaufs-Eintrag ändert.
Lade- und Entladereignisse
beforeunload-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen im Begriff sind, entladen zu werden.
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.
Manifest-Ereignisse
appinstalled-
Wird ausgelöst, wenn der Browser eine Seite erfolgreich als Anwendung installiert hat.
beforeinstallprompt-
Wird ausgelöst, wenn ein Benutzer im Begriff ist, aufgefordert zu werden, eine Webanwendung zu installieren.
Nachrichtenereignisse
message-
Wird ausgelöst, wenn das Fenster eine Nachricht erhält, zum Beispiel durch einen 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.
Druckereignisse
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 im Begriff ist, gedruckt oder für den Druck in der Vorschau angezeigt zu werden.
Promise-Ablehnungsereignisse
rejectionhandled-
Wird jedes Mal gesendet, wenn ein JavaScript-
Promiseabgelehnt wird, unabhängig davon, ob ein Umgang damit eingerichtet ist oder nicht. unhandledrejection-
Wird gesendet, wenn ein JavaScript-
Promiseabgelehnt wird, aber kein Umgang damit eingerichtet ist.
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 feststellt, dass ein neues Scroll-Snap-Ziel ansteht, d.h. es 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 — d.h. von Präsentation zu Nicht-Präsentation oder umgekehrt wechselt.
Geblubberte Ereignisse
Nicht alle Ereignisse, die blubbern können das Window-Objekt erreichen. Nur die folgenden tun dies und können am Window-Objekt gehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM Reference.
Hören von Ereignissen auf Window
HTML-Elemente haben drei Möglichkeiten, Ereignisse zu hören:
- Fügen Sie einen Ereignis-Listener zum Element hinzu, indem Sie die Methode
EventTarget.addEventListenerverwenden. - Weisen Sie einen Ereignis-Handler der
oneventname-Eigenschaft des Elements in JavaScript zu. - Fügen Sie ein Attribut mit Präfix
ondem Element in HTML hinzu.
Um auf Ereignisse in Window-Objekten zu hören, können Sie im Allgemeinen nur die ersten beiden Methoden verwenden, da Window kein entsprechendes HTML-Element besitzt. Es gibt jedoch eine spezielle Gruppe von Ereignissen, deren Zuhörer zum <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, dass das Window-Objekt als currentTarget protokolliert wird.
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-window-object> |