CKTIS / JavaScript
IndexedDB: stvaranje spremišta objekata i otvaranje transakcija
Upotrijebi `createObjectStore()` za promjenu sheme pri nadogradnji baze, a `transaction()` za čitanje ili pisanje zapisa u postojećim spremištima.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
db.createObjectStore(name) → IDBObjectStore
db.createObjectStore(name, options) → IDBObjectStore
db.transaction(storeNames) → IDBTransaction
db.transaction(storeNames, mode) → IDBTransaction
db.transaction(storeNames, mode, options) → IDBTransactionIDBDatabase predstavlja otvorenu vezu s bazom IndexedDB. db.createObjectStore(name, options) odmah vraća novi IDBObjectStore, ali radi samo unutar aktivne transakcije versionchange. IndexedDB je pokreće kad indexedDB.open() stvara bazu ili je otvara s višom verzijom. Shemu mijenjaj u rukovatelju događajem upgradeneeded. Otvorena veza na drugoj kartici može blokirati nadogradnju: zahtjev za otvaranje izaziva blocked, a stara veza može pozvati close() kao odgovor na versionchange.
Neobavezni keyPath određuje odakle se iz vrijednosti uzima ključ, primjerice iz id. Niz putanja definira složeni ključ; bez putanje ključ se pohranjuje zasebno. Zadana vrijednost za autoIncrement je false; true uključuje generator ključeva, ali ne može se kombinirati s praznim znakovnim nizom ili nizom putanja kao keyPath (InvalidAccessError). Duplicirano ime spremišta uzrokuje ConstraintError, nevaljana putanja ključa SyntaxError, a poziv bez transakcije nadogradnje InvalidStateError.
db.transaction(storeNames, mode, options) odmah vraća IDBTransaction čiji opseg određuje jedno ime spremišta zadano kao znakovni niz ili neprazan iterabilni objekt s imenima postojećih spremišta, primjerice niz ili Set. Spremištu iz tog opsega pristupi preko tx.objectStore(name). Zadani način "readonly" dopušta samo čitanje; "readwrite" dopušta i pisanje. Ovdje ne možeš odabrati "versionchange" (TypeError). Nepoznato spremište uzrokuje NotFoundError, prazan popis InvalidAccessError, a zatvorena veza ili veza koja se zatvara InvalidStateError. Neobavezni options.durability ("default", "strict", "relaxed") izražava željenu trajnost podataka pri potvrdi transakcije; provjeri podršku u ciljanim preglednicima.
Zahtjeve stavljaj u red samo dok je transakcija aktivna: u zadatku koji ju je stvorio ili u rukovatelju success ili error nekog od njezinih zahtjeva. Nakon await fetch(...) transakcija se možda već automatski potvrdila pa kasniji zahtjev može izazvati TransactionInactiveError. Uspjeh zahtjeva ne znači da je uspjela i transakcija. complete potvrđuje dovršetak transakcije, a abort znači da su promjene poništene.
IndexedDB je web-API, a ne dio ECMAScripta 2024. Pristup je ograničen na isto podrijetlo (origin); postavke preglednika mogu ograničiti pristup pohrani ili vrijeme čuvanja podataka.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IndexedDB example</title>
</head>
<body>
<script>
(async () => {
const idb = window.indexedDB;
const name = `cktis-notes-${crypto.randomUUID()}`;
const requestResult = (request) => new Promise((resolve, reject) => {
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
const finished = (tx) => new Promise((resolve, reject) => {
tx.oncomplete = () => resolve();
tx.onabort = () => reject(tx.error ?? new Error("Transaction aborted"));
});
const open = idb.open(name, 1);
open.onupgradeneeded = () => {
open.result.createObjectStore("notes", { keyPath: "id" });
};
const db = await requestResult(open);
db.onversionchange = () => db.close();
let title;
try {
const write = db.transaction("notes", "readwrite");
write.objectStore("notes").put({ id: 1, title: "IndexedDB" });
await finished(write);
const read = db.transaction("notes");
const get = read.objectStore("notes").get(1);
await finished(read);
title = get.result.title;
} finally {
db.close();
await requestResult(idb.deleteDatabase(name));
}
console.log(title);
})().catch((error) => console.error(error));
</script>
</body>
</html>Rezultat
IndexedDB
Posluži HTML datoteku putem HTTPS-a i otvori je u pregledniku u kojem je pohrana dopuštena. Primjer stvara bazu s nasumičnim imenom, čita zapis nakon potvrde pisanja, zatvara i briše bazu te na kraju ispisuje `IndexedDB` u konzoli preglednika.
Povezane lekcije
- JavaScript · Lekcija 31 · Napredno · Verzija: 4
Izvori
- IDBDatabase: createObjectStore() method
- IDBDatabase: transaction() method
- IDBFactory: open() method
- Using IndexedDB
- IDBTransaction
- IDBTransaction: durability property
- IndexedDB key characteristics and basic terminology
- IDBObjectStore: put() method
- IDBObjectStore: get() method
- IDBFactory: deleteDatabase() method
- Crypto: randomUUID() method
- ECMAScript® 2024 Language Specification — Overview