LocalStorage无原生批量API，需封装setItems（批量写入并自动序列化）、getItems（批量读取并尝试JSON解析）、removeItemsByPrefix（按前缀删除）等函数，并注意容量限制、类型处理及跨标签页同步问题。
LocalStorage 本身不提供原生的批量读写 API，但可以通过封装函数模拟批量操作，提升效率并减少重复代码。核心思路是：批量写入时统一调用 localStorage.setItem()，批量读取时用 localStorage.getItem() 配合键名数组；关键在于避免逐个硬编码键名，而是用结构化方式管理。
批量写入：一次存多个键值对
把要保存的数据组织成对象，遍历属性，逐个写入。可加异常捕获防止单条失败影响整体：
function setItems(items) {
if (typeof items !== 'object' || items === null) return;
for (const [key, value] of Object.entries(items)) {
try {
localStorage.setItem(key, typeof value === 'string' ? value : JSON.stringify(value));
} catch (e) {
console.warn(`写入 ${key} 失败：`, e.message);
}
}
}
// 使用示例
setItems({
theme: 'dark',
language: 'zh-CN',
lastLogin: Date.now(),
preferences: { fontSize: 14, autoSave: true }
});
批量读取：按键名数组一次性取多个值
传入键名数组，返回对应值的对象（自动尝试解析 JSON）：
function getItems(keys) {
const result = {};
keys.forEach(key => {
const raw = localStorage.getItem(key);
if (raw !== null) {
try {
result[key] = JSON.parse(raw); // 尝试解析为对象/数组/布尔等
} catch {
result[key] = raw; // 解析失败则保留原始字符串
}
}
});
return result;
}
// 使用示例
const data = getItems(['theme', 'language', 'preferences']);
console.log(data);
// { theme: 'dark', language: 'zh-CN', preferences: { fontSize: 14, autoSave: true } }
安全清理：批量删除指定键或清空全部
避免误删，推荐按前缀匹配或显式键列表删除；清空全部用 localStorage.clear()，但慎用：
立即学习“Java免费学习笔记（深入）”；
-
按键名列表删除：
keys.forEach(key => localStorage.removeItem(key)) -
按前缀批量删除（如所有以
user_开头的）：function removeItemsByPrefix(prefix) { Object.keys(localStorage) .filter(key => key.startsWith(prefix)) .forEach(key => localStorage.removeItem(key)); } -
清空全部（谨慎）：
localStorage.clear()—— 影响整个域名下所有 localStorage 数据
注意事项与边界处理
实际使用中需关注容量限制、类型兼容性和浏览器差异：
- 单个域名通常限 5–10MB，超限会抛
QuotaExceededError，批量写入前建议先估算大小（JSON.stringify(items).length） - LocalStorage 只支持字符串值，对象/数组/数字等必须序列化；读取后需手动解析，否则是字符串
- 部分浏览器在隐私模式下可能禁用 localStorage 或抛出异常，建议用
try/catch包裹关键操作 - 不同标签页间 localStorage 是共享的，但写入不触发其他页面的事件（需自行用
storage事件监听同步）
