localStorage.getItem() 读取数据

最后更新：2026-09-09

getItem 从 localStorage 读取指定键的值。键不存在时返回 null（不是报错）。

分类	浏览器 BOM
ES 版本	DOM

📝 语法

const 值 = localStorage.getItem('键');

key	要读取的键名。

返回值：存储的字符串值或 null。

是否修改原值：否（返回新值）

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

运行结果：

张三
张三
null

💡 提示 读取 JSON 数据前判断是否为 null——首次访问时键不存在。

ℹ️ info 读取的值总是字符串——数字会变成字符串，需要 Number() 转换。

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

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

Web-Tutorial 技术团队

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