CKTIS / JavaScript
IDBObjectStore — un almacén de registros de IndexedDB
IDBObjectStore expone los registros de IndexedDB mediante una referencia vinculada a una transacción. Permite añadir, reemplazar, leer, eliminar y contar datos, además de utilizar índices secundarios.
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 store = transaction.objectStore(name);
store.createIndex(name, keyPath, options); // upgrade transaction only
store.add(value, key); // key may be omitted
store.put(value, key); // key may be omitted
store.getAll(query, count); // query and count are optional
store.delete(query);
store.count(query); // query is optional
store.index(name);IDBObjectStore es una referencia a un almacén de registros de IndexedDB, vinculada a una transacción concreta. Cada registro tiene una clave principal y un valor que se copia mediante clonación estructurada. keyPath: "id" toma la clave del campo id; con esta configuración, no pases una clave independiente a add() ni a put().
add() inserta un registro; una clave duplicada provoca un error ConstraintError. put() inserta un registro o reemplaza el valor completo asociado a una clave existente: no combina campos. delete(query) elimina registros mediante la clave principal o un rango de claves. Estas operaciones requieren una transacción que permita escrituras. getAll(query?, count?) recupera valores, ordenados por clave principal ascendente de forma predeterminada; count(query?) cuenta los registros coincidentes. Si se omite la consulta, se incluye todo el almacén.
createIndex(name, keyPath, options) crea un índice solo durante una transacción de actualización del esquema, normalmente en onupgradeneeded; unique: true exige que las claves del índice sean únicas. index(name) devuelve un IDBIndex existente para buscar mediante una clave secundaria. Ambos métodos devuelven referencias de forma síncrona; los demás métodos enumerados devuelven IDBRequest, no Promise.
Que una solicitud se complete correctamente no significa que la transacción se haya confirmado: espera a complete y gestiona abort. Encola operaciones mientras la transacción esté activa; esperar a tareas asíncronas no relacionadas puede hacer que deje de estarlo. El ejemplo usa formas de API de IndexedDB 2.0, sin la sobrecarga más reciente de getAll() con un objeto de opciones. Es una API web, no forma parte de ECMAScript; Node 24 no demuestra la compatibilidad con navegadores. Comprueba que indexedDB esté disponible en el entorno de destino.
Identificadores de referencia incluidos en esta entrada: IDBObjectStore.createIndex, IDBObjectStore.add, IDBObjectStore.getAll, IDBObjectStore.delete, IDBObjectStore.put, IDBObjectStore.count, IDBObjectStore.index.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IDBObjectStore: working with records</title>
</head>
<body>
<h1>Working with an IndexedDB object store</h1>
<script>
(() => {
const name = 'cktis-store-' + crypto.getRandomValues(new Uint32Array(4)).join('-');
const report = error => console.log(error.name === 'SecurityError'
? 'IndexedDB unavailable: SecurityError' : `IndexedDB error: ${error.name}`);
let factory, opening;
try {
factory = window.indexedDB;
if (!factory) {
console.log('IndexedDB unavailable: API missing');
return;
}
opening = factory.open(name, 1);
} catch (error) {
report(error);
return;
}
let created = false;
opening.onerror = () => report(opening.error);
opening.onupgradeneeded = () => {
created = true;
const store = opening.result.createObjectStore('items', { keyPath: 'id' });
store.createIndex('byLabel', 'label', { unique: true });
};
opening.onsuccess = () => {
const db = opening.result;
if (!created) {
db.close();
console.log('Fixture name already in use');
return;
}
const tx = db.transaction('items', 'readwrite');
const store = tx.objectStore('items');
store.add({ id: 1, label: 'draft' });
store.add({ id: 2, label: 'spare' });
store.put({ id: 1, label: 'final' });
store.delete(2);
const all = store.getAll();
const count = store.count();
const indexed = store.index('byLabel').get('final');
const cleanup = () => {
db.close();
factory.deleteDatabase(name);
};
tx.oncomplete = () => {
console.log(JSON.stringify({ items: all.result, count: count.result, indexedId: indexed.result.id }));
cleanup();
};
tx.onabort = () => {
report(tx.error);
cleanup();
};
};
})();
</script>
</body>
</html>Resultado
Successful browser run (IndexedDB access permitted):
{"items":[{"id":1,"label":"final"}],"count":1,"indexedId":1}
If the browser blocks IndexedDB access with a SecurityError, as in the isolated environment:
IndexedDB unavailable: SecurityErrorEl 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.