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 工具函数:
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));
});
}
在测试中这样使用:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
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 被调用。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










