大网数据广告活动
Web 标准与前端开发

Window.localStorage

· 52CE 我爱测

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

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

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

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

语法

myStorage = localStorage;

值

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

异常

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

示例

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

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

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

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

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

localStorage.removeItem("myCat");

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

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

[!NOTE] 请参考 Using the Web Storage API 的完整示例文章。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。