17370845950

JavaScript数据库_IndexedDB离线存储方案
IndexedDB适合离线应用因支持大容量、异步操作与索引查询,相比localStorage更高效。通过open创建数据库,在onupgradeneeded中建对象仓库和索引,用transaction进行增删改查,需注意事务生命周期与版本控制,建议封装或使用idb库提升开发效率。

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

为什么选择 IndexedDB?

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

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

基本概念与使用步骤

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

1. 打开/创建数据库

通过 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;
  // 数据库打开成功,可进行增删改查
};
2. 创建对象仓库和索引

onupgradeneeded 中定义数据结构:

let store = db.createObjectStore('users', { keyPath: 'id' });
store.createIndex('name', 'name', { unique: false });
store.createIndex('email', 'email', { unique: true });
3. 添加数据(增)
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('添加失败');
4. 读取数据(查)
let getRequest = store.get(1);
getRequest.onsuccess = function() {
  if (getRequest.result) {
    console.log('找到用户:', getRequest.result);
  } else {
    console.log('未找到');
  }
};
5. 使用索引查询
let index = store.index('email');
let findUser = index.get('zhang@example.com');
findUser.onsuccess = () => console.log('通过邮箱找到:', findUser.result);
6. 更新与删除
  • 更新用 put(),传入已有 key 的对象
  • 删除用 delete(key)

封装建议与最佳实践

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

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

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