JavaScript 中怎么使用事务机制保证 IndexedDB 操作的原子性

云丽大大_7660

云丽大大_7660

2026-09-08

743人浏览

原创

indexeddb事务天然具备原子性,无需手动提交或回滚:任一操作失败则整个事务自动回滚;所有操作须在同一readwrite事务中并正确处理错误,否则破坏原子性。

javascript 中怎么使用事务机制保证 indexeddb 操作的原子性

IndexedDB 本身不提供显式的“事务提交/回滚”API,但它的事务机制天然具备原子性——只要事务中任意一个操作失败(如键重复、存储空间不足、对象存储不存在等),整个事务会自动中止,已执行的写操作全部撤销。

事务的原子性由 IndexedDB 自动保障

你不需要手动调用 commit() 或 rollback()。IndexedDB 的事务是隐式提交的:当所有请求成功完成、且事务未被主动中止或未发生未捕获错误时,事务自动提交;一旦有请求失败(比如 add() 遇到重复主键),或你在回调中抛出异常、或调用 transaction.abort(),整个事务立即回滚,之前对数据库的修改(add、put、delete)全部失效。

关键点:

  • 事务生命周期由你创建的请求决定:事务保持活跃直到所有已发起的请求完成(成功或失败),且没有新的请求被发出
  • 所有对同一事务的读写操作共享快照视图(即事务内读不到其他事务未提交的变更)
  • 写操作必须在事务处于 active 状态时执行;事务进入 inactive 或 finished 后再调用 put() 会直接报错

正确使用 readwrite 事务保证多步写入原子性

当你需要多个写操作(例如先删旧记录、再存新数据)一起成功或一起失败时,必须把它们放在同一个 "readwrite" 事务中,并监听每个请求的 success/error。

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

示例:替换用户配置,要求“删除旧配置 + 写入新配置”要么全成功,要么全不生效:

const request = indexedDB.open("MyAppDB", 1);
request.onsuccess = function(event) {
  const db = event.target.result;
  const tx = db.transaction(["settings"], "readwrite");
  const store = tx.objectStore("settings");

  // 先删旧配置(假设 key 是 "userPrefs")
  const deleteReq = store.delete("userPrefs");
  deleteReq.onsuccess = function() {
    // 删除成功后写入新数据
    const putReq = store.put({ theme: "dark", lang: "zh" }, "userPrefs");
    putReq.onsuccess = function() {
      console.log("配置已原子更新");
    };
    putReq.onerror = function() {
      console.error("写入失败 → 整个事务将自动回滚");
    };
  };
  deleteReq.onerror = function() {
    console.error("删除失败 → 事务已中止,后续 put 不会执行");
  };
};

避免常见破坏原子性的错误

以下做法会让本应原子的操作失去一致性保障:

  • 跨事务操作:把 delete 和 put 分到两个独立事务里 → 它们互不影响,中间可能被其他写入干扰
  • 忽略请求错误:只监听 success,不处理 onerror → 错误被静默吞掉,你以为成功了,其实 delete 已失败,但 put 还是执行了(如果它在另一个事务里)
  • 异步逻辑跳出事务上下文:比如在 delete.success 里用 setTimeout 延迟执行 put → 此时事务很可能已结束,put 会抛出 InvalidStateError
  • 混用不同事务模式:对同一 objectStore,一个事务用 "readwrite",另一个用 "readonly" 并发读取 —— 虽不破坏原子性,但可能读到旧值;真正危险的是多个 "readwrite" 事务并发写同一 key,IndexedDB 会排队执行,仍能保证每个事务自身原子,但需注意顺序依赖

利用 error 事件统一捕获事务级失败

比逐个监听每个请求更简洁的方式是监听事务本身的 onerroronabort

const tx = db.transaction(["users"], "readwrite");
tx.onerror = function(event) {
  console.error("事务因某个请求失败而中止", event.target.error);
  // 此处可触发 UI 提示、重试逻辑等
};
tx.onabort = function() {
  console.log("事务被显式中止或遇到不可恢复错误");
};
tx.oncomplete = function() {
  console.log("事务所有请求成功完成,已提交");
};

const store = tx.objectStore("users");
store.put({ id: 1, name: "Alice" }, 1);
store.put({ id: 1, name: "Bob" }, 1); // 主键冲突 → 触发 tx.onerror

注意:onerror 在任意请求失败时触发,onabort 在事务被中止(如调用 tx.abort())或发生严重错误(如磁盘满)时触发,oncomplete 仅在全部请求成功后触发。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

javascript java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4166

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1049

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4044

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

840

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1716

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3045

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

3953

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

2520

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

828

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习