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

如何利用JavaScript实现本地存储【教程】

雨伟小哥_3725

雨伟小哥_3725

发布时间:2026-01-17 18:53:02

|

674人浏览过

|

来源于php中文网

原创

localStorage用于跨会话持久存储,同源共享;sessionStorage仅限当前标签页,关闭即销毁;二者均需手动序列化对象,超容或禁用时会抛异常,且storage事件不触发于当前页修改。

如何利用javascript实现本地存储【教程】

本地存储不是“存完就完事”,关键在什么时候用 localStorage、什么时候该换 sessionStorage,以及为什么某些数据存不进去还不出错。

localStorage 和 sessionStorage 的核心区别在哪

两者 API 完全一致,但生命周期和作用域不同:

  • localStorage:数据永不过期,关闭标签页、重启浏览器都还在,同源(协议+域名+端口)下所有页面共享
  • sessionStorage:仅当前标签页有效,关掉标签页即清空,即使同域名的其他标签页也读不到
  • 二者都只能存字符串,存对象必须先 JSON.stringify(),取出来要 JSON.parse()
  • 都不受 HTTP 缓存或 Cookie 设置影响,也不发请求,纯前端行为

存对象时忘记序列化会静默失败

调用 localStorage.setItem('user', {name: 'Alice'}) 看似没报错,但实际存入的是 "[object Object]"——因为 setItem 会自动调用 .toString()。取出来再 JSON.parse() 就直接报错。

正确写法必须显式处理:

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

const user = { name: 'Alice', age: 28 };
localStorage.setItem('user', JSON.stringify(user));

const saved = localStorage.getItem('user');
const parsed = saved ? JSON.parse(saved) : null;

建议封装一层安全读写函数,避免每次手动判断 null 或解析异常。

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载

超出容量或特殊字符导致写入失败

大多数浏览器限制 localStorage 总容量在 5–10 MB 左右,但它是按 origin 计算的,不是单个 key。一旦超限,setItem 会抛出 QuotaExceededError 异常,而不是返回 false。

  • 中文、emoji、控制字符本身不导致失败,但经过 JSON.stringify() 后可能增大体积
  • 某些浏览器(如 Safari 无痕模式)会直接禁用 localStorage,调用即抛错,需 try/catch
  • 敏感数据(如 token)别直接存——它不加密、不防 XSS,JS 可任意读取

稳妥做法是加兜底逻辑:

function safeSet(key, value) {
  try {
    localStorage.setItem(key, JSON.stringify(value));
  } catch (e) {
    if (e.name === 'QuotaExceededError') {
      console.warn('localStorage quota exceeded');
    } else if (e.name === 'SecurityError') {
      console.warn('localStorage is disabled or blocked');
    }
  }
}

监听 storage 变化只在其他标签页生效

storage 事件只在**同一 origin 下的其他窗口/标签页**触发,当前页面修改后不会收到自己的事件。这是常被误解的一点。

  • 适合做多标签页状态同步(比如用户登出后通知其他页刷新)
  • 监听写法:window.addEventListener('storage', e => {...})
  • e.key 是被改的键名,e.newValuee.oldValue 是字符串值(注意:删除时 newValuenull
  • 无法得知是谁触发的变更,也无法阻止变更

如果需要当前页响应自身修改,得自己发自定义事件或用状态管理工具同步。

真正麻烦的不是怎么写那几行 setItem,而是想清楚数据要不要跨会话保留、有没有被脚本恶意读取的风险、以及用户换了设备或清了缓存之后,你的“本地”到底还剩多少。

热门AI工具

更多
DeepSeek

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

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

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

豆包大模型

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

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

UP简历
UP简历 Hot

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

相关专题

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

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

1955

2023.08.07

json是什么
json是什么

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

2622

2023.08.23

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

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

916

2023.10.13

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

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

2919

2025.09.10

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

509

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1638

2024.03.01

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

10819

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

926

2023.11.23

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习

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

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