Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

IDBRequest — résultat d’une opération IndexedDB

IDBRequest expose, au moyen d’événements, le résultat ou l’erreur d’une opération IndexedDB asynchrone. La réussite d’une requête ne signifie pas encore que toute la transaction a été validée.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

request.result
request.error
request.onsuccess = (event) => { /* read request.result */ };
request.onerror = (event) => { /* read request.error */ };

IDBRequest est un objet EventTarget renvoyé par des opérations IndexedDB telles que get(). Ce n’est pas une Promise : utiliser simplement await request n’attend pas le résultat. Il fait partie des Web APIs, et non d’ECMAScript ; la présence de Node 24 ne prouve pas que cette API est disponible dans un navigateur.

IDBRequest.result contient un résultat propre à l’opération ; après un échec, il renvoie undefined. IDBRequest.error renvoie une DOMException après un échec ou null après une réussite. Lire l’une ou l’autre propriété lorsque readyState === "pending" déclenche InvalidStateError. Avec get(), l’absence d’un enregistrement constitue une réussite dont le résultat est undefined, et non une erreur.

IDBRequest.onsuccess traite l’événement success, et IDBRequest.onerror traite error. Par défaut, une erreur de requête annule la transaction associée ; le simple fait d’affecter un gestionnaire ne change rien à cela. La réussite d’une requête ne garantit pas la validation : surveillez aussi les événements complete et abort de la transaction.

L’exemple ouvre une base de données avec IDBOpenDBRequest, un sous-type de IDBRequest. L’écriture et la lecture sont mises en file d’attente dans la même transaction. Si get() réussit, son gestionnaire onsuccess affiche request.result avant l’événement complete de la transaction, si cet événement se produit. Le message affiché, IndexedDB unavailable: SecurityError, correspond à un cas d’erreur où la lecture n’est pas atteinte.

Exemples

<!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>

Résultat

IndexedDB unavailable: SecurityError

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources