IDBTransaction: abort 事件

当 IndexedDB 事务被中止时，会触发 abort 事件。

这可能由于以下原因发生：

错误的请求（例如，尝试添加相同的键两次，或者在键具有唯一性约束时放入相同的索引键）。
显式调用 abort()。
请求的成功/错误处理程序中未捕获的异常。
I/O 错误（例如，实际写入磁盘失败，例如磁盘分离或其他操作系统/硬件故障）。
超过配额。

此不可取消的事件冒泡到关联的 IDBDatabase 对象。

语法

在方法（如 addEventListener()）中使用事件名，或者设置事件处理程序属性。

addEventListener("abort", (event) => {});
onabort = (event) => {};

事件类型

一个通用的 Event。

冒泡

此事件冒泡到 IDBDatabase。event.target 属性指的是冒泡的 IDBTransaction 对象。

有关更多信息，请参阅事件冒泡。

示例

此示例打开一个数据库（如果数据库不存在则创建它），然后打开一个事务，向 abort 事件添加一个监听器，然后中止事务以触发事件。

// Open the database
const DBOpenRequest = window.indexedDB.open("toDoList", 4);

DBOpenRequest.onupgradeneeded = (event) => {
  const db = event.target.result;

  db.onerror = () => {
    console.log("Error creating database");
  };

  // Create an objectStore for this database
  const objectStore = db.createObjectStore("toDoList", {
    keyPath: "taskTitle",
  });

  // define what data items the objectStore will contain
  objectStore.createIndex("hours", "hours", { unique: false });
  objectStore.createIndex("minutes", "minutes", { unique: false });
  objectStore.createIndex("day", "day", { unique: false });
  objectStore.createIndex("month", "month", { unique: false });
  objectStore.createIndex("year", "year", { unique: false });
};

DBOpenRequest.onsuccess = (event) => {
  const db = DBOpenRequest.result;

  // open a read/write db transaction, ready for adding the data
  const transaction = db.transaction(["toDoList"], "readwrite");

  // add a listener for `abort`
  transaction.addEventListener("abort", () => {
    console.log("Transaction was aborted");
  });

  // abort the transaction
  transaction.abort();
};

相同的示例，但将事件处理程序分配给 onabort 属性

// Open the database
const DBOpenRequest = window.indexedDB.open("toDoList", 4);

DBOpenRequest.onupgradeneeded = (event) => {
  const db = event.target.result;

  db.onerror = () => {
    console.log("Error creating database");
  };

  // Create an objectStore for this database
  const objectStore = db.createObjectStore("toDoList", {
    keyPath: "taskTitle",
  });

  // define what data items the objectStore will contain
  objectStore.createIndex("hours", "hours", { unique: false });
  objectStore.createIndex("minutes", "minutes", { unique: false });
  objectStore.createIndex("day", "day", { unique: false });
  objectStore.createIndex("month", "month", { unique: false });
  objectStore.createIndex("year", "year", { unique: false });
};

DBOpenRequest.onsuccess = (event) => {
  const db = DBOpenRequest.result;

  // open a read/write db transaction, ready for adding the data
  const transaction = db.transaction(["toDoList"], "readwrite");

  // add a listener for `abort`
  transaction.onabort = (event) => {
    console.log("Transaction was aborted");
  };

  // abort the transaction
  transaction.abort();
};

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅

使用 IndexedDB