IDBRequest.error

La propriété error de l'interface IDBRequest indique le code de l'erreur survenue durant le traitement de la requête. Si la requête est en cours l'exception InvalidStateError est levée.

Syntaxe

var myError = request.error;

Valeur

Une DOMError contenant l'erreur correspondante. Dans Chrome 48+ cette propriété renvoie un DOMException parceque DOMError a été retiré du standard DOM. Les codes d'erreur suivants sont renvoyés sous certaines conditions:

En plus de ces codes d'erreurs envoyés à l'objet IDBRequest, les opérations asynchrones peuvent aussi lever des exceptions. La liste décrit les problèmes qui peuvent arriver durant l'exécution de la requête, mais on peut également trouver d'autres problèmes quand la requête est faite. Par exemple, si la requête échoue et que le résultat est indisponible, l'exception InvalidStateError est levé.

Exemple

L'exemple suivant demande un titre d'enregistrement donné, onSuccess obtient l'enregistrement associé de IDBObjectStore (mis à disposition en tant que objectStoreTitleRequest.result), on met à jour une propriété de l'enregistrement, puis le sauve dans le magasin d'objets. En bas est une fonction onerror qui affiche le code d'erreur si la requête échoue. Pour un exemple de travail complet, voir notre To-do Notifications app (view example live.)

var title = "Walk dog";

// Ouvrez une transaction comme d'habitude
var objectStore = db.transaction(['toDoList'], "readwrite").objectStore('toDoList');

// Obtenez l'objet toDoList qui a ce titre
var objectStoreTitleRequest = objectStore.get(title);

objectStoreTitleRequest.onsuccess = function() {
  // Prenez l'objet de données renvoyé comme résultat
  var data = objectStoreTitleRequest.result;

  // Mettre à jour la valeur notified de l'objet à "yes"
  data.notified = "yes";

  // Créer une autre requête qui insère le nouvelle élément dans la base de données
  var updateTitleRequest = objectStore.put(data);

  // Lorsque cette requête réussit, appelle de la fonction displayData() pour mettre à jour l'affichage
  updateTitleRequest.onsuccess = function() {
    displayData();
  };
};

objectStoreTitleRequest.onerror = function() {
  // Si une erreur se produit à la demande, on l'affiche
  console.log("Il y a eu une erreur dans la récupération des données: " + objectStoreTitleRequest.error);
};

Spécifications

Compatibilité avec les navigateurs

Voir aussi

• Using IndexedDB
• Starting transactions: IDBDatabase
• Using transactions: IDBTransaction
• Setting a range of keys: IDBKeyRange
• Retrieving and making changes to your data: IDBObjectStore
• Using cursors: IDBCursor
• Reference example: To-do Notifications (view example live.)