前端数据库 IndexedDB 详解：构建离线 Web 应用
引言：为什么需要前端数据库？
在现代 Web 开发中，我们经常需要处理大量结构化数据。传统的 localStorage 和 sessionStorage 虽然简单易用，但只能存储少量字符串数据，无法满足复杂应用的需求。IndexedDB 应运而生——这是一个功能强大的浏览器内置数据库，支持存储大量结构化数据，提供索引、事务等高级功能，是实现离线应用、缓存机制和复杂数据处理的理想选择。
IndexedDB 核心概念解析
1. 数据库（Database）
- 每个源（协议 + 域名 + 端口）可以创建多个数据库
- 每个数据库包含多个对象存储（类似于 SQL 中的表）
2. 对象存储（Object Store）
- 存储键值对集合的主要容器
- 键可以是路径、自增数字或自定义键生成器
- 值可以是任何结构化可克隆对象
3. 索引（Index）
- 允许高效查询对象存储中的数据
- 可以基于对象属性创建多个索引
- 支持唯一索引约束
4. 事务（Transaction）
- 所有操作都在事务中执行
- 三种模式：只读（readonly）、读写（readwrite）和版本变更（versionchange）
- 提供原子性保证（全部成功或全部失败）
5. 游标（Cursor）
- 用于遍历对象存储或索引中的记录
- 支持方向控制（前进/后退）和范围查询
完整代码示例：实现一个联系人管理器
1. 初始化数据库
// 打开或创建数据库
const dbName = 'ContactDB';
const dbVersion = 1;
const request = indexedDB.open(dbName, dbVersion);
request.onerror = (event) => {
console.error('数据库打开失败:', event.target.error);
};
request.onupgradeneeded = (event) => {
const db = event.target.result;
// 创建对象存储（如果不存在）
if (!db.objectStoreNames.contains('contacts')) {
const store = db.createObjectStore('contacts', {
keyPath: 'id',
autoIncrement: true
});
// 创建索引
store.createIndex('name', 'name', { unique: false });
store.createIndex('email', 'email', { unique: true });
store.createIndex('phone', 'phone', { unique: false });
store.createIndex('group', 'group', { unique: false });
}
};
request.onsuccess = (event) => {
const db = event.target.result;
console.log('数据库成功打开');
// 存储数据库引用供后续使用
window.contactDB = db;
};
2. 添加联系人
function addContact(contact) {
return new Promise((resolve, reject) => {
const tx = window.contactDB.transaction(['contacts'], 'readwrite');
const store = tx.objectStore('contacts');
const request = store.add(contact);
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
}
3. 查询联系人
通过 ID 查询
function getContact(id) {
return new Promise((resolve, reject) => {
const tx = window.contactDB.transaction(['contacts'], 'readonly');
const store = tx.objectStore('contacts');
const request = store.get(id);
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
}
通过索引查询
function searchByName(name) {
return new Promise((resolve, reject) => {
const tx = window.contactDB.transaction(['contacts'], 'readonly');
const store = tx.objectStore('contacts');
const index = store.index('name');
const request = index.getAll(name);
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
}
4. 更新联系人
function updateContact(contact) {
return new Promise((resolve, reject) => {
const tx = window.contactDB.transaction(['contacts'], 'readwrite');
const store = tx.objectStore('contacts');
const request = store.put(contact);
request.onsuccess = () => resolve();
request.onerror = () => reject(request.error);
});
}
5. 删除联系人
function deleteContact(id) {
return new Promise((resolve, reject) => {
const tx = window.contactDB.transaction(['contacts'], 'readwrite');
const store = tx.objectStore('contacts');
const request = store.delete(id);
request.onsuccess = () => resolve();
request.onerror = () => reject(request.error);
});
}
6. 高级查询：使用游标和范围
function listAllContacts() {
return new Promise((resolve, reject) => {
const tx = window.contactDB.transaction(['contacts'], 'readonly');
const store = tx.objectStore('contacts');
const cursorRequest = store.openCursor();
const results = [];
cursorRequest.onsuccess = (event) => {
const cursor = event.target.result;
if (cursor) {
results.push(cursor.value);
cursor.continue();
} else {
resolve(results);
}
};
cursorRequest.onerror = () => reject(cursorRequest.error);
});
}
IndexedDB 最佳实践
- 始终在事务中执行操作以保证数据一致性
- 避免在事务中执行耗时操作，防止阻塞 UI
- 合理设计对象存储的键路径和索引以优化查询性能
- 定期清理过期数据，避免数据库体积过大
IndexedDB 的浏览器支持情况
IndexedDB 在现代浏览器中均有良好支持，包括 Chrome、Firefox、Safari 和 Edge。对于旧版 IE 不支持，但在当前主流开发环境中通常无需考虑兼容性问题。
使用第三方库简化开发
虽然原生 API 功能强大，但异步回调嵌套较深。可以使用 Dexie.js 等第三方库来简化操作，提供更友好的 Promise 接口。
常见应用场景
- 离线 Web 应用数据存储
- 大型表单数据的本地缓存
- 游戏状态保存
- 日志记录与审计
总结
IndexedDB 是前端开发中处理复杂数据结构的重要工具。通过理解其核心概念并掌握基本操作方法，开发者可以构建出功能丰富且体验流畅的离线 Web 应用。
