CKTIS / JavaScript
IndexedDB: stvaranje indeksa, umetanje zapisa i pretraživanje po indeksu
Pri nadogradnji baze stvorite sekundarni indeks, umetnite zapis bez prepisivanja i pronađite ga po ključu indeksa umjesto po primarnom ključu.
Verzija: Current web platform; runtime support varies
Sintaksa
store.createIndex(name, keyPath)
store.createIndex(name, keyPath, { unique, multiEntry })
store.add(value)
store.add(value, key)
store.index(name)createIndex(), add() i index() metode su instance IDBObjectStore u web API-ju IndexedDB, a ne dio ECMAScripta. IndexedDB slijedi pravilo istog podrijetla; dostupnost ovisi o izvršnom okruženju i postavkama pohrane u pregledniku.
store.createIndex(name, keyPath, options) odmah vraća IDBIndex, no promjena sheme postaje trajna tek kad se transakcija potvrdi. Pozovite metodu u aktivnoj transakciji versionchange, obično pri obradi događaja upgradeneeded kada stvarate bazu ili povećavate njezinu verziju. Naziv označava indeks, a putanja ključa određuje odakle se iz zapisa uzima ključ indeksa bez dodavanja novog polja. IndexedDB indeksira postojeće zapise i automatski ažurira indeks.
unique i multiEntry zadano imaju vrijednost false. unique: true zabranjuje jednake ključeve indeksa u različitim zapisima; postojeći duplikati mogu prekinuti nadogradnju. multiEntry: true zasebno indeksira valjane elemente polja umjesto da cijelo polje koristi kao jedan ključ. Opciju nije moguće kombinirati s poljem putanja za složeni ključ (InvalidAccessError). Isti naziv indeksa odmah uzrokuje ConstraintError.
store.add(value[, key]) umeće strukturiranu kopiju bez prepisivanja. Potrebna je aktivna transakcija readwrite ili versionchange. Izostavite key ako je primarni ključ unutar vrijednosti; navedite ga ako je izvan vrijednosti i nema generatora. Ako zahtjev IDBRequest uspije, result sadrži primarni ključ, no tek događaj complete potvrđuje uspješan završetak transakcije. Zbog dupliciranog primarnog ključa ili ključa jedinstvenog indeksa zahtjev ne uspijeva uz ConstraintError. put() može zamijeniti zapis, ali mora poštovati jedinstvenost indeksa.
store.index(name) vraća postojeći IDBIndex vezan uz istu transakciju. Ne stvara indeks niti čita zapis. Nepostojeći naziv uzrokuje NotFoundError; razlikuju se velika i mala slova. U aktivnoj transakciji index.get(key) traži prvi odgovarajući zapis po ključu indeksa, a ne po primarnom ključu. Nakon završetka transakcije taj objekt nemojte upotrebljavati za čitanje.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IndexedDB: insert and look up a contact</title>
</head>
<body>
<script>
(async () => {
const { indexedDB, crypto } = window;
const name = `cktis-index-${crypto.randomUUID()}`;
const resultOf = (request) => new Promise((resolve, reject) => {
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
const committed = (tx) => new Promise((resolve, reject) => {
tx.oncomplete = () => resolve();
tx.onabort = () => reject(tx.error ?? new Error('Transaction aborted'));
});
const open = indexedDB.open(name, 1);
open.onupgradeneeded = () => {
const store = open.result.createObjectStore('contacts', { keyPath: 'id' });
store.createIndex('byEmail', 'email', { unique: true });
};
const db = await resultOf(open);
let contact;
try {
const write = db.transaction('contacts', 'readwrite');
write.objectStore('contacts').add({ id: 7, email: 'ada@example.test' });
await committed(write);
const read = db.transaction('contacts', 'readonly');
const lookup = read.objectStore('contacts').index('byEmail').get('ada@example.test');
await committed(read);
contact = lookup.result;
} finally {
db.close();
await resultOf(indexedDB.deleteDatabase(name));
}
console.log(JSON.stringify(contact));
})().catch((error) => console.error(error));
</script>
</body>
</html>Rezultat
{"id":7,"email":"ada@example.test"}Poslužite HTML datoteku s pouzdane HTTPS adrese i otvorite je u pregledniku u kojem su dostupni IndexedDB i `crypto.randomUUID()`. Primjer stvara zasebnu bazu, nakon potvrde upisa traži zapis po `email`, pa zatvara i briše bazu prije ispisa rezultata u konzoli preglednika.
Povezane lekcije
- JavaScript · Lekcija 31 · Napredno · Verzija: 4