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

陌晨君_3768

陌晨君_3768

2026-07-11

269人浏览

原创

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)
  • 对高频使用的结构(如用户信息、配置项),可单独定义序列化/反序列化规则,提升可维护性

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

sessionstorage js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.08.11

2183

5

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

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

2023.10.09

4683

6

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

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

2024.03.19

5830

13

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

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

2024.03.22

5278

10

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

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

2024.05.22

743

5

json数据格式
json数据格式

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

2023.08.07

1995

5

json是什么
json是什么

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

2023.08.23

2782

1

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

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

2023.10.13

956

3

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

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

2025.09.10

3139

7

热门下载

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

精品课程

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

共101课时 | 20.7万人学习

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

共39课时 | 4.7万人学习