CKTIS / JavaScript
IDBTransaction — una transazione IndexedDB
IDBTransaction raggruppa le operazioni IndexedDB, così le modifiche vengono confermate insieme o annullate. Scopri l’ambito degli archivi, l’evento complete, l’annullamento con abort() e la proprietà error.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
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 raggruppa atomicamente le operazioni IndexedDB: tutte le modifiche vengono confermate o annullate. db.transaction() specifica l’ambito degli object store e la modalità: readonly per leggere, readwrite anche per scrivere. È una Web API, non fa parte di ECMAScript; Node 24 non ne conferma la disponibilità nel browser. Verifica la presenza di indexedDB nell’ambiente di destinazione.
IDBTransaction.objectStore(name) restituisce un riferimento a uno store compreso nell’ambito della transazione; un nome diverso causa NotFoundError. Accoda le operazioni mentre la transazione è attiva, di solito subito dopo la creazione o nei gestori degli eventi delle sue richieste. Attendere operazioni asincrone non correlate può consentire alla transazione di terminare automaticamente.
IDBTransaction.complete indica l’evento complete, gestito tramite oncomplete o addEventListener, e non un metodo. Conferma il completamento; il success di una singola richiesta non lo garantisce. IDBTransaction.abort() annulla le modifiche e genera un evento abort; chiamarlo durante il completamento o dopo la fine causa InvalidStateError.
IDBTransaction.error è una proprietà che contiene una DOMException che descrive l’errore, oppure null, anche dopo un abort() manuale. Non confonderla con l’evento error: gli errori delle richieste possono propagarsi alla transazione.
Se il database si apre e le operazioni procedono come previsto, il codice scrive 42 con la chiave "answer" e attende l’evento complete che conferma la scrittura. Poi interrompe un’altra transazione che scrive 99, rilegge il valore rimasto, 42, e lo stampa. Nell’esecuzione mostrata, l’apertura del database non riesce e genera SecurityError prima che inizi qualsiasi transazione. L’output Transaction not started: SecurityError non mostra quindi né una scrittura né la sua conferma.
Esempi
(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));
}
}
})();Risultato
Transaction not started: SecurityError
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.