CKTIS / JavaScript
IndexedDB: records toevoegen, lezen, verwijderen en vervangen
Gebruik `add()`, `getAll()`, `delete()` en `put()` om records op primaire sleutel te bewerken. Een geslaagd verzoek betekent nog niet dat de transactie is vastgelegd.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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)De methoden add(), getAll(), delete() en put() horen bij de IndexedDB-interface IDBObjectStore, niet bij ECMAScript. Je haalt de objectopslag op uit een transactie. Toegang tot de gegevens volgt het beleid voor dezelfde oorsprong (schema, host en poort); de ondersteuning hangt af van de uitvoeromgeving.
add(value) voegt alleen toe: als de primaire sleutel al bestaat, mislukt het verzoek met ConstraintError. put(value) voegt de waarde toe of vervangt de volledige waarde onder die sleutel; velden worden niet samengevoegd. Laat bij een interne sleutel het tweede argument weg: keyPath geeft aan waar de sleutel in de waarde staat. Geef bij een externe sleutel key als tweede argument mee, tenzij een ingeschakelde sleutelgenerator de sleutel moet leveren. Beide methoden slaan een gestructureerde kopie van de waarde op en zetten bij succes de sleutel in request.result. Een waarde die niet kan worden gekloond, zoals een functie, veroorzaakt synchroon een DataCloneError.
getAll() zet in request.result een array met gekloonde waarden, zonder afzonderlijk bijgevoegde sleutels; zonder treffers is het resultaat []. Standaard is de volgorde oplopend op primaire sleutel, niet op invoegvolgorde. Met getAll(query, count) selecteer je een sleutel of een IDBKeyRange en beperk je het aantal resultaten met een positieve count. Met getAll({ query, count, direction }) kun je ook de richting kiezen, bijvoorbeeld "prev" voor aflopende volgorde. Controleer of de beoogde browsers die vorm ondersteunen.
delete(keyOrRange) verwijdert een record op primaire sleutel of alle records in een IDBKeyRange. Bij succes is het resultaat undefined, ook als er geen treffers waren. Dit is niet de JavaScript-operator delete; gebruik clear() om de objectopslag leeg te maken.
Alle vier methoden geven onmiddellijk een IDBRequest terug, geen Promise. Voor lezen volstaat readonly; normale schrijfbewerkingen vereisen readwrite. Plaats verzoeken in de wachtrij terwijl de transactie actief is, bijvoorbeeld bij het aanmaken of in een eventhandler van een verzoek, niet nadat je op een netwerkantwoord hebt gewacht. Een fout in een verzoek breekt de transactie standaard af en draait de wijzigingen terug. success geldt voor één verzoek; complete bevestigt dat de transactie is vastgelegd.
Voorbeelden
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));Resultaat
[{"id":1,"title":"Remove me"},{"id":2,"title":"Draft","tag":"temporary"}]
[{"id":2,"title":"Published"}]Voer de code uit in de ontwikkelaarsconsole van een HTTPS-pagina waar IndexedDB en `crypto.randomUUID()` beschikbaar zijn en opslag is toegestaan. Nadat de transactie is vastgelegd, toont de eerste regel beide records in sleutelvolgorde. De tweede laat zien dat `put()` het veld `tag` niet heeft behouden en dat `delete()` het record met sleutel `1` heeft verwijderd. De code sluit de verbinding en vraagt om verwijdering van de tijdelijke database.
Gerelateerde lessen
- JavaScript · Les 20 · Gemiddeld · Versie: 3
Bronnen
- 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