0

0

HTML5本地存储localStorage怎么用_存数据取数据方法【解答】

星夢妙者

星夢妙者

发布时间:2026-01-04 21:23:02

|

306人浏览过

|

来源于php中文网

原创

localStorage存取数据最安全做法是:存对象用JSON.stringify()、取值先判空再JSON.parse();键名用字母数字组合;超限时捕获QuotaExceededError并降级;避免clear()误删,批量删除需遍历判断前缀。

html5本地存储localstorage怎么用_存数据取数据方法【解答】

localStorage.setItem() 存字符串最安全

localStorage 只能存字符串,直接传对象或数字会自动调用 toString(),导致数据失真。比如存 {name: "张三", age: 25},不处理就存进去,取出来是 [object Object]

实操建议:

  • 存对象前必须用 JSON.stringify() 序列化
  • 存布尔值、数字时也建议统一转字符串或显式序列化,避免隐式转换歧义(如 false 变成 ""
  • 键名尽量用字母数字组合,避免空格、斜杠、控制字符,否则某些浏览器可能静默失败
localStorage.setItem('user', JSON.stringify({name: "张三", age: 25}));
localStorage.setItem('count', String(100)); // 显式转字符串更可控

localStorage.getItem() 取值后记得 JSON.parse()

取出来的永远是字符串,哪怕你当初存的是数字或布尔值。不解析就直接用,很容易在条件判断或计算中出错——比如 if (localStorage.getItem('isLogin') === true) 永远为 false,因为取出来是 "true" 字符串。

常见错误现象:

立即学习前端免费学习笔记(深入)”;

火山方舟
火山方舟

火山引擎一站式大模型服务平台,已接入满血版DeepSeek

下载
  • JSON.parse(null) 报错:getItem() 找不到键时返回 null,不能直接丢给 JSON.parse()
  • 存了非法 JSON(比如手动拼接字符串),JSON.parse() 会抛 SyntaxError
const userStr = localStorage.getItem('user');
const user = userStr ? JSON.parse(userStr) : null; // 先判空再解析
const count = Number(localStorage.getItem('count')) || 0;

localStorage.removeItem() 和 clear() 的适用场景不同

removeItem(key) 删除单个键值对clear() 清空全部。别在用户仅想“退出当前账号”时误用 clear(),可能把其他功能的配置(比如主题色、语言偏好)也删了。

使用注意点:

  • removeItem() 对不存在的键静默失败,不报错也不提示
  • clear() 不可逆,且会影响同源下所有页面共享的 localStorage,谨慎用于生产环境
  • 如果要批量删,自己遍历 Object.keys(localStorage) 判断前缀再删,比全清更稳妥
// 安全地删一组以 'cart_' 开头的数据
Object.keys(localStorage).forEach(key => {
  if (key.startsWith('cart_')) {
    localStorage.removeItem(key);
  }
});

localStorage 的容量和错误边界必须主动检查

多数浏览器限制在 5MB 左右(不是精确值,Chrome 是约 5.2MB,Safari 移动端可能只有 2.5MB),超限会触发 QuotaExceededError。但这个错误不会自动抛出——只有在 setItem() 失败时才发生,且部分旧版 Safari 还会静默截断。

关键应对方式:

  • 写入前先估算字符串长度:new TextEncoder().encode(str).length(UTF-8 字节长度)比 str.length 更准
  • 捕获异常并降级:比如改用 sessionStorage 或提示用户清理
  • 不要假设“存得进就一定取得出”,特别在 iOS Safari 中,存储后立即读取有时返回 null(需加短延时或重试)
try {
  localStorage.setItem('data', hugeString);
} catch (e) {
  if (e.name === 'QuotaExceededError') {
    console.warn('localStorage 空间不足');
    // 触发清理逻辑或切换存储方案
  }
}
实际项目里最容易被忽略的,是跨页面写入后立即读取的时机问题,以及未处理 null 就直接 JSON.parse() 的崩溃风险。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

405

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

531

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

308

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

500

2023.10.23

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

421

2024.03.06

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

7

2025.12.30

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

10

2025.12.30

免费看漫画app合集_2026免费漫画app排行榜入口
免费看漫画app合集_2026免费漫画app排行榜入口

2026年免费漫画APP合集来啦!为你精心整理最新免费漫画APP排行榜入口,涵盖漫蛙漫画、香香漫画、包子漫画等热门神器,海量正版国漫、日漫、韩漫资源全免费阅读,无需付费解锁章节!高清全彩画质、每日极速更新,支持离线下载、智能推荐、条漫阅读模式,热血、恋爱、悬疑、古风、搞笑等题材应有尽有。无论你是追新番老粉还是小白漫迷,这里都能让你一站式追漫到爽,告别广告干扰和会员套路!赶紧点击入口下载体验,开启2026无限免费漫画之旅吧!

1

2026.01.07

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.8万人学习

AngularJS教程
AngularJS教程

共24课时 | 2.4万人学习

CSS教程
CSS教程

共754课时 | 18万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号