IDBObjectStore.clear()

La méthode clear() de l'interface IDBObjectStore fait une requête pour vider le magasin d'objet relié.

Vider un magasin d'objet consiste à supprimer tous les enregistrements et les entrées des index de ce magasin d'objet.

Syntaxe

var request = objectStore.clear();

Renvoie

Une requête.

Exceptions

ReadOnlyError

Cette exception est levé si la transaction associé à cette requête est en mode lecture seule.

TransactionInactiveError

Cette exception est levé si la transaction de l'accès au magasin d’objet est inactive.

Exemple

Dans le code suivant, on ouvre une connexion à la base de donnée. Sur cette connexion on démarre une transaction en lecture/écriture pour avoir un accès au magasin d'objet "toDoList" et le vider

La méthode clear() de l'accès au magasin d'objet fait une requête pour vider le magasin d'objet toDoList.

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

DBOpenRequest.onsuccess = function(event) {
	note.innerHTML += '<li>Connexion établie.</li>'; 
  
	//Affecte la connexion à la variable db. 
	db = DBOpenRequest.result; 
  
  // Exécutez la fonction clearData () pour vider les données dans le magasin d'objet
  clearData();
};

function clearData() {
  // ouvre une transaction de lecture / écriture  prête pour le nettoyage
  var transaction = db.transaction(["toDoList"], "readwrite");

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

  // en cas d'échec de l'ouverture de la transaction 
  transaction.onerror = function(event) { 
     note.innerHTML += ''<li>L\'erreur: "' + transaction.error +'" c\'est produite échec de la transaction.'</li>
  }; 
  
  // ouvre l'accès au un magasin "toDoList" de la transaction 
  var objectStore = transaction.objectStore("toDoList"); 
  
  // Vide le magasin d'objet 
  var objectStoreRequest = objectStore.clear(); 
  
  objectStoreRequest.onsuccess = function(event) { 
  // rapporte le succès du nettoyage 
  note.innerHTML += '<li>Enregistrements effacées.</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.)