localStorage.setItem() 存储数据

最后更新：2026-09-09

setItem 向 localStorage 存储键值对。值必须是字符串——对象需要先 JSON.stringify。数据永久保存（不随页面关闭消失）。

分类	浏览器 BOM
ES 版本	DOM

📝 语法

localStorage.setItem('键', '值');

key	存储的键名。
value	存储的值（字符串）。

返回值：undefined。

是否修改原值：是（原地修改）

编辑下方代码，点击运行，在输出面板查看结果：

运行结果：

张三

💡 提示 对象必须 JSON.stringify 后存储，读取时 JSON.parse 解析。

⚠️ 警告 localStorage 容量约 5MB——不要存大量数据。超出配额会抛 QuotaExceededError。

浏览器	Chrome	Edge	Firefox	Safari	Opera
localStorage.setItem()	✓ v1	✓ v12	✓ v1	✓ v1	✓ v1
所有现代浏览器均支持

更多实战案例即将上线，敬请期待。

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。