IDBFactory.deleteDatabase()

Cet article nécessite une relecture technique. Voici comment vous pouvez aider.

Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.

La méthode deleteDatabase() de l'interface IDBFactory demande la suppression d'une base de données. La méthode renvoie immédiatement un objet IDBOpenDBRequest, et effectue la suppression de manière asynchrone.

Lorsque la base de données est supprimé, Un événement success est déclenché sur l'objet IDBOpenDBRequest renvoyé et sa propriété result vaut undefined. Si une erreur se produit lors de la suppression un événement error est déclenché sur l'objet IDBOpenDBRequest renvoyé.

Si d'autres onglets ont des connexions ouvertes à la base de données cela déclenchera les événements upgradedneeded et blocked.

Note : This feature is available in Web Workers.

Syntaxe

Pour la version standard:

var request = window.indexedDB.deleteDatabase("toDoList");

Pour la version expérimentale avec options (voir ci-dessous):

var request = window.indexedDB.deleteDatabase("toDoList", { storage: "temporary" });

Paramètres

name
Le nom de la base de données.
options Non standard
Depuis Gecko version 26, On peut inclure un paramètre de stockage optionnel et non-standard qui détermine si on veut supprimer une IndexedDB permanent (valeur par défaut) ou une indexedDB dans un stockage temporary.

Renvoie

Une IDBOpenDBRequest sur lequel les événements relatifs à cette demande seront déclenché.

Exemple

var DBDeleteRequest = window.indexedDB.deleteDatabase("toDoList");

DBDeleteRequest.onerror = function(event) {
  console.log("Erreur lords de la suppression de basedonnées.");
};
 
DBDeleteRequest.onsuccess = function(event) {
  console.log("Base de données supprimé");
    
  console.log(request.result); // devrait être nulle
};

Spécifications

Spécification Statut Commentaire
Indexed Database API
La définition de 'deleteDatabase' dans cette spécification.
Recommendation

Compatibilité avec les navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support basique 23webkit
24
10 moz
16.0 (16.0)
10,en partie 15 7.1
Disponible dans workers (Oui) 37.0 (37.0) ? (Oui) ?
Fonctionnalité Android Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile
Support basique 4.4 22.0 (22.0) 1.0.1 10 22 8
Disponible dans workers (Oui) 37.0 (37.0) (Oui) ? (Oui) ?

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : gadgino
 Dernière mise à jour par : gadgino,