IDBTransaction.oncomplete

Le gestionnaire d'événement oncomplete, rattaché à l'interface IDBTransaction, s'exécute au déclenchement d'un événement complete lorsque la transaction se termine avec succès.

Syntaxe

transaction.oncomplete = function() { ... };

Exemple

Dans le code suivant, on ouvre une connexion à la base de donnée. Ensuite, sur cette connexion, on démarre une transaction (avec  IDBTransaction) en lecture/écriture pour accéder au magasin d'objet "toDoList" et y ajouter un enregistrement grâce à la méthode IDBObjectStore.add. On notera également la façon dont le gestionnaire d'événement IDBTransaction.onerror est utilisé dans la transaction.

Le gestionnaires d'événement oncomplete de la transaction permet d'afficher un message de succès sur la page.

// Connexion à la base de données
var DBOpenRequest = window.indexedDB.open("toDoList", 4);

DBOpenRequest.onsuccess = function(event) {
  note.innerHTML += '<li>Connexion établie.</li>'; 
  
  // Affectation de la connexion à la variable db. 
  db = DBOpenRequest.result; 

  // Exécution de la fonction addData () pour
  // stocker des données dans la base
  addData(); 
};

function addData() { 
  // Voici un nouvel objet prêt à être emmagasiné
  newItem = [ { taskTitle: "Walk dog", hours: 19, minutes: 30, day: 24, month: "December", year: 2013, notified: "no" } ]; 
  
  // On ouvre une transaction en lecture/écriture
  // prête au traitement des données sur la connexion
  var transaction = db.transaction(["toDoList"], "readwrite"); 

  // Voici le gestionnaire utilisé en cas de succès
  // de l'ouverture de la transaction 
  transaction.oncomplete = function(event) { 
    note.innerHTML += '<li>Transaction terminée : modification de la base de données OK.</li>'; 
  }; 

  // Et celui utilisé en cas d'échec de
  // l'ouverture de la transaction 
  transaction.onerror = function(event) { 
    note.innerHTML += '<li>L\'erreur: "' + transaction.error +'" s\'est produite, échec de la transaction.</li>';  
  }; 

  // Puis, on ouvre l'accès au un magasin "toDoList"
  // de la transaction
  var objectStore = transaction.objectStore("toDoList"); 

  // Enfin on ajoute l'enregistrement
  var objectStoreRequest = objectStore.add(newItem[0]); 
  objectStoreRequest.onsuccess = function(event) { 
    // Et on signale l'ajout de l'enregistrement
    note.innerHTML += '<li>Enregistrement ajouté.</li>'; 
  };
 };

Pour un exemple de travail complet, voir notre application To-do Notifications (exemple live disponible).

Spécifications

Compatibilité des  navigateurs

Voir aussi

• Manipuler IndexedDB
• Démarrer des transactions : IDBDatabase
• Manipuler des transactions : IDBTransaction
• Définir un intervalle de clés : IDBKeyRange
• Récupérer des données et les modifier : IDBObjectStore
• Manipuler des curseurs : IDBCursor
• Exemple de référence pour IndexedDB : To-do Notifications