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
.
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 stockagetemporary
.
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
- 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.)