W3cubDocs

/DOM

StorageEvent

A StorageEvent is sent to a window when a storage area it has access to is changed within the context of another document.

Note: Although this event existed prior to Gecko 2.0, it did not match the specification. The old event format is now represented by the nsIDOMStorageEventObsolete interface.

Method overview

void initStorageEvent(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString keyArg, in DOMString oldValueArg, in DOMString newValueArg, in DOMString urlArg, in nsIDOMStorage storageAreaArg);

Attributes

Attribute Type Description
key DOMString Represents the key changed. The key attribute is null when the change is caused by the storage clear() method. Read only.
newValue DOMString The new value of the key. The newValue is null when the change has been invoked by storage clear() method or the key has been removed from the storage. Read only.
oldValue DOMString The original value of the key. The oldValue is null when the key has been newly added and therefore doesn't have any previous value. Read only.
storageArea nsIDOMStorage Represents the Storage object that was affected. Read only.
url DOMString The URL of the document whose key changed. Read only.

Methods

initStorageEvent()

Initializes the event in a manner analogous to the similarly-named method in the DOM Events interfaces.

void initStorageEvent(
  in DOMString typeArg,
  in boolean canBubbleArg,
  in boolean cancelableArg,
  in DOMString keyArg,
  in DOMString oldValueArg,
  in DOMString newValueArg,
  in DOMString urlArg,
  in nsIDOMStorage storageAreaArg
);
Parameters
typeArg
The name of the event.
canBubbleArg
A boolean indicating whether the event bubbles up through the DOM or not.
cancelableArg
A boolean indicating whether the event is cancelable.
keyArg
The key whose value is changing as a result of this event.
oldValueArg
The key's old value.
newValueArg
The key's new value.
urlArg
The URL of the document initiating the change.
storageAreaArg
The DOM Storage object representing the storage area on which this event occurred.

See also

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 1 ? Yes ? Yes ?
StorageEvent() constructor 17 ? Yes ? Yes ?
initStorageEvent Yes ? Yes ? Yes ?
key 1 ? Yes ? Yes ?
newValue 1 ? Yes ? Yes ?
oldValue 1 ? Yes ? Yes ?
storageArea 3 ? Yes ? Yes ?
url 5 ? Yes ? Yes ?
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes Yes ? Yes Yes ? ?
StorageEvent() constructor Yes Yes ? Yes Yes ? ?
initStorageEvent Yes Yes ? Yes Yes ? ?
key Yes Yes ? Yes Yes ? ?
newValue Yes Yes ? Yes Yes ? ?
oldValue Yes Yes ? Yes Yes ? ?
storageArea Yes Yes ? Yes Yes ? ?
url Yes Yes ? Yes Yes ? ?

Edit this page on MDN

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/StorageEvent