Dasstorage-Ereignis desWindow-Interfaces wird ausgelöst, wenn ein anderes Dokument, das dieselbe Speichereinheit (entwederlocalStorage odersessionStorage) wie das aktuelle Fenster teilt, diese Speichereinheit aktualisiert. Das Ereignis wirdnicht auf dem Fenster ausgelöst, das die Änderung vorgenommen hat.

• BeilocalStorage wird das Ereignis in allen anderenBrowsing-Kontexten ausgelöst, die denselben Ursprung wie das auslösende Dokument haben. Dies schließt andere Tabs mit demselben Ursprung ein.
• BeisessionStorage wird das Ereignis in allen anderenBrowsing-Kontexten ausgelöst, die denselben Ursprung und denselben obersten Browsing-Kontext wie das auslösende Dokument haben. Dies schließt nur eingebettete iframes im selben Tab ein, jedoch nicht andere Tabs.

Dieses Ereignis ist nicht abbrechbar und wird nicht weitergegeben.

Syntax

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

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

Ereignistyp

EinStorageEvent. Erbt vonEvent.

Ereigniseigenschaften

keySchreibgeschützt

Gibt einen String mit dem Schlüssel des geänderten Speicherelements zurück.Daskey-Attribut istnull, wenn die Änderung durch dieclear()-Methode des Speichers verursacht wurde.

newValueSchreibgeschützt

Gibt einen String mit dem neuen Wert des geänderten Speicherelements zurück.Dieser Wert istnull, wenn die Änderung durch dieclear()-Methode des Speichers ausgelöst wurde,oder das Speicherelement aus dem Speicher entfernt wurde.

oldValueSchreibgeschützt

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

storageAreaSchreibgeschützt

Gibt einStorage-Objekt zurück, das das betroffene Speicherobjekt darstellt.

urlSchreibgeschützt

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

Ereignishandler-Aliasse

Zusätzlich zumWindow-Interface ist die Ereignishandlereigenschaftonstorage auch auf den folgenden Zielen verfügbar:

• HTMLBodyElement
• HTMLFrameSetElement
• SVGSVGElement

Beispiele

Protokollieren Sie dassampleList-Element in der Konsole, wenn dasstorage-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")));});

Die gleiche Aktion kann durch die Verwendung deronstorage-Ereignishandlereigenschaft erreicht werden:

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Web Storage API
• Die Web Storage API verwenden
• Auf Speicheränderungen mit dem StorageEvent reagieren