window属性：localStorage

window属性：localStorage

由 Carrie 创建， 最后一次修改 2018-04-11

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完全写入。