{{APIRef("IndexedDB")}}
L'interface IDBObjectStore de l'{{domxref("IndexedDB_API","API IndexedDB")}} est un accès aux magasins d'objet de la base de données.
Le magasin d'objet emmagasine des enregistrements. Chaque enregistrement est constitué d'un couple clé/valeur. Chaque valeurs est indexée sur sa clé. Les clés sont triées pour former l'index primaire du magasin. Ce qui permet un accès rapide et ordonnée aux valeurs.
Le magasin d'objet peut en plus de l'index primaire avoir des index qui ordonnent les enregistrements sur d'autres clés. Ces index se mettent automatiquement à jour dans la plupart des cas et permettent de mettre des contraintes d’unicités pour d'autres clés que la clé primaire du magasin d'objet.
{{AvailableInWorkers}}
Cet exemple montre différents usages de l'accès au magasin d'objet. On met à jour la structure de donnée avec {{domxref("IDBObjectStore.createIndex")}} dans un gestionnaire d'événement onupgradeneeded. On ajoute un nouvel enregistrement avec {{domxref("IDBObjectStore.add")}}.
// connexion à la base de données
var DBOpenRequest = window.indexedDB.open("toDoList", 4);
// gère le succès de la connexion
DBOpenRequest.onsuccess = function(event) {
note.innerHTML += '<li>Connexion ouverte.</li>';
//affect la connexion à la variable db.
db = DBOpenRequest.result;
};
// Ce gestionnaire d'événement s'active quand on à besoin d'une nouvelle version de la base de donnée.
// Si la base n'existais pas avant ou
// si on ouvre une nouvelle version avec window.indexedDB.open.
DBOpenRequest.onupgradeneeded = function(event) {
var db = event.target.result;
db.onerror = function(event) {
note.innerHTML += '<li>Erreur de chargement de la base.</li>';
};
// Ajoute un magasin d'objets à la base de données
var objectStore = db.createObjectStore("toDoList", { keyPath: "taskTitle" });
// défini des index sur ce magasin
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 });
note.innerHTML += '<li>Le magasin d\'objet est ajouté.</li>';
};
// Un nouvel enregistrement à ajouter
var newItem = [
{ taskTitle: "Walk dog", hours: 19, minutes: 30, day: 24, month: 'December', year: 2013, notified: "no" }
];
// ouvre une transaction en lecture/écriture sur la connexion, prête à ajouter l'enregistrement.
var transaction = db.transaction(["toDoList"], "readwrite");
// affiche le succès de la transaction
transaction.oncomplete = function(event) {
note.innerHTML += '<li>La transaction à été effectuée.</li>';
};
transaction.onerror = function(event) {
note.innerHTML += '<li>La transaction n\'as pue aboutir.</li>';
};
// Un accès à toDoList pour la transaction
var objectStore = transaction.objectStore("toDoList");
// Ajoute l'enregistrement au magasin d'objet
var objectStoreRequest = objectStore.add(newItem[0]);
//l'enregistrement c'est bien passé.
objectStoreRequest.onsuccess = function(event) {
note.innerHTML += '<li>L\'enregistrement à été ajouté au magasin d\'objet.</li>';
}
Note : Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).
| Spécification | Statut | Commentaire |
|---|---|---|
| {{SpecName('IndexedDB', '#idl-def-IDBObjectStore', 'IDBObjectStore')}} | {{Spec2('IndexedDB')}} |
{{Compat("api.IDBObjectStore")}}