CKTIS / JavaScript
IndexedDB: přidávání, čtení, mazání a nahrazování záznamů
Pomocí `add()`, `getAll()`, `delete()` a `put()` pracuješ se záznamy podle primárního klíče. Úspěch jednoho požadavku ještě neznamená potvrzení transakce.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
store.add(value)
store.add(value, key)
store.getAll()
store.getAll(query)
store.getAll(query, count)
store.getAll(options)
store.delete(keyOrRange)
store.put(value)
store.put(value, key)Metody add(), getAll(), delete() a put() patří k rozhraní IDBObjectStore v IndexedDB, nikoli k ECMAScriptu. Objektové úložiště získáš z transakce. Přístup k datům se řídí zásadou stejného původu (schéma, hostitel a port); podpora závisí na běhovém prostředí.
add(value) pouze vkládá: pokud primární klíč už existuje, požadavek selže s chybou ConstraintError. put(value) vloží nebo nahradí celou hodnotu pod daným klíčem; neslučuje pole. Je-li klíč uvnitř hodnoty, druhý argument vynech: keyPath určuje, kde klíč najít. U externího klíče předej key jako druhý argument, pokud ho nemá dodat zapnutý generátor klíčů. Obě metody uloží strukturovanou kopii hodnoty a při úspěchu zpřístupní klíč v request.result. Hodnota, kterou nelze klonovat, například funkce, vyvolá synchronní chybu DataCloneError.
getAll() zpřístupní v request.result pole klonovaných hodnot bez samostatně připojených klíčů; pokud nic neodpovídá, výsledkem je []. Výchozí pořadí je vzestupné podle primárního klíče, nikoli podle pořadí vložení. Pomocí getAll(query, count) vybereš klíč nebo IDBKeyRange a kladným count omezíš počet výsledků. Varianta getAll({ query, count, direction }) umožňuje určit i směr, například "prev" pro sestupné pořadí. Ověř její podporu v cílových prohlížečích.
delete(keyOrRange) odstraní záznam podle primárního klíče nebo všechny záznamy v rozsahu IDBKeyRange. Výsledkem úspěšného požadavku je undefined, i když nic neodpovídalo. Metoda není operátor JavaScriptu delete; k vyprázdnění úložiště použij clear().
Všechny čtyři metody okamžitě vracejí IDBRequest, nikoli Promise. Pro čtení stačí readonly; běžné zápisy vyžadují readwrite. Požadavky zadávej, dokud je transakce aktivní, například hned po jejím vytvoření nebo v obsluze události požadavku, ne až po čekání na odpověď ze sítě. Chyba požadavku ve výchozím nastavení přeruší transakci a vrátí její změny zpět. success se týká jednoho požadavku; complete potvrzuje dokončení transakce se zápisem změn.
Příklady
void (async () => {
const { indexedDB, crypto } = globalThis;
if (!indexedDB || typeof crypto?.randomUUID !== 'function') {
throw new Error('Run this example on an HTTPS page in a browser with IndexedDB and crypto.randomUUID() available.');
}
const name = `cktis-idb-${crypto.randomUUID()}`;
const open = indexedDB.open(name, 1);
open.onupgradeneeded = () => {
open.result.createObjectStore('tasks', { keyPath: 'id' });
};
const db = await new Promise((resolve, reject) => {
open.onsuccess = () => resolve(open.result);
open.onerror = () => reject(open.error);
});
try {
const tx = db.transaction('tasks', 'readwrite');
const store = tx.objectStore('tasks');
store.add({ id: 2, title: 'Draft', tag: 'temporary' });
store.add({ id: 1, title: 'Remove me' });
const before = store.getAll();
store.put({ id: 2, title: 'Published' });
store.delete(1);
const after = store.getAll();
await new Promise((resolve, reject) => {
tx.oncomplete = () => resolve();
tx.onabort = () => reject(tx.error ?? new Error('Transaction aborted'));
});
console.log(JSON.stringify(before.result));
console.log(JSON.stringify(after.result));
} finally {
db.close();
const cleanup = indexedDB.deleteDatabase(name);
await new Promise((resolve, reject) => {
cleanup.onsuccess = () => resolve();
cleanup.onerror = () => reject(cleanup.error);
});
}
})().catch((error) => console.error(error));Výsledek
[{"id":1,"title":"Remove me"},{"id":2,"title":"Draft","tag":"temporary"}]
[{"id":2,"title":"Published"}]Spusť kód ve vývojářské konzoli stránky HTTPS, kde jsou dostupné IndexedDB a `crypto.randomUUID()` a je povolené ukládání dat. Po potvrzení transakce první řádek ukáže oba záznamy v pořadí podle klíčů. Druhý ukáže, že `put()` nezachoval pole `tag` a `delete()` odstranil záznam s klíčem `1`. Kód zavře připojení a vyžádá smazání dočasné databáze.
Související lekce
- JavaScript · Lekce 20 · Středně pokročilá · Verze: 3
Zdroje
- IDBObjectStore: add() method
- IDBObjectStore: getAll() method
- IDBObjectStore: delete() method
- IDBObjectStore: put() method
- IDBTransaction
- IDBTransaction: complete event
- IndexedDB key characteristics and basic terminology
- IDBDatabase: createObjectStore() method
- HTML Standard — Safe passing of structured data
- IDBFactory: open() method
- IDBFactory: deleteDatabase() method
- Crypto: randomUUID() method