讲师中心 微信公众号
AI工具推荐 视频效率加速

JSON.stringify 与 JSON.parse 在 Web Storage 数据存取中的关键作用

陌晨君_3768

陌晨君_3768

发布时间:2026-07-11 09:47:25

|

269人浏览过

|

来源于php中文网

原创

Web Storage只支持字符串,存储对象必须用JSON.stringify()转换,读取时必须用JSON.parse()解析,否则数据会丢失或损坏。

json.stringify 与 json.parse 在 web storage 数据存取中的关键作用

Web Storage(包括 localStorage 和 sessionStorage)只支持字符串类型的值,任何对象、数组、日期、布尔甚至数字,如果直接存入,都会被自动调用 toString() 转成类似 [object Object] 的无意义字符串,导致数据丢失或结构损坏。所以 JSON.stringify 和 JSON.parse 不是可选技巧,而是必须使用的转换桥梁。

存数据:必须先 stringify 再 setItem

JavaScript 对象不能直接塞进 localStorage。哪怕只是个普通数组或字面量对象,也得先转成标准 JSON 字符串:

  • localStorage.setItem('cart', JSON.stringify([{id: 1, name: '苹果'}, {id: 2, name: '香蕉'}]))
  • 如果对象含 Date、Map、Set、RegExp 或函数,原生 JSON.stringify 会丢数据——Date 变成空字符串,Map/Set 变成 {} 或 [],函数和 undefined 直接消失
  • 需要自定义 replacer 函数处理特殊类型,比如把 new Date() 转成 toISOString(),把 new Map([['a', 1]]) 先转成 Object.fromEntries(map)

取数据:必须先 getItem 再 parse

localStorage.getItem('key') 返回的永远是字符串,哪怕你存的是数组,它也不会自动变回数组。不 parse 就直接用,会出错或行为异常:

Json Schema Toolkit
Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载
  • const cart = JSON.parse(localStorage.getItem('cart') || '[]'); —— 加 || '[]' 防止 null 导致 JSON.parse(null) 报错
  • JSON.parse() 只返回 plain object 或 array,不会还原成 Date、Map 等原生类型;还原得靠手动判断:比如检测字符串是否匹配 ISO 时间格式,再 new Date(str);或用 new Map(Object.entries(obj.mapData))
  • 若存储时用了 reg.toString() 存正则,读取后要用 new RegExp(str) 重建

常见坑点与应对

很多问题其实就卡在这两个方法的使用细节上:

  • 存了但读出来是 [object Object]?说明忘了 stringify,对象被隐式转成了字符串
  • 读出来报 Unexpected token u in JSON at position 0?大概率是 getItem 返回 null,没做空值保护就直接 parse
  • 时间变成字符串、Map 变成空对象?不是 parse 不行,是 stringify 没处理好原始类型,反序列化自然无法还原
  • 键名含特殊字符或中文?没问题,Web Storage 支持任意字符串键名,只要值是合法 JSON 字符串即可

封装建议:避免重复写样板代码

每次存取都手写 stringify 和 parse 容易漏掉空值判断或类型还原。可以封装基础工具函数:

  • 统一存:接受任意值,内部判断类型并预处理,再 stringify 后 setItem
  • 统一取:getItem 后先判空,再 parse,最后根据约定字段做类型恢复(如 createdAt 字段自动转 Date)
  • 对高频使用的结构(如用户信息、配置项),可单独定义序列化/反序列化规则,提升可维护性

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2203

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

4683

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

5830

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5278

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

743

2024.05.22

json数据格式
json数据格式

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

1995

2023.08.07

json是什么
json是什么

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

2782

2023.08.23

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

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

956

2023.10.13

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.7万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.7万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn