Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

EventTarget Window

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.caches Schreibgeschü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.clientInformation Schreibgeschützt

Ein Alias für Window.navigator.

Window.closed Schreibgeschützt

Diese Eigenschaft gibt an, ob das aktuelle Fenster geschlossen ist oder nicht.

Window.cookieStore Schreibgeschützt Sicherer Kontext

Gibt eine Referenz auf das CookieStore-Objekt für den aktuellen Dokumentkontext zurück.

Window.crashReport Schreibgeschü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 einem CrashReport hinzugefügt und an einen Meldepunkt gesendet werden, wenn ein Browserabsturz auftritt.

Window.credentialless Schreibgeschü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.crossOriginIsolated Schreibgeschützt

Gibt einen Boolean-Wert zurück, der anzeigt, ob die Website in einem Zustand der Cross-Origin-Isolation ist.

Window.crypto Schreibgeschützt

Gibt das Crypto-Objekt zurück, das mit dem globalen Objekt verknüpft ist.

Window.customElements Schreibgeschü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.devicePixelRatio Schreibgeschützt

Gibt das Verhältnis zwischen physischen Pixeln und geräteunabhängigen Pixeln im aktuellen Display zurück.

Window.document Schreibgeschützt

Gibt eine Referenz auf das Dokument, das das Fenster enthält, zurück.

Window.documentPictureInPicture Schreibgeschützt Sicherer Kontext

Gibt eine Referenz auf das Document Picture-in-Picture-Fenster für den aktuellen Dokumentkontext zurück.

Window.fence Schreibgeschü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.frameElement Schreibgeschützt

Gibt das Element zurück, in das das Fenster eingebettet ist, oder null, wenn das Fenster nicht eingebettet ist.

Window.frames Schreibgeschü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.history Schreibgeschützt

Gibt eine Referenz auf das Verlauf-Objekt zurück.

Window.indexedDB Schreibgeschü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.innerHeight Schreibgeschützt

Liefert die Höhe des Inhaltsbereichs des Browserfensters, einschließlich der horizontalen Scrollleiste, falls gerendert.

Window.innerWidth Schreibgeschützt

Liefert die Breite des Inhaltsbereichs des Browserfensters, einschließlich der vertikalen Scrollleiste, falls gerendert.

Window.isSecureContext Schreibgeschützt

Gibt einen Boolean zurück, der angibt, ob der aktuelle Kontext sicher (true) oder nicht sicher (false) ist.

Window.launchQueue Schreibgeschützt

Wenn eine progressive Web-App (PWA) mit einem launch_handler client_mode-Wert von focus-existing, navigate-new oder navigate-existing gestartet wird, stellt die launchQueue Zugang zur LaunchQueue Klasse, die es ermöglicht, eine benutzerdefinierte Startnavigation für die PWA zu implementieren.

Window.length Schreibgeschützt

Gibt die Anzahl der Frames im Fenster zurück. Siehe auch window.frames.

Window.localStorage Schreibgeschü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.locationbar Schreibgeschützt

Gibt das Standortleistenobjekt zurück.

Window.menubar Schreibgeschützt

Gibt das Menüleistenobjekt zurück.

Window.mozInnerScreenX Schreibgeschü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 mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, falls erforderlich.

Window.mozInnerScreenY Schreibgeschü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 mozScreenPixelsPerCSSPixel für einen Umrechnungsfaktor zur Anpassung an Bildschirmpixel, falls erforderlich.

Window.name

Ruft den Namen des Fensters ab/setzt ihn.

Window.navigation Schreibgeschützt

Gibt das aktuelle window's zugehörige Navigation-Objekt zurück. Der Einstiegspunkt für die Navigation API.

Window.navigator Schreibgeschützt

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.origin Schreibgeschützt

Gibt den Ursprung des globalen Objekts zurück, serialisiert als Zeichenfolge.

Window.originAgentCluster Schreibgeschützt

Gibt true zurück, wenn dieses Fenster zu einem ursprungsschlüsselbasierten Agenten-Cluster gehört.

Window.outerHeight Schreibgeschützt

Ruft die Höhe des äußeren Bereichs des Browserfensters ab.

Window.outerWidth Schreibgeschützt

Ruft die Breite des äußeren Bereichs des Browserfensters ab.

Window.pageXOffset Schreibgeschützt

Ein Alias für window.scrollX.

Window.pageYOffset Schreibgeschützt

Ein Alias für window.scrollY.

Window.parent Schreibgeschützt

Gibt eine Referenz auf das übergeordnete Fenster des aktuellen Fensters oder Unterrahmens zurück.

Window.performance Schreibgeschützt

Gibt ein Performance-Objekt zurück, das die timing- und navigation-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.personalbar Schreibgeschützt

Gibt das Persönliche-Leistenobjekt zurück.

Window.scheduler Schreibgeschü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.screen Schreibgeschützt

Gibt eine Referenz auf das Bildschirmobjekt zurück, das mit dem Fenster verbunden ist.

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben den horizontalen Abstand vom linken Rand des Benutzer-Browserfensters zur linken Seite des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben den vertikalen Abstand vom oberen Rand des Benutzer-Browserfensters zur oberen Seite des Bildschirms zurück.

Window.scrollbars Schreibgeschützt

Gibt das Scrollleistenobjekt zurück.

Window.scrollMaxX Schreibgeschützt

Der maximale Offset, auf den das Fenster horizontal gescrollt werden kann, das heißt, die Dokumentbreite minus der Ansichtsfensterbreite.

Window.scrollMaxY Schreibgeschützt

Der maximale Offset, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumenthöhe minus der Ansichtsfensterhöhe).

Window.scrollX Schreibgeschützt

Gibt die Anzahl der Pixel zurück, die das Dokument bereits horizontal gescrollt wurde.

Window.scrollY Schreibgeschützt

Gibt die Anzahl der Pixel zurück, die das Dokument bereits vertikal gescrollt wurde.

Window.self Schreibgeschü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.

Window.sharedStorage Schreibgeschützt Sicherer Kontext

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.speechSynthesis Schreibgeschützt

Gibt ein SpeechSynthesis-Objekt zurück, das der Einstiegspunkt für die Verwendung der Web Speech API Sprachsynthesefunktionalität ist.

Window.statusbar Schreibgeschützt

Gibt das Statusleistenobjekt zurück.

Window.toolbar Schreibgeschützt

Gibt das Werkzeugleistenobjekt zurück.

Window.top Schreibgeschützt

Gibt eine Referenz auf das oberste Fenster in der Fensterhierarchie zurück. Diese Eigenschaft ist schreibgeschützt.

Window.trustedTypes Schreibgeschü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.viewport Schreibgeschützt

Gibt eine Instanz des Viewport-Objekts zurück, das Informationen über den aktuellen Zustand des Geräte-Ansichtsfensters liefert.

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport-Objekt zurück, das das visuelle Ansichtsfenster für ein gegebenes Fenster darstellt.

Window.window Schreibgeschü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. Siehe Window.frames fü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 dessen name (wenn nicht leer) exponiert. Zum Beispiel, wenn das Dokument <form name="my_form"> enthält, dann gibt window["my_form"] (und sein Äquivalent window.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 HTMLCollection zurückgegeben, die alle enthält. Wenn eines der Elemente ein navigierbares <iframe> oder <object> ist, dann wird das contentWindow des ersten solchen iframes stattdessen zurückgegeben.

Veraltete Eigenschaften

Window.event Schreibgeschützt

Gibt das aktuelle Event zurück, das aktuell von JavaScript-Code gehandhabt wird, oder undefined, wenn derzeit kein Event gehandhabt wird. Das Event-Objekt, das direkt an Event-Handler übergeben wird, sollte stattdessen stets verwendet werden, wenn möglich.

Window.external Schreibgeschützt

Gibt ein Objekt mit Funktionen zurück, um externe Suchanbieter zum Browser hinzuzufügen.

Window.orientation Schreibgeschü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.requestAnimationFrame geplanten Rückrufs.

Window.cancelIdleCallback()

Ermöglicht das Abbrechen eines zuvor mit Window.requestIdleCallback geplanten 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 Promise zurück, das auf ein ImageBitmap aufgelö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 Promise zurück, das mit einem ScreenDetails-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 Promise zurück, das mit einem Array von FontData-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 WebKitPoint vom Koordinatensystem eines Knotens zum Koordinatensystem der Seite.

Window.webkitConvertPointFromPageToNode()

Transformiert einen WebKitPoint vom 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 (localStorage oder sessionStorage) im Kontext eines anderen Dokuments geändert wurde.

Verbindungsevents

offline

Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk verloren hat und der Wert von navigator.onLine auf false gewechselt ist.

online

Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk gewonnen hat und der Wert von navigator.onLine auf true gewechselt ist.

Geräteorientierungsereignisse

devicemotion Sicherer 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.

deviceorientation Sicherer Kontext

Wird ausgelöst, wenn frische Daten vom Magnetometer-Orientierungssensor zur aktuellen Ausrichtung des Geräts im Vergleich zum Erdkoordinatenrahmen verfügbar sind.

deviceorientationabsolute Sicherer 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

blur

Wird ausgelöst, wenn ein Element den Fokus verloren hat.

focus

Wird ausgelöst, wenn ein Element den Fokus erlangt hat.

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-Promise abgelehnt wird, unabhängig davon, ob ein Umgang damit eingerichtet ist oder nicht.

unhandledrejection

Wird gesendet, wenn ein JavaScript-Promise abgelehnt 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:

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.addEventListener verwenden.
  • Weisen Sie einen Ereignis-Handler der oneventname-Eigenschaft des Elements in JavaScript zu.
  • Fügen Sie ein Attribut mit Präfix on dem 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:

  • afterprint
  • beforeprint
  • beforeunload
  • blur
  • error
  • focus
  • hashchange
  • languagechange
  • load
  • message
  • messageerror
  • offline
  • online
  • pagehide
  • pagereveal
  • pageshow
  • pageswap
  • popstate
  • rejectionhandled
  • resize
  • scroll
  • storage
  • unhandledrejection
  • unload

Das bedeutet, dass die folgenden strikt äquivalent sind:

js
window.onresize = (e) => console.log(e.currentTarget);
document.body.onresize = (e) => console.log(e.currentTarget);
html
<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

Browser-Kompatibilität