Window
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
* Some parts of this feature may have varying levels of support.
Das Window-Interface repräsentiert ein Fenster, das ein DOM-Dokument enthält; die document-Eigenschaft zeigt auf das im Fenster geladene DOM-Dokument.
Ein Fenster für ein bestimmtes Dokument kann mit der document.defaultView Eigenschaft abgerufen werden.
Eine globale Variable, window, die das Fenster repräsentiert, in dem das Skript ausgeführt wird, steht dem JavaScript-Code zur Verfügung.
Das Window-Interface beherbergt eine Vielzahl von Funktionen, Namensräumen, Objekten und Konstruktoren, die nicht unbedingt direkt mit dem Konzept eines Benutzeroberflächenfensters in Verbindung stehen. Das Window-Interface ist jedoch ein geeigneter Ort, um diese Elemente, die global verfügbar sein müssen, einzubeziehen. Viele davon sind in der JavaScript-Referenz und der DOM-Referenz dokumentiert.
In einem Browser mit Registerkarten wird jede Registerkarte durch ihr eigenes Window-Objekt dargestellt; das globale window, das JavaScript-Code innerhalb einer bestimmten Registerkarte sieht, repräsentiert immer die Registerkarte, in der der Code ausgeführt wird. Auch in einem Browser mit Registerkarten gelten einige Eigenschaften und Methoden weiterhin für das übergeordnete Fenster, das die Registerkarte enthält, wie resizeTo() und innerHeight. Im Allgemeinen bezieht sich alles, was nicht vernünftigerweise mit einer Registerkarte in Verbindung gebracht werden kann, 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 die Erstellung 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 zum
CookieStore-Objekt für den aktuellen Dokumentkontext zurück. Window.credentiallessSchreibgeschützt Experimentell-
Gibt einen Boolean zurück, der anzeigt, ob das aktuelle Dokument innerhalb eines credentialless
<iframe>geladen wurde. Weitere Details finden Sie unter IFrame Credentialless. Window.crossOriginIsolatedSchreibgeschützt-
Gibt einen Boolean-Wert zurück, der angibt, ob die Website sich in einem Cross-Origin-Isolationszustand befindet.
Window.cryptoSchreibgeschützt-
Gibt das
Crypto-Objekt zurück, das mit dem globalen Objekt verbunden 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 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 Experimentell Sicherer Kontext-
Gibt eine Referenz auf das Document Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.
Window.fenceSchreibgeschützt Experimentell-
Gibt eine
Fence-Objektinstanz für den aktuellen Dokumentkontext zurück. Nur verfügbar für Dokumente, die in ein<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.fullScreenNicht standardisiert-
Diese Eigenschaft zeigt 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 eine Möglichkeit für Anwendungen, asynchron auf Funktionen von indexierten Datenbanken zuzugreifen; gibt ein
IDBFactory-Objekt zurück. Window.innerHeightSchreibgeschützt-
Ruft die Höhe des Inhaltsbereichs des Browserfensters ab, einschließlich, sofern gerendert, der horizontalen Bildlaufleiste.
Window.innerWidthSchreibgeschützt-
Ruft die Breite des Inhaltsbereichs des Browserfensters ab, einschließlich, sofern gerendert, der vertikalen Bildlaufleiste.
Window.isSecureContextSchreibgeschützt-
Gibt einen Boolean zurück, der anzeigt, ob der aktuelle Kontext sicher (
true) oder unsicher (false) ist. Window.launchQueueSchreibgeschützt Experimentell-
Wenn eine progressive Web-App (PWA) gestartet wird, mit einem
launch_handlerclient_mode-Wert vonfocus-existing,navigate-newodernavigate-existing, bietet dielaunchQueueZugriff auf dieLaunchQueue-Klasse, die es ermöglicht, benutzerdefinierte Start-Navigationsverwaltung 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 verwendet wird, um Daten zu speichern, auf die nur von der Herkunft zugegriffen werden kann, die diese erstellt hat.
Window.location-
Ruft den Standort oder die aktuelle URL des Fensterobjekts ab oder setzt sie.
Window.locationbarSchreibgeschützt-
Gibt das Locationbar-Objekt zurück.
-
Gibt das Menubar-Objekt zurück.
Window.mozInnerScreenXSchreibgeschützt Nicht standardisiert-
Gibt die horizontale (X-)Koordinate der oberen linken Ecke des Ansichtsfensters des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixelinnsIDOMWindowUtilsfür einen Umrechnungsfaktor, um bei Bedarf in Bildschirm-Pixel zu konvertieren. Window.mozInnerScreenYSchreibgeschützt Nicht standardisiert-
Gibt die vertikale (Y-)Koordinate der oberen linken Ecke des Ansichtsfensters des Fensters in Bildschirmkoordinaten zurück. Dieser Wert wird in CSS-Pixeln angegeben. Siehe
mozScreenPixelsPerCSSPixel, um bei Bedarf in Bildschirm-Pixel zu konvertieren. Window.name-
Ruft den Namen des Fensters ab oder setzt ihn.
-
Gibt das dem aktuellen
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 origin-erschlüsselten Agenten-Cluster gehört. Window.outerHeightSchreibgeschützt-
Ruft die Höhe des Äußeren des Browserfensters ab.
Window.outerWidthSchreibgeschützt-
Ruft die Breite des Äußeren des Browserfensters ab.
Window.pageXOffsetSchreibgeschützt-
Ein Alias für
window.scrollX. Window.pageYOffsetSchreibgeschützt-
Ein Alias für
window.scrollY. Window.parentSchreibgeschützt-
Gibt eine Referenz auf das übergeordnete Fenster oder 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 Verwenden der Navigationstiming für weitere Informationen und Beispiele. Window.personalbarSchreibgeschützt-
Gibt das Personalbar-Objekt zurück.
Window.schedulerSchreibgeschützt-
Gibt das
Scheduler-Objekt zurück, das mit dem aktuellen Kontext verbunden ist. Dies ist der Einstiegspunkt zur Verwendung der Priorisierten Aufgabenplanungs-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 Browseransichtsfensters zur linken Seite des Bildschirms zurück.
Window.screenYundWindow.screenTopSchreibgeschützt-
Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Browseransichtsfensters zur oberen Seite des Bildschirms zurück.
Window.scrollbarsSchreibgeschützt-
Gibt das Scrollbars-Objekt zurück.
Window.scrollMaxXNicht standardisiert Schreibgeschützt-
Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, d.h. die Dokumentbreite minus der Ansichtsfensterbreite.
Window.scrollMaxYNicht standardisiert Schreibgeschü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 Pixel zurück, um die das Dokument bereits horizontal gescrollt wurde.
Window.scrollYSchreibgeschützt-
Gibt die Anzahl der Pixel zurück, um die das Dokument bereits vertikal gescrollt wurde.
Window.selfSchreibgeschützt-
Gibt eine Objekt-Referenz auf das Fensterobjekt selbst zurück.
Window.sessionStorage-
Gibt eine Referenz auf das Sitzungspeicherobjekt zurück, das verwendet wird, um Daten zu speichern, auf die nur von der Herkunft zugegriffen werden kann, die diese erstellt hat.
-
Gibt das
WindowSharedStorage-Objekt für die aktuelle Herkunft zurück. Dies ist der Haupteinstiegspunkt zum Schreiben von Daten in den freigegebenen Speicher mit Hilfe der Shared Storage API. Window.speechSynthesisSchreibgeschützt-
Gibt ein
SpeechSynthesis-Objekt zurück, das den Einstiegspunkt zur Nutzung der Sprachsynthesefunktionalität der Web Speech API darstellt. Window.statusbarSchreibgeschützt-
Gibt das Statusbar-Objekt zurück.
Window.toolbarSchreibgeschützt-
Gibt das Toolbar-Objekt zurück.
Window.topSchreibgeschützt-
Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.
Window.trustedTypesSchreibgeschützt-
Gibt das
TrustedTypePolicyFactory-Objekt zurück, das mit dem globalen Objekt verbunden ist und den Einstiegspunkt zur Nutzung der Trusted Types API bereitstellt. Window.viewportExperimentell Schreibgeschützt-
Gibt eine
Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Geräteansichtsfensters bietet. Window.visualViewportSchreibgeschützt-
Gibt ein
VisualViewport-Objekt zurück, das das visuelle Ansichtsfenster 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 Rahmenelementen zurück. Weitere Details finden Sie unterWindow.frames. - Benannte Eigenschaften
-
Einige Elemente im Dokument werden auch als Fenster-Eigenschaften verfügbar gemacht:
- Für jedes
<embed>,<form>,<iframe>,<img>und<object>-Element wird seinname(falls nicht leer) verfügbar gemacht. Zum Beispiel, wenn das Dokument<form name="my_form">enthält, dann gibtwindow["my_form"](und das äquivalentewindow.my_form) eine Referenz auf dieses Element zurück. - Für jedes HTML-Element wird seine
id(falls nicht leer) verfügbar gemacht.
Wenn eine Eigenschaft einem einzelnen Element entspricht, wird das Element direkt zurückgegeben. Wenn die Eigenschaft mehreren Elementen entspricht, wird stattdessen ein
HTMLCollectionzurückgegeben, das alle enthält. Wenn eines der Elemente ein navigierbarer<iframe>oder<object>ist, wird stattdessen dascontentWindowdes ersten derartigen iframe zurückgegeben. - Für jedes
Veraltete Eigenschaften
Window.eventVeraltet Schreibgeschützt-
Gibt das derzeitige Ereignis zurück, welches das aktuell vom JavaScript-Code kontextuell verarbeitete Ereignis ist, oder
undefined, wenn kein Ereignis derzeit verarbeitet wird. Das direkt an Event-Handler übergebeneEvent-Objekt sollte wann immer möglich stattdessen verwendet werden. Window.externalVeraltet Schreibgeschützt-
Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter zum Browser hinzuzufügen.
Window.orientationVeraltet Schreibgeschützt-
Gibt die Orientierung in Grad (in 90-Grad-Schritten) der Ansichtsfenster relativ zur natürlichen Orientierung des Geräts zurück.
Window.statusVeraltet-
Ruft den Text in der Statusleiste am unteren Rand des Browsers ab oder setzt ihn.
Instanzmethoden
Dieses Interface erbt Methoden vom EventTarget-Interface.
Window.atob()-
Dekodiert eine Zeichenkette, die mit base-64-Codierung codiert wurde.
Window.alert()-
Zeigt ein Warnungsdialogfeld an.
Window.blur()Veraltet-
Entfernt den Fokus vom Fenster.
Window.btoa()-
Erstellt eine base-64-codierte ASCII-Zeichenkette aus einer Zeichenkette binärer Daten.
Window.cancelAnimationFrame()-
Ermöglicht das Abbrechen eines vorher mit
Window.requestAnimationFramegeplanten Rückrufs. Window.cancelIdleCallback()-
Ermöglicht das Abbrechen eines vorher 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 von Bildquellen und gibt ein
Promisezurück, das zu einemImageBitmapaufgelöst wird. Optional wird die Quelle auf das Rechteck der Pixel beschnitten, das bei (sx, sy) mit der Breite sw und Höhe sh beginnt. Window.dump()Nicht standardisiert-
Schreibt eine Nachricht in die Konsole.
Window.fetch()-
Startet den Prozess des Abrufens einer Ressource aus dem Netzwerk.
Window.fetchLater()Experimentell-
Erstellt einen verzögerten Abruf, der gesendet wird, sobald die Seite verlassen wird (sie wird zerstört oder geht in den bfcache), oder nach einem bereitgestellten
activateAfter-Zeitlimit – je nachdem, was zuerst eintritt. Window.find()Nicht standardisiert-
Sucht nach einer bestimmten Zeichenkette in einem Fenster.
Window.focus()-
Setzt den Fokus auf das aktuelle Fenster.
Window.getComputedStyle()-
Ruft den berechneten Stil für das angegebene Element ab. Der berechnete Stil zeigt die berechneten Werte aller CSS-Eigenschaften des Elements.
Window.getDefaultComputedStyle()Nicht standardisiert-
Ruft den Standard-berechneten Stil für das angegebene Element ab, wobei Autoren-Stylesheets ignoriert werden.
Window.getScreenDetails()Experimentell Sicherer Kontext-
Gibt ein
Promisezurück, das mit einerScreenDetails-Objektinstanz aufgelöst wird, welche die Details aller Bildschirme darstellt, die dem Gerät des Benutzers verfügbar sind. Window.getSelection()-
Gibt das Auswahlobjekt zurück, das das/die ausgewählte(n) Element(e) darstellt.
Window.matchMedia()-
Gibt ein
MediaQueryList-Objekt zurück, das die angegebene Media-Query-Zeichenkette repräsentiert. Window.moveBy()-
Verschiebt das aktuelle Fenster um eine bestimmte Menge.
Window.moveTo()-
Verschiebt das Fenster zu den angegebenen Koordinaten.
Window.open()-
Öffnet ein neues Fenster.
Window.postMessage()-
Bietet eine sichere Methode, mit der ein Fenster eine Zeichenkette von Daten zu einem anderen Fenster senden kann, das nicht innerhalb derselben Domäne wie das erste liegen muss.
Window.print()-
Öffnet das Druckdialogfeld, um das aktuelle Dokument zu drucken.
Window.prompt()-
Gibt den im Eingabeaufforderungsdialog eingegebenen Text des Benutzers zurück.
Window.queryLocalFonts()Experimentell Sicherer Kontext-
Gibt ein
Promisezurück, das mit einem Array vonFontData-Objekten aufgelöst wird, welche die lokal verfügbaren Schriftartgesichter darstellen. Window.queueMicrotask()-
Wartet eine Mikrotask auf, die zu einem sicheren Zeitpunkt vor der Rückkehr der Kontrolle zur Ereignisschleife des Browsers ausgeführt werden soll.
Window.reportError()-
Meldet einen Fehler in einem Skript und emuliert eine nicht abgefangene Ausnahme.
Window.requestAnimationFrame()-
Teilt dem Browser mit, dass eine Animation im Gange ist, und fordert, dass der Browser einen Neuzeichen-Vorgang für das Fenster für den nächsten Animationsframe plant.
Window.requestIdleCallback()-
Ermöglicht die Planung von Aufgaben während der Leerlaufzeiten eines 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 einem bestimmten Ort im Dokument.
Window.scrollBy()-
Scrollt das Dokument im Fenster um den angegebenen Betrag.
Window.scrollByLines()Nicht standardisiert-
Scrollt das Dokument um die angegebene Anzahl von Zeilen.
Window.scrollByPages()Nicht standardisiert-
Scrollt das aktuelle Dokument um die angegebene Anzahl von Seiten.
Window.scrollTo()-
Scrollt zu einem bestimmten Koordinatenset im Dokument.
Window.setInterval()-
Plant die Ausführung einer Funktion jedes Mal, wenn eine bestimmte Anzahl von Millisekunden verstrichen ist.
Window.setTimeout()-
Plant die Ausführung einer Funktion nach einer bestimmten Zeit.
Window.showDirectoryPicker()Experimentell Sicherer Kontext-
Zeigt einen Verzeichnisauswahldialog an, der dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Window.showOpenFilePicker()Experimentell Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der dem Benutzer ermöglicht, eine Datei oder mehrere Dateien auszuwählen.
Window.showSaveFilePicker()Experimentell Sicherer Kontext-
Zeigt einen Dateiauswahldialog an, der es dem Benutzer ermöglicht, eine Datei zu speichern.
Window.sizeToContent()Nicht standardisiert-
Passt das Fenster gemäß seinem Inhalt an.
Window.stop()-
Diese Methode stoppt das Laden des Fensters.
Window.structuredClone()-
Erstellt eine tiefe Kopie eines gegebenen Werts mit dem Structured Clone Algorithmus.
Veraltete Methoden
Window.captureEvents()Veraltet-
Registriert das Fenster, um alle Ereignisse des angegebenen Typs zu erfassen.
Window.clearImmediate()Nicht standardisiert Veraltet-
Bricht die wiederholte Ausführung ab, die mit
setImmediate()festgelegt wurde. Window.releaseEvents()Veraltet-
Hebt die Verhinderung des Fensters von Ereignissen eines bestimmten Typs auf.
Window.requestFileSystem()Nicht standardisiert Veraltet-
Ermöglicht einer Website oder App den Zugang zu einem sandboxed-Dateisystem für deren eigenen Gebrauch.
Window.setImmediate()Nicht standardisiert Veraltet-
Führt eine Funktion aus, nachdem der Browser andere aufwendige Aufgaben abgeschlossen hat.
Window.setResizable()Nicht standardisiert Veraltet-
Macht nichts (no-op). Beibehalten zur Rückwärtskompatibilität mit Netscape 4.x.
Window.webkitConvertPointFromNodeToPage()Nicht standardisiert Veraltet-
Transformiert einen
WebKitPointvom Koordinatensystem des Knotens zum Koordinatensystem der Seite. Window.webkitConvertPointFromPageToNode()Nicht standardisiert Veraltet-
Transformiert einen
WebKitPointvom Koordinatensystem der Seite zum Koordinatensystem des Knotens.
Ereignisse
Diese Ereignisse können mit addEventListener() abgehört werden oder durch Zuweisung eines Ereignis-Listeners zur oneventname-Eigenschaft dieses Interfaces. Zusätzlich zu den unten aufgeführten Ereignissen können viele Ereignisse aus dem Document im Fensterobjekt aufsteigen.
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 im globalen Geltungsbereichsobjekt 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äteausrichtungsevents
devicemotionSicherer Kontext-
Wird in regelmäßigen Abständen ausgelöst und zeigt die Menge der physikalischen Beschleunigungskräfte an, die auf das Gerät einwirken, sowie die Rotationsrate, falls verfügbar.
deviceorientationSicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Ausrichtungssensor über die aktuelle Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.
deviceorientationabsoluteSicherer Kontext-
Wird ausgelöst, wenn neue Daten vom Magnetometer-Ausrichtungssensor über die aktuelle absolute 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 angeschlossen wurde oder zum ersten Mal eine Taste/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 die Fragmentkennung der URL geändert hat (der Teil der URL, der mit dem
#-Symbol beginnt und darauf folgt). pagehide-
Wird gesendet, wenn der Browser das aktuelle Dokument ausblendet, während er dabei ist, ein anderes Dokument aus dem Sitzungsverlauf in dessen Platz anzuzeigen. Dies passiert beispielsweise, wenn der Benutzer die Zurück-Schaltfläche oder 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 beim Laden eines neuen Dokuments aus dem Netzwerk oder beim Aktivieren eines Dokuments (entweder aus dem Back/Forward Cache (bfcache) oder [Vorrender])(/de/docs/Glossary/Prerender)).
pageshow-
Wird gesendet, wenn der Browser das Dokument aufgrund von Navigationstätigkeiten sichtbar macht, einschließlich nicht nur, wenn die Seite zum ersten Mal geladen wird, sondern auch Situationen wie das Zurückkehren des Benutzers zur Seite, nachdem er zu einer anderen innerhalb derselben Registerkarte navigiert hat.
pageswap-
Wird ausgelöst, wenn ein Dokument aufgrund einer Navigation kurz davor ist, entladen zu werden.
popstate-
Wird ausgelöst, wenn sich der aktive Verlaufs-Eintrag ändert.
Lade- und Entladeere ignisse
beforeunload-
Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen kurz davor sind, entladen zu 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 Kinderressource entladen wird.
Manifestereignisse
appinstalled-
Wird ausgelöst, 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.
Messaging-Ereignisse
message-
Wird ausgelöst, wenn das Fenster eine Nachricht erhält, beispielsweise 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 kurz davor 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 Handler vorhanden ist, um die Ablehnung abzufangen oder nicht. unhandledrejection-
Wird gesendet, wenn ein JavaScript
Promiseabgelehnt wird, aber kein Handler vorhanden ist, um die Ablehnung abzufangen.
Scrolling-Ereignisse
scrollsnapchangeExperimentell-
Wird am Scroll-Container am Ende eines Scroll-Vorgangs ausgelöst, wenn ein neues Scroll-Snap-Ziel ausgewählt wurde.
scrollsnapchangingExperimentell-
Wird am Scroll-Container ausgelöst, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel aussteht, das ausgewählt wird, wenn die aktuelle Scroll-Geste endet.
Veraltete Ereignisse
orientationchangeVeraltet-
Wird ausgelöst, wenn sich die Ausrichtung des Geräts geändert hat.
vrdisplayactivateVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display präsentiert werden kann.
vrdisplayconnectVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät mit dem Computer verbunden wurde.
vrdisplaydisconnectVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein kompatibles VR-Gerät vom Computer getrennt wurde.
vrdisplaydeactivateVeraltet Nicht standardisiert-
Wird ausgelöst, wenn ein Display nicht mehr präsentiert werden kann.
vrdisplaypresentchangeVeraltet Nicht standardisiert-
Wird ausgelöst, wenn sich der Präsentationsstatus eines VR-Geräts ändert — d.h. von Präsentation zu Nicht-Präsentation oder umgekehrt.
Bubble-Ereignisse
Nicht alle Bubble-Ereignisse können das Window-Objekt erreichen. Nur die folgenden Events tun das und können auf dem Window-Objekt abgehört werden:
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Schnittstellen
Siehe DOM-Referenz.
Lauschen auf Ereignisse auf Window
HTML-Elemente haben drei Möglichkeiten, um auf Ereignisse zu lauschen:
- Fügen Sie dem Element über die
EventTarget.addEventListener-Methode einen Ereignis-Listener hinzu. - Weisen Sie einem Element-Ereignishandler in JavaScript die Eigenschaft
oneventnamezu. - Fügen Sie dem Element im HTML ein Attribut mit „on“-Präfix hinzu.
Um auf Ereignisse auf Window-Objekten zu lauschen, 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 hinzugefügt werden können, das dem Dokument des Window gehört, indem die zweite oder dritte Methode verwendet wird. Diese Ereignisse sind:
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresize{scroll}storageunhandledrejectionunload
Dies bedeutet, dass die folgenden strikt den gleichen Effekt haben:
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
| Specification |
|---|
| HTML> # the-window-object> |