CKTIS / JavaScript
IDBRequest: rezultat i pogreška zahtjeva
Saznajte kada čitati `result` i `error` u IndexedDB-u te kako razlikovati uspjeh pojedinačnog zahtjeva od potvrde transakcije.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
request.readyState; // "pending" or "done"
request.result; // operation-specific value on success; undefined on failure
request.error; // null on success; DOMException on failure
// Reading result or error while readyState is "pending" throws InvalidStateError.result i error dva su svojstva instance IDBRequest koja se mogu samo čitati. Zahtjev u IndexedDB-u predstavlja asinkronu operaciju. Nije Promise, pa await request ne čeka dovršetak operacije. IndexedDB je API web-platforme, nije dio ECMAScripta 2024 i njegova dostupnost ovisi o izvršnom okruženju.
Dok je request.readyState jednak "pending", čitanje bilo kojeg od tih svojstava izaziva iznimku DOMException s nazivom InvalidStateError. Stanje "done" samo po sebi ne znači uspjeh. Rezultat se obično čita u funkciji koja obrađuje događaj success. Iznimka: u obradi događaja upgradeneeded zahtjeva indexedDB.open() svojstvo result već je dostupno za izmjenu sheme, iako završni događaj success još nije nastupio.
Pri događaju success, error je null, a result ovisi o operaciji: open() daje vezu IDBDatabase, add() daje ključ spremljenog zapisa, a get() može dati undefined ako ključu ne odgovara nijedan zapis. Pri događaju error, result je undefined, a error sadrži DOMException. Provjerite request.error.name kako biste prepoznali pogrešku kao što je ConstraintError. Sama vrijednost undefined ne znači neuspjeh. try...catch oko poziva API-ja hvata sinkrone iznimke, ali ne i pogreške koje se kasnije prijave događajem error.
Uspješan zahtjev za zapisivanje ne znači da je transakcija potvrđena. Osluškujte complete za potvrdu transakcije, a abort za otkrivanje poništavanja promjena. Pogreška zahtjeva unutar transakcije po zadanom je prekida. Ako je pogreška očekivana i može se sigurno obraditi, pozovite event.preventDefault() pri obradi događaja error tog zahtjeva. Time sprječavate zadani prekid transakcije, ali zahtjev ostaje neuspješan.
Primjeri
<!doctype html>
<meta charset="utf-8">
<title>IDBRequest result and error</title>
<script>
(() => {
const { indexedDB, crypto } = window;
const name = `cktis-idbrequest-${crypto.randomUUID()}`;
const open = indexedDB.open(name, 1);
open.onupgradeneeded = () => open.result.createObjectStore("items");
open.onerror = () => console.error("open:", open.error.name);
open.onsuccess = () => {
const db = open.result;
const tx = db.transaction("items", "readwrite");
const store = tx.objectStore("items");
const cleanup = () => {
db.close();
const removal = indexedDB.deleteDatabase(name);
removal.onerror = () => console.error("cleanup:", removal.error.name);
};
tx.oncomplete = () => {
console.log("transaction: complete");
cleanup();
};
tx.onabort = () => {
console.error("transaction: abort", tx.error?.name);
cleanup();
};
const first = store.add("first", 1);
first.onsuccess = () => {
console.log(`first: result=${first.result}, error=${first.error}`);
const second = store.add("second", 1);
second.onerror = (event) => {
if (second.error.name === "ConstraintError") event.preventDefault();
console.log(`second: result=${second.result}, error=${second.error.name}`);
};
};
};
})();
</script>Rezultat
first: result=1, error=null second: result=undefined, error=ConstraintError transaction: complete
Otvorite primjer kao HTML stranicu preko HTTPS-a na kojoj su dostupni IndexedDB i `crypto.randomUUID()`. Provjerite poruke u konzoli preglednika. Drugi poziv `add()` pokušava upotrijebiti isti ključ. Obrada pogreške sprječava zadani prekid samo za očekivani `ConstraintError`, pa se prvi upis može potvrditi. Nakon završetka transakcije kôd zatvara vezu i traži brisanje testne baze podataka.
Povezane lekcije
- JavaScript · Lekcija 20 · Srednje · Verzija: 3
- JavaScript · Lekcija 21 · Srednje · Verzija: 3
Izvori
- IDBRequest: result property
- IDBRequest: error property
- IDBRequest
- IDBRequest: readyState property
- IDBFactory: open() method
- IDBOpenDBRequest: upgradeneeded event
- IDBObjectStore: add() method
- IDBObjectStore: get() method
- IDBTransaction
- IDBTransaction: complete event
- IDBFactory: deleteDatabase() method
- Crypto: randomUUID() method