window属性:localStorage
localStorage属性
localStorage 只读属性允许您访问 Document 源的 Storage 对象;存储的数据保存在浏览器会话中。 localStorage 类似 sessionStorage,除了存储在localStorage 中的数据没有到期时间,当页面会话结束时,存储在 sessionStorage 中的数据会被清除,也就是说,当页面被关闭时。
应该注意的是,存储在 localStorage 或 sessionStorage 中的数据都是特定于页面协议的。
localStorage属性语法
myStorage = window.localStorage;
localStorage属性值
一个Storage对象,它可以用来访问当前原点的本地存储空间。
异常
SecurityError
- 请求违反了策略决定,或者源不是有效的方案/主机/端口元组(scheme/host/port tuple)(如果源使用
file:
或data:
方案,则可能发生这种情况)。例如,用户可能会将其浏览器配置为拒绝为指定来源保留数据的权限。
localStorage属性示例
以下片段访问当前域的本地 Storage 对象并使用 Storage.setItem() 向其添加数据项。
localStorage.setItem('myCat', 'Tom');
读取 localStorage 项目的语法如下所示:
var cat = localStorage.getItem("myCat");
删除 localStorage 项目的语法如下所示:
localStorage.removeItem("myCat");
规范
规范 | 状态 | 注释 |
---|---|---|
HTML Living Standard 的'localStorage'的定义。 | Living Standard |
浏览器兼容性
我们正在将兼容性数据转换为机器可读的JSON格式。
- 电脑端
特征 | Chrome | Edge | Firefox(Gecko) | Internet Explorer | Opera | Safari(WebKit) |
---|---|---|---|---|---|---|
localStorage | 支持:4 | 支持 | 支持:3.5 | 支持:8 | 支持:10.50 | 支持:4 |
sessionStorage | 支持:5 | 支持 | 支持:2 | 支持:8 | 支持:10.50 | 支持:4 |
- 移动端
特征 | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
基本支持 | 支持:2.1 | 支持 | ? | 支持:8 | 支持:11 | 支持:iOS 3.2 |
所有的浏览器有两种不同的能力水平:localStorage 和 sessionStorage,以下是各种浏览器的所有存储容量的简介。
注意:从iOS 5.1开始,Safari Mobile localStorage会根据操作系统的要求将数据存储在高速缓存文件夹中,该数据库偶尔会进行清理,通常在空间不足的情况下。Safari Mobile的隐私浏览模式也会阻止localStorage完全写入。