只读的localStorage 允许你访问一个Document 的远端(origin)对象 Storage;数据存储为跨浏览器会话。 localStorage 类似于sessionStorage区别在于,数据存储在 localStorage 是无期限的,而当页面会话结束——也就是说当页面被关闭时,数据存储在sessionStorage 会被清除 。

应注意无论数据存储在 localStorage 还是 sessionStorage它们都特定于页面的协议。

语法

myStorage = localStorage;

一个 Storage 可被用于访问当前远端( origin )的本地存储空间的对象。

异常

SecurityError
请求违反了一个策略声明,或者远端( origin )不是 a valid scheme/host/port tuple (例如如果origin使用 file: 或者 data: 形式将可能发生)。比如,用户可以有禁用允许对指定的origin存留数据的浏览器配置。

示例

下面的代码片段访问当前域名下的本地 Storage 对象,并增加了一个数据项通过使用Storage.setItem()

localStorage.setItem('myCat', 'Tom');

该语法用于读取 localStorage 项,如下:

let cat = localStorage.getItem('myCat');

该语法用于移除 localStorage 项,如下:

localStorage.removeItem('myCat');

该语法用于移除所有的 localStorage 项,如下:

// 移除所有
localStorage.clear();

注意: 请参考 Using the Web Storage API 的完整示例文章。

规范

Specification Status Comment
HTML Living Standard
localStorage
Unknown  

浏览器兼容性

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 4Edge Full support YesFirefox Full support 3.5IE Full support 8Opera Full support 10.5Safari Full support 4WebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support 11Safari iOS Full support 3.2Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

参见

文档标签和贡献者

此页面的贡献者: jjc, mySoul, xgqfrms, nodebq, loicaplay, kameii, Marcia_gm, AlexChao
最后编辑者: jjc,