IDBIndex.getAllKeys()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2020.
La méthode getAllKeys(), rattachée à l'interface IDBIndex, permet de récupérer les clés de tous les objets contenus dans l'index et de les enregistrer dans la propriété result de l'objet renvoyé par la méthode.
Syntaxe
var getAllKeysRequest = IDBIndex.getAllKeys();
var getAllKeysRequest = IDBIndex.getAllKeys(requete);
var getAllKeysRequest = IDBIndex.getAllKeys(requete, quantite);
Paramètres
requeteFacultatif-
Une clé ou un intervalle de clé (
IDBKeyRange) qui identifie les clés qu'on souhaite récupérer. Si cette valeur vautnullou est absente, le navigateur utilisera un intervalle de clé sans limite. quantiteFacultatif-
Le nombre d'enregistrements qu'on souhaite obtenir. Si cette quantité est supérieure au nombre d'enregistrements récupérés par la requête, le navigateur ne récupèrera que le premier élément. Si elle est négative ou supérieure à
2^32-1, une exceptionTypeErrorsera levée.
Valeur de retour
Un objet IDBRequest sur lequel seront reçus les différents évènements rattachés à cette opération.
Exceptions
Cette méthode peut déclencher une des exceptions suivantes :
Exemples
var myIndex = objectStore.index("index");
var getAllKeyRequest = myIndex.getAllKeys();
getAllKeysRequest.onsuccess = function () {
console.log(getAllKeysRequest.result);
};
Spécifications
| Specification |
|---|
| Indexed Database API 3.0 # ref-for-dom-idbindex-getallkeys① |
Compatibilité des navigateurs
Chargement…
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).