CKTIS / JavaScript
IDBRequest: резултат, грешка и обработчици на събития
Прочети `result` при успех на заявка към IndexedDB и `error` при неуспех. Успехът на отделна заявка не означава, че транзакцията е потвърдена.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
// 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 е обект на заявка към IndexedDB, а не обещание (Promise). IndexedDB е уеб API, а не част от ECMAScript 2024; наличността му зависи от средата за изпълнение. Докато readyState е "pending", прочитането на което и да е от свойствата само за четене result и error хвърля DOMException с име InvalidStateError. Състоянието "done" позволява да прочетеш тези свойства, но не означава, че заявката е успешна. Заявка IDBOpenDBRequest може да е в състояние "done" още по време на upgradeneeded, преди крайното събитие success или error.
Присвои функции на request.onsuccess и request.onerror, за да обработваш съответно success и error. Повторното присвояване заменя предишния обработчик; с addEventListener() можеш да добавяш отделни слушатели, като използваш името на събитието без on. При успех прочети request.result: стойността зависи от операцията. Например add() предоставя ключа чрез result, а get() може да завърши успешно с undefined, ако ключът липсва. При успех request.error е null; при неуспех съдържа DOMException, а request.result е undefined. Конструкцията try...catch около извикването може да прихване синхронно изключение от него, но не и по-късен неуспех на заявката.
Събитието success не се разпространява нагоре и не може да бъде отменено. При заявка в транзакция error се разпространява нагоре и по подразбиране прекратява транзакцията. Извикай event.preventDefault() в обработчика на очаквана грешка, след която може да се продължи, за да предотвратиш това прекратяване по подразбиране. Заявката остава неуспешна, а събитието продължава да се разпространява.
Успешната заявка за запис не означава, че транзакцията е потвърдена. Подай следващите заявки, докато транзакцията е активна, например направо в обработчик на събитие на заявка. На ниво транзакция слушай за complete, за да установиш потвърждаването, и за abort, за да установиш отмяната на промените.
Примери
<!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>Резултат
success: 1 error: ConstraintError transaction: complete
Запази примера като HTML файл и го предостави през HTTPS. Отвори страницата в браузър, в който са налични IndexedDB и `crypto.randomUUID()`, и провери изхода в конзолата за разработчици. Първото `add()` предоставя ключа `1` чрез `result`; второто завършва с `ConstraintError`. `preventDefault()` не позволява тази грешка да прекрати транзакцията, така че тя може да излъчи `complete`. След края на транзакцията кодът затваря връзката и заявява изтриване на базата данни, създадена за това изпълнение.
Свързани уроци
- JavaScript · Урок 31 · Напреднало · Версия: 4