CKTIS / JavaScript
IDBTransaction — una transacción de IndexedDB
IDBTransaction agrupa operaciones de IndexedDB para que los cambios se confirmen juntos o se reviertan. Aprende sobre el ámbito de los almacenes, el evento complete, la cancelación con abort() y la propiedad error.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
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 agrupa operaciones de IndexedDB de forma atómica: todos los cambios se confirman o se revierten. db.transaction() especifica el ámbito de los almacenes de objetos y el modo: readonly para leer y readwrite también para escribir. Es una Web API, no forma parte de ECMAScript; Node 24 no permite confirmar su disponibilidad en el navegador. Comprueba si indexedDB existe en el entorno de destino.
IDBTransaction.objectStore(name) devuelve una referencia a un almacén dentro del ámbito de la transacción; otro nombre provoca NotFoundError. Programa las operaciones mientras la transacción esté activa, normalmente justo después de crearla o en los controladores de eventos de sus solicitudes. Esperar a operaciones asíncronas no relacionadas puede permitir que la transacción finalice automáticamente.
IDBTransaction.complete designa el evento complete, que se gestiona mediante oncomplete o addEventListener; no es un método. Confirma que se ha completado la transacción; el success de una solicitud individual no lo garantiza. IDBTransaction.abort() revierte los cambios y provoca un evento abort; llamarlo durante la confirmación o después de finalizar provoca InvalidStateError.
IDBTransaction.error es una propiedad que contiene una DOMException que describe el fallo, o null, también después de un abort() manual. No la confundas con el evento error: los errores de las solicitudes pueden propagarse a la transacción.
Si la base de datos se abre y las operaciones se desarrollan según lo previsto, el código escribe 42 con la clave "answer" y espera a que complete confirme la transacción. Después aborta otra transacción que escribe 99, lee el valor que se conserva, 42, y lo muestra. En la ejecución mostrada, la apertura de la base de datos falla con SecurityError antes de que comience ninguna transacción. Por tanto, la salida Transaction not started: SecurityError no muestra ni una escritura ni una confirmación.
Ejemplos
(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));
}
}
})();Resultado
Transaction not started: SecurityError
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.