IDBObjectStore.delete()

Syntaxe

var request = objectStore.delete(cle);

Paramètre

cle

La clé ou l'intervalle de clé d'enregistrement(s) à supprimer.

Renvoie

Une requête.

La propriété result de cette requête renvoie undefined en cas de succès.

Exceptions

TransactionInactiveError

Cette exeception est levé si la transaction est inactive.

ReadOnlyError

Cette exeception est levé si la transaction est en mode lecture seule.

InvalidStateError

Cette exeception est levé si le magasin d'objet a été supprimé.

DataError

Cette exeception est levé si la clé ou l'intervalle de clé n'est pas valide.

Exemple

Dans le code suivant , on ouvre un transaction sur la connexion à la base de données pour avoir l'accès au magasin d'objet duquel on veut supprimer un enregistrement.

La méthode delete() sert à supprimer l’enregistrement dont la clé est Walk dog du magasin d'objet toDoList

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

// Gère l'ouverture de la connexion
DBOpenRequest.onsuccess = function(event) {
  note.innerHTML += '<li>Base de donnée initialisé</li>';
    
  // affecte la connexion dans la variable db
  db = DBOpenRequest.result;
    
  // exécute la fonction deleteData()
  deleteData();
};

function deleteData() {
  // ouvre un transaction en mode lecture/écriture pour effectuer la suppression 
  var transaction = db.transaction(["toDoList"], "readwrite");

  // affiche le succès de la transaction.
  transaction.oncomplete = function(event) {
    note.innerHTML += '<li>Transaction effectuée: fin de la modification de la base de données.</li>';
  };

  // affiche la cause de l’échec de la transaction.
  transaction.onerror = function(event) {
    note.innerHTML += '<li>Échec de la transaction: ' + transaction.error + ' la base de donnée n\'a pas été modifié</li>';
  };

  // ouvre un accès au magasin d'objet toDoList
  var objectStore = transaction.objectStore("toDoList");

  // supprime l'enregistrement dont la clé est Walk dog
  var objectStoreRequest = objectStore.delete("Walk dog");

  
  objectStoreRequest.onsuccess = function(event) {
    // affiche le succès de la suppression 
    note.innerHTML += '<li>Enregistrement supprimé.</li>';
  };
};

Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

Spécification

Compatibilité avec les navigateurs

Voir aussi

• Utiliser IndexedDB
• Débuter une connexion
• Utilisé les transactions
• Définir l'intervalle des clés
• Accès aux magasins d'objets
• Utiliser les curseur
• Exemple de référence: To-do Notifications (view example live.)