CKTIS / JavaScript
IDBRequest: rezultat, pogreška i obrada događaja
Nakon uspješnog zahtjeva u IndexedDB-u pročitaj `result`, a nakon neuspješnog `error`. Uspjeh pojedinačnog zahtjeva ne znači da je transakcija potvrđena.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
// Read-only members; do not read either while readyState is "pending".
// request.result
// request.error
request.onsuccess = (event) => { /* read request.result */ };
request.onerror = (event) => { /* read request.error */ };
// Alternative registration; event names omit the "on" prefix.
request.addEventListener("success", handleSuccess);
request.addEventListener("error", handleError);IDBRequest je objekt zahtjeva u IndexedDB-u, a ne obećanje (Promise). IndexedDB je web API, nije dio standarda ECMAScript 2024 i njegova dostupnost ovisi o izvršnom okruženju. Dok readyState ima vrijednost "pending", čitanje bilo kojeg od svojstava samo za čitanje, result ili error, baca iznimku DOMException s nazivom InvalidStateError. U stanju "done" možeš pročitati ta svojstva, ali to ne znači da je zahtjev uspio. Zahtjev IDBOpenDBRequest može biti u stanju "done" već tijekom događaja upgradeneeded, prije završnog događaja success ili error.
Dodijeli funkcije svojstvima request.onsuccess i request.onerror za obradu događaja success, odnosno error. Nova dodjela zamjenjuje prethodnu funkciju; uz addEventListener() možeš dodati zasebne slušatelje s nazivom događaja bez on. U slučaju uspjeha pročitaj request.result: vrijednost ovisi o operaciji. Na primjer, add() daje ključ preko svojstva result, dok get() može uspjeti s vrijednošću undefined ako ključ ne postoji. Pri uspjehu request.error ima vrijednost null; pri neuspjehu sadrži DOMException, a request.result ima vrijednost undefined. Konstrukcija try...catch oko poziva može uhvatiti njegovu sinkronu iznimku, ali ne i kasniji neuspjeh zahtjeva.
Događaj success ne širi se prema gore i ne može se otkazati. Za zahtjev unutar transakcije error se širi prema gore i prema zadanim postavkama prekida transakciju. U funkciji za obradu očekivane pogreške nakon koje je moguć nastavak pozovi event.preventDefault() da spriječiš taj zadani prekid. Zahtjev time ne postaje uspješan, a događaj se nastavlja širiti.
Uspješan zahtjev za upis ne znači da je transakcija potvrđena. Šalji sljedeće zahtjeve dok je transakcija aktivna, primjerice izravno u funkciji za obradu događaja zahtjeva. Na transakciji slušaj complete za potvrdu i abort za poništavanje promjena.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IDBRequest: success and error</title>
</head>
<body>
<p>Open the browser developer console to see the output.</p>
<script>
(() => {
const name = `cktis-idbrequest-${window.crypto.randomUUID()}`;
const open = window.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");
function cleanup() {
db.close();
const deletion = window.indexedDB.deleteDatabase(name);
deletion.onerror = () => console.error("cleanup:", deletion.error.name);
}
tx.oncomplete = () => {
console.log("transaction: complete");
cleanup();
};
tx.onabort = () => {
console.error("transaction: aborted", tx.error?.name);
cleanup();
};
const first = store.add("first", 1);
first.onsuccess = () => console.log(`success: ${first.result}`);
const duplicate = store.add("second", 1);
duplicate.onerror = (event) => {
const { name } = duplicate.error;
if (name === "ConstraintError") event.preventDefault();
console.log(`error: ${name}`);
};
};
})();
</script>
</body>
</html>Rezultat
success: 1 error: ConstraintError transaction: complete
Spremi primjer kao HTML datoteku i učini ga dostupnim preko HTTPS-a. Otvori stranicu u pregledniku u kojem su dostupni IndexedDB i `crypto.randomUUID()` te provjeri ispis u razvojnoj konzoli. Prvi `add()` daje ključ `1` preko svojstva `result`; drugi ne uspijeva uz `ConstraintError`. `preventDefault()` sprječava da ta pogreška prekine transakciju, pa se može pokrenuti `complete`. Nakon završetka transakcije kôd zatvara vezu i traži brisanje baze podataka stvorene za to izvođenje.
Povezane lekcije
- JavaScript · Lekcija 31 · Napredno · Verzija: 4