StorageEvent

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.

The StorageEvent interface is implemented by the storage event, which is sent to a window when a storage area the window has access to is changed within the context of another document.

Event StorageEvent

Constructor

StorageEvent()

Returns a newly constructed StorageEvent object.

Instance properties

In addition to the properties listed below, this interface inherits the properties of its parent interface, Event.

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.

Instance methods

In addition to the methods listed below, this interface inherits the methods of its parent interface, Event.

initStorageEvent() Deprecated

Initializes the event in a manner analogous to the similarly-named initEvent() method in the DOM Events interfaces. Use the constructor instead.

Specifications

Specification
HTML
# the-storageevent-interface

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
StorageEvent
StorageEvent() constructor
initStorageEvent
Deprecated
key
newValue
oldValue
storageArea
url

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Deprecated. Not for use in new websites.

See also