CKTIS / JavaScript
IndexedDB: dodajanje, branje, brisanje in zamenjava zapisov
Z metodami `add()`, `getAll()`, `delete()` in `put()` obdeluješ zapise po primarnem ključu. Loči uspeh posamezne zahteve od potrditve celotne transakcije.
Različica: 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() in put() pripadajo vmesniku IDBObjectStore v IndexedDB, ne ECMAScriptu. Shrambo objektov pridobiš iz transakcije. Za dostop do podatkov velja pravilnik istega izvora (shema, gostitelj in vrata); podpora je odvisna od izvajalnega okolja.
add(value) samo vstavi zapis: če primarni ključ že obstaja, zahteva spodleti z napako ConstraintError. put(value) vstavi ali zamenja celotno vrednost pod tem ključem; polj ne združuje. Če je ključ znotraj vrednosti, izpusti drugi argument: keyPath določa, kje je ključ. Pri zunanjem ključu podaj key kot drugi argument, razen če naj ključ dodeli omogočeni generator ključev. Obe metodi shranita strukturirano kopijo vrednosti in ob uspehu v request.result zapišeta ključ. Vrednost, ki je ni mogoče klonirati, na primer funkcija, sinhrono sproži DataCloneError.
getAll() v request.result zapiše tabelo kloniranih vrednosti, brez ločeno priloženih ključev; če ni zadetkov, je rezultat []. Privzeti vrstni red je naraščajoč po primarnem ključu, ne po vrstnem redu vstavljanja. Z getAll(query, count) izbereš ključ ali IDBKeyRange in s pozitivnim count omejiš število rezultatov. Oblika getAll({ query, count, direction }) omogoča tudi izbiro smeri, na primer "prev" za padajoči vrstni red; preveri podporo v ciljnih brskalnikih.
delete(keyOrRange) izbriše zapis po primarnem ključu ali vse zapise v območju IDBKeyRange. Rezultat uspešne zahteve je undefined, tudi če ni bilo zadetkov. Ta metoda ni operator delete v JavaScriptu; za izpraznitev shrambe uporabi clear().
Vse štiri metode takoj vrnejo IDBRequest, ne Promise. Za branje zadošča readonly; običajni zapisi zahtevajo readwrite. Zahteve oddaj, ko je transakcija aktivna, na primer takoj po ustvarjanju ali v obdelovalniku dogodka zahteve, ne pa po čakanju na omrežni odgovor. Napaka zahteve privzeto prekine transakcijo in razveljavi njene spremembe. success zadeva posamezno zahtevo; complete pomeni, da je bila transakcija potrjena.
Primeri
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"}]Zaženi kodo v razvijalski konzoli strani HTTPS, kjer sta IndexedDB in `crypto.randomUUID()` na voljo in je shranjevanje dovoljeno. Po potrditvi transakcije prva vrstica prikaže oba zapisa po vrstnem redu ključev. Druga pokaže, da `put()` ni ohranil polja `tag` in da je `delete()` odstranil zapis s ključem `1`. Koda zapre povezavo in zahteva izbris začasne zbirke podatkov.
Povezane lekcije
- JavaScript · Lekcija 20 · Srednja · Različica: 3
Viri
- 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