讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

HTML5本地存储能存对象吗_HTML5localStorage存储JSON数据序列化操作【方法】

冬婷酱_3527

冬婷酱_3527

发布时间:2026-02-28 19:09:52

|

818人浏览过

|

来源于php中文网

原创

localStorage只能存字符串,对象需用JSON.stringify序列化后存储,读取时用JSON.parse解析,且须用try...catch捕获解析错误;它会忽略函数、undefined、Symbol和Date等类型,容量约5MB并受跨域隔离限制,不可存储敏感信息。

html5本地存储能存对象吗_html5localstorage存储json数据序列化操作【方法】

localStorage 只能存字符串,对象必须 JSON.stringify

直接 localStorage.setItem('user', {name: 'Alice'}) 会存进去一个 [object Object],读出来就是个字符串,不是原来那个对象。这是因为 localStorage 底层只接受 string 类型的值,任何非字符串输入都会被强制调用 .toString()。

正确做法是手动序列化:

  • 存的时候用 JSON.stringify(obj)
  • 取的时候用 JSON.parse(str)
  • 务必加 try...catch,因为 JSON.parse 遇到非法 JSON 会直接抛错(比如存储内容被手动篡改过)

示例:

const user = { id: 123, name: 'Alice', active: true };
localStorage.setItem('user', JSON.stringify(user));

const saved = localStorage.getItem('user');
let parsed;
try {
  parsed = JSON.parse(saved);
} catch (e) {
  console.error('JSON parse failed:', e);
  parsed = null;
}

JSON.stringify 不能处理函数、undefined、Symbol、Date 等类型

如果对象里有 function、undefined、Symbol 或者 Date 实例,JSON.stringify 会静默忽略它们——不报错,但数据就丢了。

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

常见踩坑场景:

  • { now: new Date(), handler: () => {} } → 存进去只剩 {}
  • { count: undefined } → 这个字段直接消失
  • localStorage.setItem('cache', JSON.stringify(new Date())) → 存的是字符串 "2024-06-15T08:23:45.123Z",但读出来只是字符串,不是 Date 对象

如果真要存 Date,得自己转成时间戳或 ISO 字符串,并在读取后手动恢复:

JSON Toolkit
JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载
const data = { ts: Date.now(), name: 'test' };
localStorage.setItem('data', JSON.stringify(data));
// 读取后
const parsed = JSON.parse(localStorage.getItem('data'));
const date = new Date(parsed.ts); // 手动还原

localStorage 容量限制和跨域隔离很严格

多数浏览器给每个源(origin)配额约 5MB,超了会触发 QuotaExceededError。这不是警告,是同步报错,后续代码会中断。

另外几个关键事实:

  • 协议、域名、端口任意一个不同,就是不同源,localStorage 完全不共享
  • http://a.com 和 https://a.com 是两个独立存储空间
  • 本地文件打开(file:// 协议)下,多数浏览器禁用 localStorage 或每次都是干净沙盒
  • 隐私模式下,有些浏览器会临时启用但关闭即清空

检查是否可用且未满:

try {
  const test = '__storage_test__';
  localStorage.setItem(test, test);
  localStorage.removeItem(test);
} catch (e) {
  if (e.name === 'QuotaExceededError') {
    console.warn('localStorage quota exceeded');
  }
}

别把敏感数据放 localStorage,也别当数据库用

localStorage 是纯前端同步存储,没有任何访问控制——JS 脚本可读可写,XSS 攻击一打一个准。密码、token、用户身份标识这类东西,存了等于裸奔。

它也不是数据库替代品:

  • 没索引、没查询能力,查个字段得全量遍历 for (let i = 0; i
  • 没有事务、没有过期机制,想“自动删除”只能自己记时间戳 + 每次读取时判断
  • 大对象反复存取会明显卡 UI,因为 JSON.stringify/parse 是同步阻塞操作

真正该考虑的边界:单页应用里缓存非敏感、结构简单、体积小(

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

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

下载

相关标签:

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

热门AI工具

更多
WorkBuddy

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

豆包大模型

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

DeepSeek

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

讯飞绘文

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

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

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

2355

2023.08.07

json是什么
json是什么

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

3882

2023.08.23

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

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

1296

2023.10.13

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

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

4519

2025.09.10

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

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

4911

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的相关内容,可以阅读本专题下面的文章。

8848

2024.03.06

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

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

894

2025.12.30

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

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

754

2025.12.30

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 244人学习

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

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