W3cubDocs

/Web APIs

StorageEvent

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 that represents the key 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 key. This value is null when the change has been invoked by storage clear() method, or the key has been removed from the storage.

oldValue Read only

Returns a string with the original value of the key. This value is null when the key has been newly added and therefore doesn't have any previous value.

storageArea Read only

Returns a Storage object that represents the storage that was affected.

url Read only

Returns string with the URL of the document whose key 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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
StorageEvent 17 17 13 No 15 6 4.4 18 14 14 6 1.0
StorageEvent 1 12 13 9 ≤12.1 4 ≤37 18 14 ≤12.1 3 1.0
initStorageEvent 4 12 13 9 ≤12.1 4 ≤37 18 14 ≤12.1 3 1.0
key 1 12 13 9 ≤12.1 4 ≤37 18 14 ≤12.1 3 1.0
newValue 1 12 13 9 ≤12.1 4 ≤37 18 14 ≤12.1 3 1.0
oldValue 1 12 13 9 ≤12.1 4 ≤37 18 14 ≤12.1 3 1.0
storageArea 3 12 13 9 ≤12.1 4 ≤37 18 14 ≤12.1 3 1.0
url 6 12 13 9 ≤12.1 5 3 18 14 ≤12.1 5 1.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/StorageEvent