onstorage event
[This documentation is preliminary and is subject to change.]
Fires when a Web Storage area is updated.
.png "HTML5 A vocabulary and associated APIs for HTML and XHTML"){kind=icon} .png "Internet Explorer 8"){kind=icon} |
Syntax
| HTML Attribute | <element onstorage = "handler(event)"> |
| Event Property | object.onstorage = handler; |
| attachEvent Method | object.attachEvent("onstorage", handler) |
| addEventListener Method | object.addEventListener("storage", handler, useCapture) |
Standards information
Event information
| Synchronous | No |
| Bubbles | No |
| Cancelable | No |
Event handler parameters
- pEvtObj [in]
Type: IHTMLEventObj
Remarks
The IHTMLEventObj5::url property of the event specifies the URL of the Web page that made the update.
For Windows Internet Explorer 9 standards mode, HTMLDocumentEvents3::onstorage will only fire on window objects. Handlers attached to document.body or document objects will not receive the event. (Note this does not apply to the HTMLDocumentEvents3::onstoragecommit event.)
The HTMLDocumentEvents3::onstorage event will only fire on window objects. Handlers attached to document.body or document objects will not receive the event. (Note this does not apply to the HTMLDocumentEvents3::onstoragecommit event.)
The HTMLDocumentEvents3::onstorage event is specified in the W3C Web Storage specification.
To invoke this event, do one of the following:
- Set or update a session or local storage value with IHTMLStorage::setItem.
- Remove a session or local storage value with IHTMLStorage::removeItem.
See also
Build date: 6/12/2012