JavaScript存储机制_IndexedDB事务操作指南-js教程-PHP中文网

JavaScript存储机制_IndexedDB事务操作指南

狼影

发布： 2025-11-22 12:59:27

原创

446人浏览过

IndexedDB通过事务管理数据操作，确保一致性与完整性。事务需指定作用域和模式（readonly、readwrite或versionchange），并在事件循环空闲时自动关闭。所有读写操作必须在事务中执行，且应监听oncomplete和onerror事件以处理结果。事务支持回滚机制，如主键冲突等错误会触发回滚，保证数据安全。批量操作应合并到同一读写事务中以提升性能，避免跨事务引用对象仓库。掌握事务生命周期和作用域规则是高效使用IndexedDB的关键。

javascript存储机制_indexeddb事务操作指南

IndexedDB 是一种在客户端存储大量结构化数据的浏览器数据库，适合需要离线功能或持久化缓存的应用。它支持事务机制来保证数据的一致性和完整性。掌握事务操作是使用 IndexedDB 的核心。

理解 IndexedDB 事务的基本概念

IndexedDB 使用事务（transaction）来组织对数据库的操作。所有对对象仓库（object store）的读写都必须在事务中进行。事务确保一组操作要么全部成功，要么全部失败，避免数据处于中间状态。

一个事务有三种模式：

readonly：只读事务，用于查询数据，性能最优。
readwrite：读写事务，用于添加、更新或删除数据。
versionchange：用于数据库升级（如创建/删除对象仓库），通常在 onupgradeneeded 中自动触发。

事务的生命周期很短——一旦你启动事务并执行操作，它会在所有请求完成且事件循环空闲时自动关闭，因此不能延迟使用。

立即学习“Java免费学习笔记（深入）”；

创建和使用事务的步骤

要执行事务操作，你需要从打开的数据库实例开始，明确指定作用范围和模式。

示例：向用户表添加一条记录

<pre class="brush:php;toolbar:false;">
const request = indexedDB.open('MyDatabase', 1);

request.onsuccess = function(event) {
  const db = event.target.result;

  // 创建一个读写事务，作用于 'users' 对象仓库
  const transaction = db.transaction(['users'], 'readwrite');
  const store = transaction.objectStore('users');

  // 添加数据
  const addRequest = store.add({ id: 1, name: 'Alice' });

  addRequest.onsuccess = () => console.log('数据添加成功');
  addRequest.onerror = () => console.error('添加失败:', addRequest.error);

  // 监听事务完成
  transaction.oncomplete = () => console.log('事务已完成');
  transaction.onerror = (e) => console.error('事务出错:', e.target.error);
};

登录后复制

注意：

Flawless AI

好莱坞2.0，电影制作领域的生成式AI工具

查看详情

事务的作用域是传入的第一个参数——数组中的对象仓库名。
即使只有一个对象仓库，也必须以数组形式传入。
事务是异步的，不能用同步方式判断结果，应通过事件监听处理结果。

处理事务的错误与回滚

如果事务中任意一个操作失败，整个事务会回滚（rollback），所有已执行的变更将被撤销。这是 IndexedDB 保证数据一致性的关键机制。

常见错误场景包括主键冲突、对象仓库不存在、权限问题等。

你可以通过监听 transaction.onerror 和检查 event.target.error 来定位问题。

示例：捕获主键重复错误

<pre class="brush:php;toolbar:false;">
transaction.onerror = function(event) {
  const error = event.target.error;
  if (error.name === 'ConstraintError') {
    console.warn('主键冲突，无法添加重复ID');
  } else {
    console.error('事务错误:', error);
  }
};

登录后复制

某些错误（如 ConstraintError）可以通过提前查询或使用 put 替代 add 来规避。