CKTIS / JavaScript
IDBTransaction — транзакция в IndexedDB
IDBTransaction обединява операциите в IndexedDB, така че промените да се потвърдят заедно или да се отменят. Научете за обхвата на хранилищата, събитието complete, отказването с abort() и свойството error.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const tx = db.transaction("items", "readwrite");
const store = tx.objectStore("items");
tx.addEventListener("complete", () => {});
tx.addEventListener("abort", () => { console.error(tx.error); });
// To cancel before committing: tx.abort();IDBTransaction обединява атомарно операциите в IndexedDB: всички промени се потвърждават или отменят. db.transaction() задава обхвата на обектните хранилища и режима: readonly за четене, readwrite и за запис. Това е Web API, а не част от ECMAScript; Node 24 не потвърждава наличността му в браузър. Проверете дали indexedDB е наличен в целевата среда.
IDBTransaction.objectStore(name) връща препратка към хранилище в обхвата на транзакцията; различно име предизвиква NotFoundError. Задавайте операции, докато транзакцията е активна, обикновено веднага след създаването ѝ или в обработчиците на събития за нейните заявки. Изчакването на несвързана асинхронна работа може да позволи транзакцията да завърши автоматично.
IDBTransaction.complete обозначава събитието complete, което се обработва чрез oncomplete или addEventListener; това не е метод. То потвърждава завършването; success на отделна заявка не го гарантира. IDBTransaction.abort() отменя промените и води до събитие abort; извикването му по време на потвърждаване или след завършване предизвиква InvalidStateError.
IDBTransaction.error е свойство, което съдържа DOMException, описващ неуспеха, или null, включително след ръчно извикване на abort(). Не го бъркайте със събитието error: грешките на заявките могат да се разпространят до транзакцията.
Ако базата данни се отвори и операциите протекат според очакванията, кодът записва 42 с ключ "answer" и изчаква събитието complete, което потвърждава записа. След това прекратява отделна транзакция, която записва 99, прочита запазената стойност 42 и я извежда. При показаното изпълнение отварянето на базата данни завършва с грешка SecurityError, преди да започне каквато и да е транзакция. Затова резултатът Transaction not started: SecurityError не показва нито запис, нито потвърждаване на транзакция.
Примери
(async () => {
const name = `cktis-transaction-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
const result = request => new Promise((resolve, reject) => {
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
const completed = tx => new Promise((resolve, reject) => {
tx.oncomplete = resolve;
tx.onabort = () => reject(tx.error ?? new DOMException('Transaction aborted', 'AbortError'));
});
let db;
try {
const open = indexedDB.open(name, 1);
open.onupgradeneeded = () => open.result.createObjectStore('items');
db = await result(open);
const write = db.transaction('items', 'readwrite');
const scope = Array.from(write.objectStoreNames).join(', ');
const committed = completed(write);
write.objectStore('items').put(42, 'answer');
await committed;
const undo = db.transaction('items', 'readwrite');
const aborted = new Promise((resolve, reject) => {
undo.onabort = () => resolve(undo.error);
undo.oncomplete = () => reject(new Error('Expected an abort'));
});
const update = undo.objectStore('items').put(99, 'answer');
update.onsuccess = () => undo.abort();
const abortError = await aborted;
const read = db.transaction('items', 'readonly');
const [stored] = await Promise.all([
result(read.objectStore('items').get('answer')),
completed(read)
]);
console.log(`Scope: ${scope}; stored after rollback: ${stored}; abort error: ${abortError?.name ?? 'null'}`);
} catch (error) {
if (!db && error.name === 'SecurityError') {
console.log(`Transaction not started: ${error.name}`);
} else {
console.log(`Transaction example failed: ${error.name}`);
}
} finally {
if (db) {
db.close();
await result(indexedDB.deleteDatabase(name));
}
}
})();Резултат
Transaction not started: SecurityError
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.