JavaScript / TypeScript / 系统课时

使用 localStorage 保存数据

使用 localStorage 保存数据

本篇将实现任务数据的本地持久化,让用户刷新页面后仍能看到之前创建的任务。通过 localStorage 保存 JSON 数据,并处理初始化读取和存储失败场景。

学习目标

  • 理解 localStorage 保存字符串数据的限制
  • 掌握 JSON 序列化和反序列化任务对象
  • 能够为任务应用增加初始化恢复能力

认识 localStorage 的存储方式

浏览器提供的 localStorage 可以保存键值形式的数据,但它只能保存字符串。因此对象和数组需要先转换为 JSON 字符串。

常用转换流程如下:

  • 保存数据时使用 JSON.stringify()。
  • 读取数据时使用 JSON.parse()。

例如任务数组需要保存为字符串:

js
const tasks = [
  { id: 1, title: "学习存储", completed: false }
];

localStorage.setItem("tasks", JSON.stringify(tasks));

const savedTasks = JSON.parse(localStorage.getItem("tasks"));

console.log(savedTasks);

预期输出

text
[ { id: 1, title: '学习存储', completed: false } ]

如果直接保存数组,浏览器会调用默认转换方式,导致读取后无法恢复原始结构。

初始化恢复任务数据

页面加载时,需要先尝试从本地存储读取任务。如果没有历史数据,则使用空数组作为初始状态。

js
function loadTasks() {
  const value = localStorage.getItem("tasks");

  if (!value) {
    return [];
  }

  return JSON.parse(value);
}

const tasks = loadTasks();
console.log(tasks);

预期输出

text
[]

当用户第一次打开页面时没有保存记录,应用仍然可以正常运行。

保存任务变化

任务新增、删除或状态修改后,都需要重新写入 localStorage。

js
function saveTasks(tasks) {
  localStorage.setItem("tasks", JSON.stringify(tasks));
}

const tasks = [
  { id: 1, title: "保存任务", completed: true }
];

saveTasks(tasks);
console.log(localStorage.getItem("tasks"));

预期输出

text
[{"id":1,"title":"保存任务","completed":true}]

保存逻辑通常封装成独立函数,避免在多个事件处理位置重复编写转换代码。

处理存储异常

localStorage 虽然简单,但并不是永久可靠存储。浏览器隐私模式、存储空间限制或数据损坏都可能导致异常。

js
function safeLoadTasks() {
  try {
    const value = localStorage.getItem("tasks");
    return value ? JSON.parse(value) : [];
  } catch (error) {
    return [];
  }
}

console.log(safeLoadTasks());

预期输出

text
[]

实际项目中还可以在捕获异常后记录日志,帮助定位用户环境中的存储问题。

什么时候适合使用 localStorage

localStorage 适合保存体积较小、不需要服务器同步的数据,例如学习笔记、主题设置、简单待办列表。

如果数据需要多设备同步、多人协作或保存大量记录,应改用后端数据库或专门的数据存储方案。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 localStorage 保存数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通