只读的localStorage
属性允许你访问一个Document
源(origin)的对象 Storage
;存储的数据将保存在浏览器会话中。localStorage
类似 sessionStorage
,但其区别在于:存储在 localStorage
的数据可以长期保留;而当页面会话结束——也就是说,当页面被关闭时,存储在 sessionStorage
的数据会被清除 。
应注意,无论数据存储在 localStorage
还是 sessionStorage
,它们都特定于页面的协议。
另外,localStorage
中的键值对总是以字符串的形式存储。 (需要注意, 和js对象相比, 键值对总是以字符串的形式存储意味着数值类型会自动转化为字符串类型).
语法
myStorage = localStorage;
值
一个可被用于访问当前源( origin )的本地存储空间的 Storage
对象。
异常
SecurityError
- 请求违反了一个策略声明,或者源( origin )不是 一个有效的 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 |
浏览器兼容性
BCD tables only load in the browser