1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
---
title: IDBObjectStore
slug: Web/API/IDBObjectStore
translation_of: Web/API/IDBObjectStore
---
<p>{{APIRef("IndexedDB")}}</p>
<p>L'interface <strong><code>IDBObjectStore</code></strong> de l'{{domxref("IndexedDB_API","API IndexedDB")}} est un accès aux magasins d'objet de la base de données.</p>
<p>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.</p>
<p>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.</p>
<p>{{AvailableInWorkers}}</p>
<h2 id="Méthodes">Méthodes</h2>
<dl>
<dt>{{domxref("IDBObjectStore.add()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} pour ajouter un enregistrement au magasin d'objet relié, un <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/common-dom-interfaces.html#structured-clone">clone structuré</a> de la valeur passé en paramètre et sa clé .</dd>
<dt>{{domxref("IDBObjectStore.clear()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} pour vider le magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.delete()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} de suppression d'enregistrement(s) du magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.get()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} pour renvoyer la valeur d'un enregistrement du magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.getAll()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} qui renvoie un tableau ordonné suivant les clés, des valeurs de tous les enregistrements du magasin d'objet relié. On peut limité le nombre d'enregistrements en les filtrants suivant leurs clés ou en paramétrant le compteur.</dd>
<dt>{{domxref("IDBObjectStore.getAllKeys()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} qui renvoie la liste de toutes les clés des enregistrements du magasin d'objet. On peut limité le nombre d'enregistrements en les filtrants suivant leurs clés ou en paramétrant le compteur.</dd>
<dt>{{domxref("IDBObjectStore.createIndex()")}}</dt>
<dd>Met en place sur le magasin d'objet relié, un nouvel index et en renvoie l'{{domxref("IDBIndex","accès")}}.</dd>
<dt>{{domxref("IDBObjectStore.deleteIndex()")}}</dt>
<dd>Supprime l'index dont le nom est passé en paramètre, du magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.index()")}}</dt>
<dd>L'{{domxref("IDBIndex","accès")}} à l'index dont le nom est passé en paramètre du magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.put()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} pour ajouter ou mettre à jour un enregistrement du magasin d'objet relié, un <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/common-dom-interfaces.html#structured-clone">clone structuré</a> de la valeur passée en paramètre et sa clé.</dd>
<dt>{{domxref("IDBObjectStore.openCursor()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} récursive suivant un {{domxref("IDBCursorWithValue","curseur avec valeur")}} qui itère le magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.openKeyCursor()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} récursive suivant un {{domxref("IDBCursor","curseur")}} qui itère le magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.count()")}}</dt>
<dd>Une {{domxref("IDBRequest","requête")}} au magasin d'objet relié. La requête compte le nombre d'enregistrements dans ce magasin d'objet ou sur l'{{domxref("IDBKeyRange","intervalle de clé")}} passé en paramètre.</dd>
</dl>
<h2 id="Propriétés">Propriétés</h2>
<dl>
<dt>{{domxref("IDBObjectStore.indexNames")}} {{readonlyInline}}</dt>
<dd>La liste des noms d'index du magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.keyPath")}} {{readonlyInline}}</dt>
<dd>Le <a href="/fr/docs/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB#gloss_keypath">nom de la clé</a> du magasin d'objets relié.</dd>
<dt>{{domxref("IDBObjectStore.name")}} {{readonlyInline}}</dt>
<dd>Le nom du magasin d'objet relié.</dd>
<dt>{{domxref("IDBObjectStore.transaction")}} {{readonlyInline}}</dt>
<dd>La {{domxref("IDBTransaction","transaction")}} à laquelle l'accès du magasin d'objet appartient.</dd>
<dt>{{domxref("IDBObjectStore.autoIncrement")}} {{readonlyInline}}</dt>
<dd>La position du drapeau d’incrémentation automatique du magasin d'objet relié.</dd>
</dl>
<dl>
</dl>
<h2 id="Exemple">Exemple</h2>
<p>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 <code>onupgradeneeded</code>. On ajoute un nouvel enregistrement avec {{domxref("IDBObjectStore.add")}}.</p>
<pre class="brush: js">// 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>';
}</pre>
<div class="note">
<p><strong>Note :</strong> Pour un exemple de travail complet, voir notre <a href="https://github.com/mdn/to-do-notifications/">To-do Notifications</a> app (<a href="http://mdn.github.io/to-do-notifications/">view example live</a>).</p>
</div>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spécification</th>
<th scope="col">Statut</th>
<th scope="col">Commentaire</th>
</tr>
<tr>
<td>{{SpecName('IndexedDB', '#idl-def-IDBObjectStore', 'IDBObjectStore')}}</td>
<td>{{Spec2('IndexedDB')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2>
<p>{{Compat("api.IDBObjectStore")}}</p>
<h2 id="See_also">Voir aussi</h2>
<ul>
<li>{{domxref("IndexedDB_API.Using_IndexedDB","Utiliser IndexedDB")}}</li>
<li>{{domxref("IDBDatabase","Débuter une connexion")}}</li>
<li>{{domxref("IDBTransaction","Utilisé les transactions")}}</li>
<li>{{domxref("IDBKeyRange","Définir l'intervalle des clés")}}</li>
<li>{{domxref("IDBCursor","Utiliser les curseur")}}</li>
<li>Exemple de référence: <a href="https://github.com/mdn/to-do-notifications/tree/gh-pages">To-do Notifications</a> (<a href="http://mdn.github.io/to-do-notifications/">view example live</a>.)</li>
</ul>
|
