Window: storage Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das storage Ereignis des Window Interfaces wird ausgelöst, wenn ein Speicherbereich (localStorage oder sessionStorage) im Kontext eines anderen Dokuments modifiziert wurde.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht propagiert.

Hinweis: Dies funktioniert nicht im selben Browsing-Kontext, der die Änderungen vornimmt — es ist wirklich eine Möglichkeit für andere Browsing-Kontexte auf der Domain, die den Speicher verwenden, jegliche vorgenommenen Änderungen zu synchronisieren. Browsing-Kontexte auf anderen Domains können nicht auf dieselben Speicherobjekte zugreifen.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("storage", (event) => {});
onstorage = (event) => {};

Ereignistyp

Ein StorageEvent. Erbt von Event.

Event StorageEvent

Ereigniseigenschaften

key Schreibgeschützt

Gibt einen String mit dem Schlüssel des geänderten Speicherelements zurück. Das key Attribut ist null, wenn die Änderung durch die clear() Methode des Speichers verursacht wurde.

newValue Schreibgeschützt

Gibt einen String mit dem neuen Wert des geänderten Speicherelements zurück. Dieser Wert ist null, wenn die Änderung durch die clear() Methode des Speichers aufgerufen wurde oder das Speicherelement aus dem Speicher entfernt wurde.

oldValue Schreibgeschützt

Gibt einen String mit dem ursprünglichen Wert des geänderten Speicherelements zurück. Dieser Wert ist null, wenn das Speicherelement neu hinzugefügt wurde und daher keinen vorherigen Wert hat.

storageArea Schreibgeschützt

Gibt ein Storage Objekt zurück, das das betroffene Speicherobjekt repräsentiert.

url Schreibgeschützt

Gibt einen String mit der URL des Dokuments zurück, dessen Speicher geändert wurde.

Alias für Ereignishandler

Zusätzlich zum Window Interface ist die Ereignishandler-Eigenschaft onstorage auch auf den folgenden Zielen verfügbar:

Beispiele

Protokollieren Sie das sampleList Element in der Konsole, wenn das storage Ereignis ausgelöst wird:

js
window.addEventListener("storage", () => {
  // When local storage changes, dump the list to
  // the console.
  console.log(JSON.parse(window.localStorage.getItem("sampleList")));
});

Dieselbe Aktion kann mit der onstorage Ereignishandler-Eigenschaft erreicht werden:

js
window.onstorage = () => {
  // When local storage changes, dump the list to
  // the console.
  console.log(JSON.parse(window.localStorage.getItem("sampleList")));
};

Spezifikationen

Specification
HTML Standard
# event-storage
HTML Standard
# handler-window-onstorage

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch