CKTIS / JavaScript
IDBRequest — risultato di un’operazione IndexedDB
IDBRequest espone tramite eventi il risultato o l’errore di un’operazione IndexedDB asincrona. Il successo di una richiesta non significa ancora che l’intera transazione sia stata completata.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
request.result
request.error
request.onsuccess = (event) => { /* read request.result */ };
request.onerror = (event) => { /* read request.error */ };IDBRequest è un oggetto EventTarget restituito da operazioni IndexedDB come get(). Non è una Promise: usare semplicemente await request non attende il risultato. Fa parte delle Web API, non di ECMAScript; la presenza di Node 24 non dimostra che questa API sia disponibile nel browser.
IDBRequest.result contiene un risultato specifico dell’operazione; dopo un errore restituisce undefined. IDBRequest.error restituisce una DOMException in caso di errore oppure null in caso di successo. Leggere una delle due proprietà quando readyState === "pending" genera InvalidStateError. Se get() non trova un record, l’operazione ha successo e il risultato è undefined: non è un errore.
IDBRequest.onsuccess gestisce l’evento success, mentre IDBRequest.onerror gestisce error. Per impostazione predefinita, un errore della richiesta interrompe la transazione associata; assegnare un gestore non cambia questo comportamento. Il successo della richiesta non garantisce il completamento: osserva anche gli eventi complete e abort della transazione.
L’esempio apre un database usando IDBOpenDBRequest, un sottotipo di IDBRequest. La scrittura e la lettura vengono accodate nella stessa transazione. Se get() ha successo, il suo gestore onsuccess stampa request.result prima dell’evento complete della transazione, se tale evento viene emesso. Il messaggio mostrato, IndexedDB unavailable: SecurityError, proviene da un percorso di errore in cui non si arriva alla lettura.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IDBRequest: operation success and transaction completion</title>
</head>
<body>
<h1>Observing an IndexedDB request</h1>
<script>
(() => {
const name = 'cktis-request-' + crypto.getRandomValues(new Uint32Array(4)).join('-');
const report = error => console.log(error.name === 'SecurityError'
? 'IndexedDB unavailable: SecurityError' : `IndexedDB error: ${error.name}`);
let factory, opening;
try {
factory = window.indexedDB;
if (!factory) {
console.log('IndexedDB unavailable: API missing');
return;
}
opening = factory.open(name, 1);
} catch (error) {
report(error);
return;
}
let created = false;
opening.onerror = () => report(opening.error);
opening.onupgradeneeded = () => {
created = true;
opening.result.createObjectStore('values');
};
opening.onsuccess = () => {
const db = opening.result;
if (!created) {
db.close();
console.log('Fixture name already in use');
return;
}
const tx = db.transaction('values', 'readwrite');
const store = tx.objectStore('values');
store.put('circle', 'shape');
const request = store.get('shape');
const cleanup = () => {
db.close();
factory.deleteDatabase(name);
};
console.log(`get before events: ${request.readyState}`);
request.onsuccess = () => {
console.log(`get success: ${request.readyState}, value: ${request.result}`);
};
request.onerror = () => console.log(`get error: ${request.error.name}`);
tx.oncomplete = event => {
console.log(`transaction: ${event.type}`);
cleanup();
};
tx.onabort = event => {
console.log(`transaction: ${event.type}`);
cleanup();
};
};
})();
</script>
</body>
</html>Risultato
IndexedDB unavailable: SecurityError
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.