JavaScript本地存储主要用Web Storage(localStorage永久、sessionStorage临时)和IndexedDB(高容量结构化数据库),辅以Cookies、Cache API等;选择依数据量、生命周期和功能需求而定。
Jav
aScript 实现本地存储主要依靠浏览器提供的 Web Storage API 和 IndexedDB API,它们允许网页在用户设备上持久或临时保存数据,无需依赖服务器。
这是最常用、最简单的本地存储方式,以键值对(字符串)形式保存数据。
localStorage.clear() 或用户删除浏览器数据),关闭标签页或重启浏览器也不丢失。两者都只能存字符串,若需存对象或数组,需配合 JSON.stringify() 和 JSON.parse():
localStorage.setItem('user', JSON.stringify({ name: '张三', age: 28 }));
const user = JSON.parse(localStorage.getItem('user'));
IndexedDB 是一个低级、异步、事务型的客户端数据库,适合存储大量结构化数据(如文件、图片 Blob、复杂对象),支持索引、查询和游标遍历。
IDBRequest),通过事件(onsuccess / onerror)或 Promise 包装(如使用 idb 库)处理结果。原生使用较繁琐,推荐搭配轻量封装库如 idb 简化操作:
import { openDB } from 'idb';
const db = await openDB('myapp', 1, {
upgrade(db) {
db.createObjectStore('notes', { keyPath: 'id' });
}
});
await db.put('notes', { id: 1, content: '今天要开会' });
Cookies:可通过 document.cookie 读写,但容量小(约 4KB)、每次 HTTP 请求自动携带,已不推荐用于纯前端存储;适合身份凭证等需服务端参与的场景。
Cache API:配合 Service Worker 使用,主要用于离线资源缓存(HTML/CSS/JS/图片等),不是通用数据存储接口。
File System Access API(实验性):允许网页直接读写用户本地文件系统(需用户主动授权),适用于编辑器、音视频工具等重型 PWA 应用,目前仅 Chromium 系浏览器支持且默认受限。
localStorage/sessionStorage 兼容所有现代浏览器(包括 IE8+);IndexedDB 在 Chrome/Firefox/Safari/Edge 均有良好支持(Safari 从 iOS 14.4+ 开始稳定支持)。
localStorage
sessionStorage
IndexedDB