Baseline Widely available
The storage
event of the Window
interface fires when another document that shares the same storage area (either localStorage
or sessionStorage
) as the current window updates that storage area. The event is not fired on the window that made the change.
localStorage
, the event is fired in all other browsing contexts that are in the same origin as the initiating document. This includes other tabs with the same origin.sessionStorage
, the event is fired in all other browsing contexts that are in the same origin and the same top-level browsing context as the initiating document. This only includes embedded iframes, if any, in the same tab, and not other tabs.This event is not cancelable and does not bubble.
SyntaxUse the event name in methods like addEventListener()
, or set an event handler property.
addEventListener("storage", (event) => { })
onstorage = (event) => { }
Event type Event properties
key
Read only
Returns a string with the key for the storage item that was changed. The key
attribute is null
when the change is caused by the storage clear()
method.
newValue
Read only
Returns a string with the new value of the storage item that was changed. This value is null
when the change has been invoked by storage clear()
method, or the storage item has been removed from the storage.
oldValue
Read only
Returns a string with the original value of the storage item that was changed. This value is null
when the storage item has been newly added and therefore doesn't have any previous value.
storageArea
Read only
Returns a Storage
object that represents the storage object that was affected.
url
Read only
Returns string with the URL of the document whose storage changed.
In addition to the Window
interface, the event handler property onstorage
is also available on the following targets:
Log the sampleList
item to the console when the storage
event fires:
window.addEventListener("storage", () => {
// When local storage changes, dump the list to
// the console.
console.log(JSON.parse(window.localStorage.getItem("sampleList")));
});
The same action can be achieved using the onstorage
event handler property:
window.onstorage = () => {
// When local storage changes, dump the list to
// the console.
console.log(JSON.parse(window.localStorage.getItem("sampleList")));
};
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3