StorageEvent
Summary
Provides event properties that are specific to the onstorage event.
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
bounce
:
change
:
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.
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…
DOM storage is user and/or administrator configurable from Internet Options and Group Policy and can be enabled/disabled in the client browser.
For local (x)html files that use the file: protocol, sessionStorage and localStorage are undefined.
Standards information
- HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 5.11.1.5
Attributions
Mozilla Developer Network
: [StorageEvent Article]Microsoft Developer Network: [StorageEvent Article]