CKTIS / JavaScript
IDBRequest: výsledok, chyba a obsluha udalostí
Po úspechu požiadavky IndexedDB čítaj `result`, po zlyhaní `error`. Úspech jednej požiadavky ešte neznamená, že bola potvrdená celá transakcia.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
// 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 požiadavky IndexedDB, nie prísľub (Promise). IndexedDB je webové API, nie súčasť ECMAScript 2024; jeho dostupnosť závisí od prostredia vykonávania. Kým má readyState hodnotu "pending", čítanie ktorejkoľvek z vlastností určených iba na čítanie, result alebo error, vyvolá výnimku DOMException s názvom InvalidStateError. V stave "done" sa tieto vlastnosti dajú čítať, ale tento stav neznamená, že požiadavka uspela. Požiadavka IDBOpenDBRequest môže byť v stave "done" už počas udalosti upgradeneeded, ešte pred záverečnou udalosťou success alebo error.
Priraď funkcie do request.onsuccess a request.onerror na obsluhu udalostí success a error v tomto poradí. Nové priradenie nahradí predchádzajúcu obslužnú funkciu; cez addEventListener() môžeš pridať samostatných poslucháčov s názvom udalosti bez on. Pri úspechu čítaj request.result: hodnota závisí od operácie. Napríklad add() poskytne kľúč cez result, kým get() môže uspieť s hodnotou undefined, ak kľúč chýba. Pri úspechu má request.error hodnotu null; pri zlyhaní obsahuje DOMException a request.result má hodnotu undefined. Konštrukcia try...catch okolo volania môže zachytiť jeho synchrónnu výnimku, nie neskoršie zlyhanie požiadavky.
Udalosť success sa nešíri smerom nahor a nedá sa zrušiť. Pri požiadavke v transakcii sa error šíri smerom nahor a predvolene spôsobí prerušenie transakcie. V obsluhe očakávanej chyby, z ktorej sa dá zotaviť, zavolaj event.preventDefault(), aby si tomuto predvolenému prerušeniu zabránil. Požiadavka zostane neúspešná a udalosť sa bude šíriť ďalej.
Úspešná požiadavka na zápis neznamená potvrdenie transakcie. Ďalšie požiadavky zadávaj, kým je transakcia aktívna, napríklad priamo v obsluhe udalosti požiadavky. Na transakcii sleduj complete na zistenie potvrdenia a abort na zistenie vrátenia zmien.
Príklady
<!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>Výsledok
success: 1 error: ConstraintError transaction: complete
Ulož príklad ako súbor HTML a sprístupni ho cez HTTPS. Otvor stránku v prehliadači, kde sú dostupné IndexedDB a `crypto.randomUUID()`, a skontroluj výstup vo vývojárskej konzole. Prvé `add()` poskytne kľúč `1` cez `result`; druhé zlyhá s chybou `ConstraintError`. `preventDefault()` zabráni tomu, aby táto chyba prerušila transakciu, takže môže nastať `complete`. Po skončení transakcie kód zatvorí pripojenie a požiada o odstránenie databázy vytvorenej pre toto spustenie.
Súvisiace lekcie
- JavaScript · Lekcia 31 · Pokročilá · Verzia: 4