Window.localStorage

只读的localStorage 属性允许你访问一个Document 源(origin)的对象 Storage;存储的数据将保存在浏览器会话中。localStorage 类似 sessionStorage,但其区别在于:存储在 localStorage 的数据可以长期保留;而当页面会话结束——也就是说,当页面被关闭时,存储在 sessionStorage 的数据会被清除。

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

另外,localStorage 中的键值对总是以字符串的形式存储。 (需要注意,和 js 对象相比,键值对总是以字符串的形式存储意味着数值类型会自动转化为字符串类型).

语法

js
myStorage = localStorage;

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

异常

SecurityError

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

示例

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

js
localStorage.setItem("myCat", "Tom");

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

js
let cat = localStorage.getItem("myCat");

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

js
localStorage.removeItem("myCat");

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

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

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

规范

Specification
HTML Standard
# dom-localstorage-dev

浏览器兼容性

BCD tables only load in the browser

参见