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.
addEventListener("storage", (event) => {});
onstorage = (event) => {};
Ereignistyp
Ein StorageEvent
. Erbt von Event
.
Ereigniseigenschaften
key
Nur lesbar-
Gibt einen String mit dem Schlüssel des geänderten Speicherelements zurück. Das
key
Attribut istnull
, wenn die Änderung durch dieclear()
Methode des Speichers verursacht wurde. newValue
Nur lesbar-
Gibt einen String mit dem neuen Wert des geänderten Speicherelements zurück. Dieser Wert ist
null
, wenn die Änderung durch dieclear()
Methode des Speichers aufgerufen wurde oder das Speicherelement aus dem Speicher entfernt wurde. oldValue
Nur lesbar-
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
Nur lesbar-
Gibt ein
Storage
Objekt zurück, das das betroffene Speicherobjekt repräsentiert. url
Nur lesbar-
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:
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:
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