CKTIS / JavaScript
IndexedDB: dodavanje, čitanje, brisanje i zamjena zapisa
Metodama `add()`, `getAll()`, `delete()` i `put()` radiš sa zapisima prema primarnom ključu. Uspjeh pojedinačnog zahtjeva ne znači da je transakcija potvrđena.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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)Metode add(), getAll(), delete() i put() dio su IndexedDB sučelja IDBObjectStore, a ne ECMAScripta. Spremište objekata dobivaš iz transakcije. Pristup podacima slijedi pravilo istog podrijetla (shema, poslužitelj i port); podrška ovisi o izvršnom okruženju.
add(value) samo umeće: ako primarni ključ već postoji, zahtjev ne uspijeva uz pogrešku ConstraintError. put(value) umeće ili zamjenjuje cijelu vrijednost pod tim ključem; ne spaja polja. Kod ključa unutar vrijednosti izostavi drugi argument: keyPath određuje gdje je ključ. Kod vanjskog ključa proslijedi key kao drugi argument, osim ako ga treba dodijeliti uključeni generator ključeva. Obje metode spremaju strukturiranu kopiju vrijednosti i pri uspjehu postavljaju request.result na ključ. Vrijednost koja se ne može klonirati, primjerice funkcija, sinkrono izaziva DataCloneError.
getAll() u request.result stavlja niz kloniranih vrijednosti bez zasebno priloženih ključeva; ako nema podudaranja, rezultat je []. Zadani je redoslijed uzlazan prema primarnom ključu, a ne prema redoslijedu umetanja. Pomoću getAll(query, count) odabireš ključ ili IDBKeyRange i ograničavaš broj rezultata pozitivnim count. Oblik getAll({ query, count, direction }) omogućuje i odabir smjera, primjerice "prev" za silazni redoslijed; provjeri podržavaju li ga ciljani preglednici.
delete(keyOrRange) briše zapis prema primarnom ključu ili sve zapise u rasponu IDBKeyRange. Rezultat uspješnog zahtjeva je undefined, čak i kad nema podudaranja. Metoda nije JavaScriptov operator delete; za pražnjenje spremišta upotrijebi clear().
Sve četiri metode odmah vraćaju IDBRequest, a ne Promise. Za čitanje je dovoljan readonly; uobičajeni upisi zahtijevaju readwrite. Zahtjeve stavljaj u red dok je transakcija aktivna, primjerice pri stvaranju ili u rukovatelju događaja zahtjeva, a ne nakon čekanja mrežnog odgovora. Pogreška zahtjeva prema zadanim postavkama prekida transakciju i poništava njezine promjene. success se odnosi na jedan zahtjev; complete znači da je transakcija potvrđena.
Primjeri
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));Rezultat
[{"id":1,"title":"Remove me"},{"id":2,"title":"Draft","tag":"temporary"}]
[{"id":2,"title":"Published"}]Pokreni kôd u razvojnoj konzoli HTTPS stranice na kojoj su dostupni IndexedDB i `crypto.randomUUID()` te je dopuštena pohrana podataka. Nakon potvrde transakcije prvi redak prikazuje oba zapisa prema redoslijedu ključeva. Drugi pokazuje da `put()` nije zadržao polje `tag` i da je `delete()` obrisao zapis s ključem `1`. Kôd zatvara vezu i traži brisanje privremene baze podataka.
Povezane lekcije
- JavaScript · Lekcija 20 · Srednje · Verzija: 3
Izvori
- 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