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.

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.

EventTarget Window

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.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 Ressourcen zur Offline-Nutzung und das Erstellen benutzerdefinierter Antworten auf Anfragen.

Window.clientInformation Schreibgeschützt

Ein Alias für Window.navigator.

Window.closed Schreibgeschützt

Diese Eigenschaft zeigt 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 Dokumentenkontext 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 zu erfassen, die dann einem CrashReport hinzugefügt und an einen Meldeendpunkt gesendet werden, wenn ein Browser-Absturz auftritt.

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

Gibt einen booleschen Wert zurück, der angibt, ob die Website in einem Zustand der Cross-Origin-Isolierung 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 abzurufen.

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 zurück, das das Fenster enthält.

Window.documentPictureInPicture Schreibgeschützt Sicherer Kontext

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

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

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

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

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

Window.indexedDB Schreibgeschützt

Bietet einen Mechanismus für Anwendungen, um asynchron auf Funktionen von indizierten Datenbanken zuzugreifen; gibt ein IDBFactory-Objekt zurück.

Window.innerHeight Schreibgeschützt

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

Window.innerWidth Schreibgeschützt

Ermittelt die Breite des Inhaltsbereichs des Browserfensters einschließlich der vertikalen Bildlaufleiste, falls gerendert.

Window.isSecureContext Schreibgeschützt

Gibt einen booleschen Wert zurück, der anzeigt, ob der aktuelle Kontext sicher (true) ist oder nicht (false).

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, bietet die launchQueue Zugriff auf die LaunchQueue-Klasse, die es ermöglicht, eine benutzerdefinierte Startnavigationsbehandlung 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 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.locationbar Schreibgeschützt

Gibt das Locationbar-Objekt zurück.

Window.menubar Schreibgeschützt

Gibt das Menüleiste-Objekt zurück.

Window.mozInnerScreenX Schreibgeschü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 mozScreenPixelsPerCSSPixel in nsIDOMWindowUtils für einen Umrechnungsfaktor, um bei Bedarf an Bildschirmpixel anzupassen.

Window.mozInnerScreenY Schreibgeschü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 mozScreenPixelsPerCSSPixel für einen Umrechnungsfaktor, um bei Bedarf an Bildschirmpixel anzupassen.

Window.name

Ruft den Namen des Fensters ab oder setzt ihn.

Window.navigation Schreibgeschützt

Gibt das Navigation-Objekt zurück, das mit dem aktuellen window verknüpft ist. 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, als String serialisiert.

Window.originAgentCluster Schreibgeschützt

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

Window.outerHeight Schreibgeschützt

Ermittelt die Höhe des äußeren Teils des Browserfensters.

Window.outerWidth Schreibgeschützt

Ermittelt die Breite des äußeren Teils des Browserfensters.

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 Unterfensters zurück.

Window.performance Schreibgeschützt

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

Gibt das Persönliche-Leiste-Objekt 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 verknüpft ist.

Window.screenX und Window.screenLeft Schreibgeschützt

Beide Eigenschaften geben die horizontale Entfernung vom linken Rand des Ansichtsbereichs des Benutzers zu den linken Seite des Bildschirms zurück.

Window.screenY und Window.screenTop Schreibgeschützt

Beide Eigenschaften geben die vertikale Entfernung vom oberen Rand des Ansichtsbereichs des Benutzers zu oberen Seite des Bildschirms zurück.

Window.scrollbars Schreibgeschützt

Gibt das Scrollleisten-Objekt zurück.

Window.scrollMaxX Schreibgeschützt

Der maximale Versatz, auf den das Fenster horizontal gescrollt werden kann, das heißt die Dokumentenbreite minus der Ansichtsbereichbreite.

Window.scrollMaxY Schreibgeschützt

Der maximale Versatz, auf den das Fenster vertikal gescrollt werden kann (d.h. die Dokumentenhöhe minus der Ansichtsbereichhö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 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.

Window.sharedStorage Schreibgeschützt Sicherer Kontext

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

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

Window.statusbar Schreibgeschützt

Gibt das Statusleisten-Objekt zurück.

Window.toolbar Schreibgeschützt

Gibt das Werkzeugleisten-Objekt 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 den Einstiegspunkt für die Verwendung der Trusted Types API bietet.

Window.viewport Schreibgeschützt

Gibt eine Viewport-Objektinstanz zurück, die Informationen über den aktuellen Zustand des Ansichtsbereichs des Geräts bereitstellt.

Window.visualViewport Schreibgeschützt

Gibt ein VisualViewport-Objekt zurück, das den visuellen Ansichtsbereich für ein bestimmtes 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. Weitere Details finden Sie unter Window.frames.

Benannte Eigenschaften

Einige Elemente im Dokument werden auch als Fenstereigenschaften dargestellt:

  • Für jedes <embed>, <form>, <iframe>, <img>, und <object>-Element wird sein name (falls nicht leer) dargestellt. Zum Beispiel, wenn das Dokument <form name="my_form"> enthält, dann geben window["my_form"] (und sein Äquivalent window.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 HTMLCollection zurückgegeben, die alle enthält. Wenn eines der Elemente ein navigierbares <iframe> oder <object> ist, dann wird stattdessen die contentWindow des ersten solcher iframes zurückgegeben.

Veraltete Eigenschaften

Window.event Schreibgeschützt

Gibt das aktuelle Ereignis zurück, das momentan im Kontext des JavaScript-Codes behandelt wird, oder undefined, wenn momentan kein Ereignis behandelt wird. Das Event-Objekt, das direkt an Ereignis-Handler übergeben wird, sollte stattdessen wann immer möglich verwendet werden.

Window.external Schreibgeschützt

Gibt ein Objekt zurück, das Funktionen zum Hinzufügen externer Suchanbieter zum Browser enthält.

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

Window.cancelIdleCallback()

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

Window.webkitConvertPointFromPageToNode()

Transformiert einen WebKitPoint vom 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 (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 umgeschaltet wurde.

online

Wird ausgelöst, wenn der Browser Zugang zum Netzwerk erlangt hat und der Wert von navigator.onLine auf true umgeschaltet wurde.

Geräteausrichtungsereignisse

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

deviceorientation Sicherer Kontext

Wird ausgelöst, wenn neue Daten vom Magnetometerausrichtungssensor verfügbar sind, die die aktuelle Geräteausrichtung im Vergleich zum Erdkoordinatenrahmen anzeigen.

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

blur

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

focus

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

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 Promise abgelehnt wird, unabhängig davon, ob es einen Handler gibt, um die Ablehnung zu behandeln oder nicht.

unhandledrejection

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

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.addEventListener verwenden.
  • 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:

  • 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 das Window-Objekt als currentTarget protokolliert.

Spezifikationen

Spezifikation
HTML
# the-window-object

Browser-Kompatibilität