CKTIS / JavaScript
IDBTransaction — een IndexedDB-transactie
IDBTransaction groepeert IndexedDB-bewerkingen, zodat wijzigingen samen worden vastgelegd of teruggedraaid. Lees over het bereik van object stores, de gebeurtenis complete, annuleren met abort() en de eigenschap error.
Versie: 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 groepeert IndexedDB-bewerkingen atomair: alle wijzigingen worden vastgelegd of teruggedraaid. db.transaction() bepaalt het bereik van de object stores en de modus: readonly om te lezen, readwrite ook om te schrijven. Dit is een Web API en geen onderdeel van ECMAScript; Node 24 bevestigt niet dat deze API in de browser beschikbaar is. Controleer in de doelomgeving of indexedDB aanwezig is.
IDBTransaction.objectStore(name) geeft een verwijzing naar een store binnen het bereik van de transactie; een andere naam veroorzaakt NotFoundError. Plan bewerkingen zolang de transactie actief is, meestal direct na het aanmaken ervan of in de eventhandlers van de verzoeken. Wachten op niet-gerelateerd asynchroon werk kan ertoe leiden dat de transactie automatisch wordt afgerond.
IDBTransaction.complete duidt de gebeurtenis complete aan, die wordt afgehandeld via oncomplete of addEventListener; het is geen methode. De gebeurtenis bevestigt dat de transactie is vastgelegd; het success-event van één verzoek garandeert dat niet. IDBTransaction.abort() draait wijzigingen terug en leidt tot een abort-gebeurtenis; aanroepen tijdens het vastleggen of nadat de transactie is afgerond veroorzaakt InvalidStateError.
IDBTransaction.error is een eigenschap met een DOMException die de fout beschrijft, of null, ook na een handmatige abort(). Verwar deze eigenschap niet met de gebeurtenis error: fouten van verzoeken kunnen doorwerken naar de transactie.
Als de database wordt geopend en de bewerkingen volgens plan verlopen, schrijft de code 42 onder de sleutel "answer" en wacht op complete als bevestiging dat de wijziging is vastgelegd. Daarna breekt de code een afzonderlijke transactie af die 99 schrijft, leest de behouden waarde 42 terug en toont die. In de getoonde uitvoering mislukt het openen van de database met SecurityError voordat er een transactie begint. De uitvoer Transaction not started: SecurityError toont dus geen schrijfbewerking en geen vastlegging.
Voorbeelden
(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));
}
}
})();Resultaat
Transaction not started: SecurityError
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.