localStorage property allows you to access a
Storage object for the
Document's origin; the stored data is saved across browser sessions.
localStorage is similar to
sessionStorage, except that while data stored in
localStorage has no expiration time, data stored in
sessionStorage gets cleared when the page session ends — that is, when the page is closed.
It should be noted that data stored in either
sessionStorage is specific to the protocol of the page.
myStorage = window.localStorage;
Storage object which can be used to access the current origin's local storage space.
- The request violates a policy decision, or the origin is not a valid scheme/host/port tuple (this can happen if the origin uses the
data:scheme, for example). For example, the user may have their browser configured to deny permission to persist data for the specified origin.
The syntax for reading the localStorage item is as follows:
var cat = localStorage.getItem("myCat");
The syntax for removing the localStorage item is as follows:
Note: Please refer to the Using the Web Storage API article for a full example.
|HTML Living Standard
The definition of 'localStorage' in that specification.
We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
|Feature||Chrome||Edge||Firefox (Gecko)||Internet Explorer||Opera||Safari (WebKit)|
|Feature||Android||Edge||Firefox Mobile (Gecko)||IE Phone||Opera Mobile||Safari Mobile|
|Basic support||2.1||(Yes)||?||8||11||iOS 3.2|
All browsers have varying capacity levels for both
sessionStorage. Here is a detailed rundown of all the storage capacities for various browsers.
Note: Starting with iOS 5.1, Safari Mobile stores
localStorage data in the cache folder, which is subject to occasional clean up, at the behest of the OS, typically if space is short. Safari Mobile's Private Browsing mode also prevents writing to