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 适合保存体积较小、不需要服务器同步的数据,例如学习笔记、主题设置、简单待办列表。
如果数据需要多设备同步、多人协作或保存大量记录,应改用后端数据库或专门的数据存储方案。
按自己的节奏,确认真正理解。