IndexedDB离线存储使用教程

IndexedDB 是浏览器端强大而灵活的离线存储方案，专为需要持久化大量结构化数据、支持复杂查询与高可靠性的 Web 应用而生——它突破 localStorage 的字符串限制与同步阻塞缺陷，凭借异步操作、事务保障、多类型数据支持（包括 Blob/ArrayBuffer）、高效索引查询及数十至数百 MB 的大容量存储能力，成为构建真正离线可用应用的核心技术；尽管原生 API 略显繁琐，但通过合理封装或借助 idb 等现代库，即可显著提升开发效率与健壮性，让离线体验既强大又优雅。

IndexedDB 是一种在浏览器中存储大量结构化数据的低级 API，适用于需要离线功能的 Web 应用。它允许你在客户端持久保存数据，即便用户断开网络也能正常使用应用。相比 localStorage，IndexedDB 支持更多数据类型、事务处理和异步操作，更适合复杂场景。

为什么选择 IndexedDB？

localStorage 只能存字符串，且是同步操作，大量数据会阻塞页面。IndexedDB 的优势在于：

• 支持大容量存储：通常可使用几十 MB 到几百 MB，甚至更多（取决于浏览器和用户授权）
• 异步 API：不会阻塞主线程，适合处理大量数据
• 支持索引查询：可以对字段建立索引，实现高效检索
• 支持二进制数据：如 ArrayBuffer、Blob，适合存储文件或图片
• 事务机制：保障数据一致性

基本概念与使用步骤

使用 IndexedDB 需要理解几个核心概念：数据库、对象仓库（Object Store）、事务、索引和游标。

通过 indexedDB.open() 打开数据库，若不存在则自动创建：

let request = indexedDB.open('MyAppDB', 1);
request.onupgradeneeded = function(event) {
  let db = event.target.result;
  if (!db.objectStoreNames.contains('users')) {
    db.createObjectStore('users', { keyPath: 'id' });
  }
};
request.onsuccess = function(event) {
  let db = event.target.result;
  // 数据库打开成功，可进行增删改查
};

在 onupgradeneeded 中定义数据结构：

let store = db.createObjectStore('users', { keyPath: 'id' });
store.createIndex('name', 'name', { unique: false });
store.createIndex('email', 'email', { unique: true });

let transaction = db.transaction(['users'], 'readwrite');
let store = transaction.objectStore('users');
let addUser = store.add({ id: 1, name: '张三', email: 'zhang@example.com' });

addUser.onsuccess = () => console.log('添加成功');
addUser.onerror = () => console.error('添加失败');

let getRequest = store.get(1);
getRequest.onsuccess = function() {
  if (getRequest.result) {
    console.log('找到用户:', getRequest.result);
  } else {
    console.log('未找到');
  }
};

let index = store.index('email');
let findUser = index.get('zhang@example.com');
findUser.onsuccess = () => console.log('通过邮箱找到:', findUser.result);

• 更新用 put()，传入已有 key 的对象
• 删除用 delete(key)

封装建议与最佳实践

原生 IndexedDB API 较繁琐，建议封装成 Promise 或使用工具库。

• 封装通用方法：如 openDB、addData、getData 等，减少重复代码
• 错误处理：监听 error 事件，避免静默失败
• 版本控制：升级数据库时修改版本号，利用 onupgradeneeded 迁移结构
• 兼容性处理：部分旧浏览器需前缀（如 webkitIndexedDB）
• 考虑使用封装库：如 idb，提供更简洁的 Promise 接口

基本上就这些。IndexedDB 虽学习成本略高，但对需要离线能力的应用来说非常值得掌握。不复杂但容易忽略的是事务生命周期——只有在事务活跃时，请求才有效。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。