IDBIndex.multiEntry
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
La propriété multiEntry
, rattachée à l'interface IDBIndex
, est un booléen qui indique le comportement de l'index lorsque le résultat de l'évaluation d'un chemin de clé renvoie un tableau.
Ce comportement est paramétré au moment où l'index est créé avec la méthode IDBObjectStore.createIndex
. Cette méthode permet d'utiliser un paramètre facultatif options
pour définir la propriété multiEntry
avec true
/false
.
Note : Cette fonctionnalité est disponible via les Web Workers.
Syntaxe
var monIndex = objectStore.index("index");
console.log(monIndex.multiEntry);
Valeur
Un booléen. S'il vaut true
, cela signifie qu'il y a autant d'enregistrement que de valeurs dans le tableau renvoyé lors de l'évaluation du chemin (les clés des enregistrements sont les valeurs du tableau). S'il vaut false
, cela signifie qu'il n'y aura qu'un seul enregistrement ajouté et que la clé sera le tableau.
Exemples
Dans l'exemple qui suit, on ouvre une transaction sur un magasin d'objets et on récupère l'index lName
depuis la base de données des contacts. Ensuite, on ouvre un curseur simple sur l'index grâce à la méthode IDBIndex.openCursor
(cela fonctionne comme si on avait directement ouvert un curseur sur le magasin d'objets avec IDBObjectStore.openCursor
mais les enregistrements sont ici renvoyés en étant triés selon l'index et non selon la clé primaire.
La propriété multiEntry
est affichée dans la console. Dans cet exemple, elle a la valeur false
.
Enfin, on parcourt chacun des enregistrements pour insérer les données dans un tableau HTML. Pour consulter un exemple complet, vous pouvez vous référer à notre dépôt IDBIndex-example (voir également la démo live).
function displayDataByIndex() {
tableEntry.innerHTML = "";
var transaction = db.transaction(["contactsList"], "readonly");
var objectStore = transaction.objectStore("contactsList");
var myIndex = objectStore.index("lName");
console.log(myIndex.multiEntry);
myIndex.openCursor().onsuccess = function (event) {
var cursor = event.target.result;
if (cursor) {
var tableRow = document.createElement("tr");
tableRow.innerHTML =
"<td>" +
cursor.value.id +
"</td>" +
"<td>" +
cursor.value.lName +
"</td>" +
"<td>" +
cursor.value.fName +
"</td>" +
"<td>" +
cursor.value.jTitle +
"</td>" +
"<td>" +
cursor.value.company +
"</td>" +
"<td>" +
cursor.value.eMail +
"</td>" +
"<td>" +
cursor.value.phone +
"</td>" +
"<td>" +
cursor.value.age +
"</td>";
tableEntry.appendChild(tableRow);
cursor.continue();
} else {
console.log("Les éléments ont été affichés.");
}
};
}
Spécifications
Specification |
---|
Indexed Database API 3.0 # dom-idbindex-multientry |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- Utiliser IndexedDB
- Initier une connexion :
IDBDatabase
- Utiliser les transactions :
IDBTransaction
- Définir un intervalle de clés :
IDBKeyRange
- Récupérer et modifier les données :
IDBObjectStore
- Utiliser les curseurs
IDBCursor
- Exemple de référence : To-do Notifications (exemple live).