IDBIndex.getAllKeys()

Cet article nécessite une relecture technique. Voici comment vous pouvez aider.

Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.

La méthode proposé getAllKeys() de l'interface IDBIndex ferrais une requête qui renverrait la liste de toutes les clés des enregistrements de l'index. On pourrait limiter le nombre d'enregistrements en les filtrants suivant leurs clés ou en paramétrant le compteur.

Note : Cette méthode n'est ni incluse dans l'interface d'IndexDB ni disponible dans aucun navigateur, elle est seulement évoquée pour un éventuel ajout.

Syntaxe

var getAllKeysRequest = myIndex.getAllKeys(query,count);

Paramètres

query Facultatif
Une clé ou l'intervalle de clé pour filtrer, seules les clés des enregistrements correspondants sont renvoyées. Par défaut toutes les clés des enregistrements de l'index sont renvoyées.
count Facultatif
Le nombre de clés d'enregistrements maximum renvoyées. Un nombre décimal sera tronqué. Zéro annule le compteur et toutes les clés sont retournées.

Renvoie

Une requête
La propriété result de cette requête renvoie le tableau des clés des enregistrements en cas de succès.

Exceptions

TransactionInactiveError
Cette exception est levé si la transaction est inactive.
DataError
Cette exception est levé si la clé ou l'intervalle de clé est invalide.
InvalidStateError
Cette exception est levé si l'index à été supprimé.
TypeError
Cette exception est levé si le compteur n'est pas un nombre positif.

Exemple

//on récupéré un accès à l'index
var myIndex = objectStore.index('index');
//La requête pour récupéré les clé
var getAllKeyRequest = myIndex.getAllKeys();
//en cas de succès
getAllKeysRequest.onsuccess = function() {
  //on affiche la liste des clé
  console.log(getAllKeysRequest.result);
}

Spécification

Spécification Statut Commentaire
Indexed Database API (Second Edition)
La définition de 'getAll()' dans cette spécification.
Recommendation Initial definition.

Compatibilité avec les navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support basique 23webkit
24
10 moz
16.0 (16.0)
10, en partie 15 7.1
count() 23 22.0 (22.0) 10, en partie 15 7.1
getAll() and getAllKeys() 48.0 24.0 (24.0)avec dom.indexedDB.experimental activé Pas de support Pas de support Pas de support
Fonctionnalité Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile Chrome for Android
Support basique 4.4

(Oui)

22.0 (22.0) 1.0.1 10 22 Pas de support (Oui)
count() 4.4 ? 22.0 (22.0) 1.0.1 10 22 Pas de support ?
getAll() and getAllKeys() Pas de support 48.0 24.0 (24.0)
avec dom.indexedDB.experimental activé
1.1 avec dom.indexedDB.experimental activé Pas de support Pas de support Pas de support 48.0

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : gadgino
 Dernière mise à jour par : gadgino,