IndexedDB异步事务提交的唯一可靠验证方式是监听transaction.complete和transaction.error事件，结合Promise封装实现可等待、可断言的测试；需覆盖complete、error、abort三类事件，并避免依赖readyState或request.onsuccess等不可靠信号。
测试 IndexedDB 异步事务提交，核心是**监听事务的 complete 和 error 事件**，并结合 Promise 封装确保可等待、可断言。直接读取事务状态不可靠（如 transaction.readyState 是只读快照），必须依赖事件驱动验证。
监听 transaction.complete 和 transaction.error
IndexedDB 事务本身不返回 Promise，但它的生命周期由事件明确控制：
-
transaction.oncomplete：事务成功提交后触发（所有请求完成且数据已持久化） -
transaction.onerror：任一请求失败或事务被中止时触发 -
transaction.onabort：事务被显式中止（如调用transaction.abort()）或因错误自动中止
测试时应覆盖这三类事件，并在对应回调中 resolve/reject Promise，从而支持 await 或 then() 断言。
用 Promise 封装事务，便于 Jest/Mocha 等测试框架使用
例如封装一个通用的 runTransaction 工具函数：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
function runTransaction(db, mode, storeName, operation) {
return new Promise((resolve, reject) => {
const tx = db.transaction(storeName, mode);
tx.oncomplete = () => resolve();
tx.onerror = () => reject(tx.error);
tx.onabort = () => reject(new Error('Transaction aborted'));
operation(tx.objectStore(storeName));
});
}
在测试中这样使用：
test('should persist data and trigger complete event', async () => {
const db = await openTestDB(); // 假设已有测试数据库
await runTransaction(db, 'readwrite', 'books', store => {
store.add({ id: 1, title: 'JS Guide' });
});
// ✅ 此时事务已提交，可查询验证
const value = await getFromStore(db, 'books', 1);
expect(value.title).toBe('JS Guide');
});
主动触发 error/abort 场景进行边界测试
仅测成功路径不够。需模拟失败条件验证错误处理是否健壮：
- 写入重复主键（违反 keyPath 约束）→ 触发
request.onerror，进而导致transaction.onerror - 手动调用
transaction.abort()→ 触发transaction.onabort - 在事务中打开已删除的对象存储 → 抛出 InvalidStateError
示例（测试 abort）：
test('should reject when transaction is aborted', async () => {
const db = await openTestDB();
await expect(
runTransaction(db, 'readwrite', 'books', store => {
store.add({ id: 2, title: 'Aborted Book' });
// 立即中止
store.transaction.abort();
})
).rejects.toThrow('Transaction aborted');
});
避免常见误区
以下做法无法可靠测试事务提交：
- 检查
transaction.readyState === 'done'—— 该属性在事件触发前就可能变为'done'，不能作为提交依据 - 在
request.onsuccess后立即读取数据 —— 此时事务可能尚未提交，其他事务还看不到变更（尤其在并发场景） - 忽略事件冒泡顺序 ——
request.onerror先于transaction.onerror，但最终提交结果以事务事件为准
真正代表“已提交”的唯一信号，是 transaction.oncomplete 被调用。
