This page is Not Ready

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

StorageEvent

Summary

Provides event properties that are specific to the onstorage event.

Inherits from EventEvent

Properties

No properties.

Methods

No methods.

Events

No events.

Inherited from Event

Properties

bubbles
Gets a value that indicates whether an event propagates up from the event target.
cancelable
Gets a value that indicates whether you can cancel an event’s default action.
currentTarget
Gets the event target that is currently being processed.
defaultPrevented
Gets whether the default action should be canceled.
eventPhase
Gets the event phase that is being evaluated.
isTrusted
Gets a value that indicates whether a trusted event source created an event.
target
Gets the element that is the original target of the event.
timeStamp
Gets the time, in milliseconds, when an event occurred.
type
Gets the name of an event.

Methods

initEvent
Initializes a new generic event that the createEvent method created.
preventDefault
Cancels the default action of an event, if possible.
stopImmediatePropagation
Prevents any further propagation of an event.
stopPropagation
Prevents propagation of an event beyond the current target.

Events

DOMContentLoaded
:

afterprint
:

afterupdate
:

beforeactivate
:

beforecopy
:

beforecut
:

beforeeditfocus
:

beforepaste
:

beforeprint
:

beforeunload
:

beforeupdate
:

bounce
:

cellchange
:

change
:

contextmenu
:

controlselect
:

copy
:

cut
Fires after a data selection is cut to the clipboard.
dataavailable
Fires when new data at a data source becomes available.
datasetchanged
Fires when content at a data source has changed.
datasetcomplete
Fires when data transfer from the data source has completed.
deactivate
Sets an active version of an object to not active.
error
Fires when an error occurs.
errorupdate
Executes any error handling associated with the event.

filterchange
:

finish
:

Examples

The following code example demonstrates how to respond to storage events.

function reportStorage(evt) {
    alert("Storage was updated for " + evt.url);
}
window.onload = function() {
if(window.sessionStorage){
    window.addEventListener('storage',reportStorage,false);
    window.sessionStorage.setItem('key','value');
}
}

Usage

 Used to notify a user that data has been successfully written to their DOM Storage area of their device.

Notes

In MSIE/Windows browsers…

  1. DOM storage is user and/or administrator configurable from Internet Options and Group Policy and can be enabled/disabled in the client browser.

  2. For local (x)html files that use the file: protocol, sessionStorage and localStorage are undefined.

Standards information

Attributions