CKTIS / JavaScript
IDBTransaction — une transaction IndexedDB
IDBTransaction regroupe les opérations IndexedDB afin que les modifications soient validées ensemble ou annulées. Découvrez la portée des magasins, l’événement complete, l’annulation avec abort() et la propriété error.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 regroupe les opérations IndexedDB de manière atomique : toutes les modifications sont validées ou annulées. db.transaction() définit la portée des magasins d’objets et le mode : readonly pour lire, readwrite également pour écrire. Il s’agit d’une Web API, et non d’un élément d’ECMAScript ; Node 24 ne permet pas d’établir sa disponibilité dans un navigateur. Vérifiez la présence de indexedDB dans l’environnement cible.
IDBTransaction.objectStore(name) renvoie une référence vers un magasin compris dans la portée de la transaction ; un autre nom provoque NotFoundError. Planifiez les opérations pendant que la transaction est active, généralement juste après sa création ou dans les gestionnaires d’événements de ses requêtes. Attendre des opérations asynchrones sans rapport peut permettre à la transaction de se terminer automatiquement.
IDBTransaction.complete désigne l’événement complete, traité avec oncomplete ou addEventListener, et non une méthode. Il confirme la validation ; le success d’une requête individuelle ne la garantit pas. IDBTransaction.abort() annule les modifications et déclenche un événement abort ; l’appeler pendant la validation ou après la fin provoque InvalidStateError.
IDBTransaction.error est une propriété contenant une DOMException décrivant l’échec, ou null, y compris après un abort() manuel. Ne la confondez pas avec l’événement error : les erreurs de requêtes peuvent remonter jusqu’à la transaction.
Si la base de données s’ouvre et que les opérations se déroulent comme prévu, le code écrit 42 sous la clé "answer" et attend l’événement complete qui confirme la validation. Il annule ensuite une transaction distincte qui écrit 99, puis relit et affiche la valeur conservée, 42. Dans l’exécution présentée, l’ouverture de la base de données échoue avec SecurityError avant le début de toute transaction. La sortie Transaction not started: SecurityError ne montre donc ni écriture ni validation.
Exemples
(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));
}
}
})();Résultat
Transaction not started: SecurityError
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.