只读的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 项,如下:

var cat = localStorage.getItem("myCat");

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

localStorage.removeItem("myCat");

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

规范

Specification Status Comment
HTML Living Standard
localStorage
Unknown  

浏览器兼容性

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!

特性 Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 (Yes) 3.5 8 10.50 4
sessionStorage 5 (Yes) 2 8 10.50 4
特性 Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
支持基于 2.1 (Yes) ? 8 11 iOS 3.2

所有浏览器拥有不同的容量级别,对于 localStoragesessionStorage 。这里一个细节说明页面: detailed rundown of all the storage capacities for various browsers

注意:iOS5.1开始, Safari Mobile 存储 localStorage 在缓存文件夹,它受制于偶然的操作系统命令的清除行为,比如典型情况下是空间不够。 Safari Mobile 的隐私浏览模式同样会阻止完全地写入 localStorage

参见

文档标签和贡献者

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