如何使用 setItem 与 getItem 实现数据的存取操作

落丽吖_7300

落丽吖_7300

2026-07-06

509人浏览

原创

setitem 和 getitem 是 web storage api 的核心方法,分别用于存入和读取字符串数据;setitem 接收键名和字符串值(复杂数据需 json.stringify),超出限额抛 quotaexceedederror;getitem 返回对应字符串或 null,取出后需 json.parse 还原,且须判空防错。

如何使用 setitem 与 getitem 实现数据的存取操作

setItem 和 getItem 是 Web Storage API 提供的两个核心方法,用于在浏览器中持久化保存和读取字符串数据。它们操作的是 localStorage(长期存储)或 sessionStorage(会话级存储),最常用的是 localStorage。

setItem:把数据存进浏览器

它接收两个参数:键名(key)和值(value),且 value 必须是字符串。如果传入对象、数组或数字,会自动调用 .toString(),可能导致意外结果(比如对象变成 [object Object])。

  • 正确做法是先用 JSON.stringify() 序列化复杂数据
  • 键名建议用语义清晰、避免冲突的字符串,比如 "userPreferences"
  • 存储成功无返回值;若超出存储限额(通常约 5–10MB),会抛出 QuotaExceededError

示例:

Multi-Brain Protocol
Multi-Brain Protocol

一款AI工具,主要用于在主代理响应前,并行运行Kimi K2.5和GPT 5.3 Codex,注入双方观点以增强认知多样性,适合需要提升相关任务效率的用户。

下载
localStorage.setItem("theme", "dark");
localStorage.setItem("cartItems", JSON.stringify([{id: 1, name: "苹果"}]));

getItem:从浏览器取出数据

它接收一个键名,返回对应存储的字符串值;如果键不存在,返回 null(不是 undefined)。

  • 取出的始终是字符串,需手动用 JSON.parse() 还原对象或数组
  • 建议加判断防止解析失败,比如检查是否为非空字符串再解析
  • 不要直接信任返回值类型,尤其在跨页面或多次写入后

示例:

const theme = localStorage.getItem("theme"); // "dark"
const cartStr = localStorage.getItem("cartItems");
const cart = cartStr ? JSON.parse(cartStr) : [];

配合使用时的常见注意事项

  • 存储前确认值可序列化:函数、undefined、Symbol、Date 实例等无法被 JSON.stringify 正确处理
  • 敏感信息(如 token、密码)不建议存在 localStorage,容易被 XSS 攻击窃取
  • 修改数据后记得更新存储:不能只改 JS 变量,忘了调用 setItem
  • 删除用 removeItem(key),清空用 clear(),避免残留旧数据

简单封装提升可用性(可选)

为减少重复判断和转换,可以封装一层工具函数:

const storage = {
  set(key, value) {
    localStorage.setItem(key, JSON.stringify(value));
  },
  get(key) {
    const str = localStorage.getItem(key);
    return str ? JSON.parse(str) : null;
  }
};
// 使用:
storage.set("count", 42);
console.log(storage.get("count")); // 42

相关专题

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

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

2023.08.11

2083

5

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

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

2023.10.09

4483

6

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

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

2024.03.19

5610

13

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

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

2024.03.22

5058

10

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

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

2024.05.22

723

5

json数据格式
json数据格式

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

2023.08.07

1975

5

json是什么
json是什么

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

2023.08.23

2662

1

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

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

2023.10.13

916

3

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

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

2025.09.10

2979

7

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.2万人学习