CKTIS / JavaScript
IDBRequest: rezultat in napaka zahteve
Naučite se, kdaj v IndexedDB prebrati `result` in `error` ter kako ločiti uspeh posamezne zahteve od potrditve transakcije.
Različica: 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 in error sta lastnosti primerka IDBRequest, namenjeni samo branju. Zahteva IndexedDB predstavlja asinhrono operacijo. Ni obljuba (Promise), zato await request ne počaka na konec operacije. IndexedDB je API spletne platforme, ne del ECMAScripta 2024. Razpoložljivost je odvisna od izvajalnega okolja.
Dokler ima request.readyState vrednost "pending", branje katere koli od teh lastnosti sproži izjemo DOMException z imenom InvalidStateError. Stanje "done" samo po sebi ne pomeni uspeha. Rezultat običajno preberete v obravnavalniku dogodka success. Izjema: v obravnavalniku dogodka upgradeneeded zahteve indexedDB.open() je result že na voljo za spreminjanje sheme, čeprav se končni dogodek success še ni sprožil.
Ob dogodku success je vrednost error enaka null, vrednost result pa je odvisna od operacije: open() zagotovi povezavo IDBDatabase, add() vrne ključ shranjenega zapisa, get() pa lahko vrne undefined, če ključu ne ustreza noben zapis. Ob dogodku error je vrednost result enaka undefined, error pa vsebuje DOMException. Z request.error.name prepoznate napako, kot je ConstraintError. Rezultat undefined sam po sebi ne pomeni neuspeha. try...catch okoli klica API-ja prestreže sinhrone izjeme, ne pa napak, ki jih pozneje sporoči dogodek error.
Uspešna zahteva za pisanje še ne pomeni, da je bila transakcija potrjena. Dogodek complete potrdi, da so spremembe uveljavljene, abort pa sporoči, da je bila transakcija preklicana in da so bile spremembe razveljavljene. Napaka zahteve v transakciji privzeto prekine transakcijo. Če lahko pričakovano napako varno obravnavate, kličite event.preventDefault() v obravnavalniku dogodka error te zahteve. S tem preprečite privzeto prekinitev, vendar zahteva ostane neuspešna.
Primeri
<!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
Odprite primer kot stran HTML prek HTTPS, na kateri sta na voljo IndexedDB in `crypto.randomUUID()`. Sporočila preverite v konzoli brskalnika. Drugi klic `add()` poskuša uporabiti isti ključ. Obravnavalnik prepreči privzeto prekinitev samo pri pričakovani napaki `ConstraintError`, zato se prvi zapis lahko potrdi. Ko se transakcija konča, koda zapre povezavo in zahteva izbris preskusne podatkovne zbirke.
Povezane lekcije
- JavaScript · Lekcija 20 · Srednja · Različica: 3
- JavaScript · Lekcija 21 · Srednja · Različica: 3
Viri
- 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