From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/idbopendbrequest/index.md | 127 +++++++++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 files/fr/web/api/idbopendbrequest/index.md (limited to 'files/fr/web/api/idbopendbrequest/index.md') diff --git a/files/fr/web/api/idbopendbrequest/index.md b/files/fr/web/api/idbopendbrequest/index.md new file mode 100644 index 0000000000..2cbb5b3c7e --- /dev/null +++ b/files/fr/web/api/idbopendbrequest/index.md @@ -0,0 +1,127 @@ +--- +title: IDBOpenDBRequest +slug: Web/API/IDBOpenDBRequest +tags: + - API + - Base de données + - IndexedDB + - Interface + - Reference + - Référence DOM + - Stockage +translation_of: Web/API/IDBOpenDBRequest +--- +

{{APIRef("IndexedDB")}}

+ +
+

L'interface IDBOpenDBRequest de l'API IndexedDB donne un accès aux résultats des requêtes permettant d'ouvrir ou  de supprimer des bases de donnée (Effectuée via {{domxref("IDBFactory.open")}} et {{domxref("IDBFactory.deleteDatabase")}}).

+
+ +

{{AvailableInWorkers}}

+ +

{{InheritanceDiagram}}

+ +

Propriétés

+ +

Hérite  des méthodes de ses parents {{domxref("IDBRequest")}} et {{domxref("EventTarget")}}.

+ +

Évènements

+ +
+
{{domxref("IDBOpenDBRequest.onblocked")}}
+
Le gestionnaire d'événements pour événement bloqué . Cet événement est lancé lorsqu' un événement  upgradeneeded doit être déclenché en raison d'un changement de version, mais que la base de données est toujours en cours d'utilisation (c'est-à-dire, non fermée) quelque part, même après l'envoi de l'évènement versionchange .
+
{{domxref("IDBOpenDBRequest.onupgradeneeded")}}
+
Le gestionnaire d'évènement pour évènement upgradeneeded (mise-à-jour nécessaire), lancé quand une base de données d'une version supérieure à celle de la base de données existante est chargé.
+
+ +

Méthodes

+ +

Pas de méthodes, mais hérite des méthodes de ses parents {{domxref("IDBRequest")}} et {{domxref("EventTarget")}}.

+ +

Exemple

+ +

Dans l'exemple ci-dessous,  le gestionnaire onupgradeneeded est utilisé pour mettre à jour la structure de la base de données, si une base plus récente est chargée. Pour voir un exemple complet, référez-vous à notre application To-do Notifications (voir cet exemple réel)

+ +
var db;
+
+// Ouvre la base de données.
+var DBOpenRequest = window.indexedDB.open("toDoList", 4);
+
+// Ces gestionnaires d'évènements agissent sur la base de données en cours d'ouverture.
+  note.innerHTML += '<li>Error loading database.</li>';
+};
+
+DBOpenRequest.onsuccess = function(event) {
+  note.innerHTML += '<li>Database initialised.</li>';
+
+  // stocke le résultat de l'ouverture de la base de données dans la variable db .
+  // Ceci est beaucoup moins utilisé.
+  db = DBOpenRequest.result;
+
+  // Exécute la fonction displayData() pour remplir la liste de tâches
+  // avec toutes les données de la lste de tâches déjà dans la base.
+  displayData();
+};
+
+// Cet évènement gère l'évènement par lequel une nouvelle version
+// de la base de données doit être créée. Soit elle n'a pas
+// été créée avant, soit un nouveau numéro de version a été
+// soumis via la ligne "window.indexedDB.open" ci-dessous.
+// Il n'est implémenté que dans les navigateurs récents.
+DBOpenRequest.onupgradeneeded = function(event) {
+  var db = this.result;
+
+  db.onerror = function(event) {
+    note.innerHTML += '<li>Error loading database.</li>';
+  };
+
+  // Crée un objet de stockage pour cette base de données.
+  var objectStore = db.createObjectStore("toDoList", { keyPath: "taskTitle" });
+
+  // définit quels éléments de données l'objet de stockage contiendra.
+
+  objectStore.createIndex("hours", "hours", { unique: false });
+  objectStore.createIndex("minutes", "minutes", { unique: false });
+  objectStore.createIndex("day", "day", { unique: false });
+  objectStore.createIndex("month", "month", { unique: false });
+  objectStore.createIndex("year", "year", { unique: false });
+  objectStore.createIndex("notified", "notified", { unique: false });
+};
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('IndexedDB', '#idl-def-IDBOpenDBRequest', 'IDBOpenDBRequest')}}{{Spec2('IndexedDB')}}Définition initiale
{{SpecName("IndexedDB 2", "#idbopendbrequest", "IDBOpenDBRequest")}}{{Spec2("IndexedDB 2")}} 
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.IDBOpenDBRequest")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf