CKTIS / JavaScript
IDBTransaction — eine IndexedDB-Transaktion
IDBTransaction fasst IndexedDB-Operationen zusammen, sodass Änderungen gemeinsam übernommen oder zurückgerollt werden. Erfahre mehr über den Speicherbereich, das complete-Ereignis, den Abbruch mit abort() und die error-Eigenschaft.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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 fasst IndexedDB-Operationen atomar zusammen: Alle Änderungen werden übernommen oder zurückgerollt. db.transaction() legt den Bereich der Objektspeicher und den Modus fest: readonly zum Lesen, readwrite auch zum Schreiben. Dies ist eine Web API und kein Bestandteil von ECMAScript; Node 24 belegt nicht, dass sie im Browser verfügbar ist. Prüfe im Zielumfeld, ob indexedDB vorhanden ist.
IDBTransaction.objectStore(name) gibt einen Verweis auf einen Speicher innerhalb des Transaktionsbereichs zurück; ein anderer Name führt zu NotFoundError. Stelle Operationen ein, solange die Transaktion aktiv ist, meist direkt nach ihrer Erstellung oder in den Ereignis-Handlern ihrer Anfragen. Das Warten auf nicht damit zusammenhängende asynchrone Arbeit kann dazu führen, dass die Transaktion automatisch abgeschlossen wird.
IDBTransaction.complete bezeichnet das complete-Ereignis, das über oncomplete oder addEventListener behandelt wird, und keine Methode. Es bestätigt den Abschluss; das success-Ereignis einer einzelnen Anfrage garantiert diesen nicht. IDBTransaction.abort() rollt Änderungen zurück und löst ein abort-Ereignis aus. Ein Aufruf während des Abschlusses oder danach wirft InvalidStateError.
IDBTransaction.error ist eine Eigenschaft, die eine den Fehler beschreibende DOMException oder null enthält, auch nach einem manuellen abort(). Verwechsle sie nicht mit dem error-Ereignis: Fehler von Anfragen können bis zur Transaktion weitergegeben werden.
Wenn sich die Datenbank öffnen lässt und die Operationen wie vorgesehen ablaufen, schreibt der Code 42 unter dem Schlüssel "answer" und wartet auf complete als Bestätigung dafür, dass die Änderung übernommen wurde. Anschließend bricht er eine separate Transaktion ab, die 99 schreibt, liest den erhalten gebliebenen Wert 42 und gibt ihn aus. Im gezeigten Lauf schlägt das Öffnen der Datenbank mit SecurityError fehl, bevor eine Transaktion beginnt. Die Ausgabe Transaction not started: SecurityError zeigt daher weder einen Schreibvorgang noch die Übernahme einer Änderung.
Beispiele
(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));
}
}
})();Ergebnis
Transaction not started: SecurityError
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.