IDBIndex.getAll()

On peut comparer cette méthode avec une recherche par curseur. Effectivement, il est plus intéressant si l'on veut accéder aux enregistrements un par un d'utiliser un curseur, les clones structurés des valeurs seront fait un par un. Mais si l'on veut un tableau des clones structurés des valeurs il vaut mieux utilisé getAll(), le moteur Gecko feras les clones structurés en une seul fois.

Syntaxe

var getAllKeysRequest = IDBIndex.getAll(query, count);

Paramétres

query Facultatif

Une clé ou l'intervalle de clé pour filtrer, seule les valeurs des enregistrements correspondant sont renvoyées. Par défaut toutes les clones structurés des enregistrements de l'index relié sont renvoyés.

count Facultatif

Le nombre d'enregistrement maximum renvoyés. Un nombre décimal sera tronqué. Zéro annule le compteur et toutes les valeurs sont retournées.

Renvoie

Une requête

La propriété result de cette requête renvoie le tableau des clones structuré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é l’accès à l'index
var myIndex = objectStore.index('index');
//on fait une requête de recherche sur l'index
var getAllKeyRequest = myIndex.getAllKeys();
//si la requête reussi
getAllKeysRequest.onsuccess = function() {
  //on affiche le résultat sur la console 
  //~= [{key:'a',value:un_clone_structuré},{key:'2',value:un_clone_structuré},...]
  console.log(getAllKeysRequest.result);
}

Spécification

Compatibilité avec les navigateurs

 [1] Behind dom.indexedDB.experimental  pref.

Voir aussi

• Utiliser IndexedDB
• Débuter une connexion
• Utilisé les transactions
• Définir l'intervalle des clés
• Accès aux magasins d'objets
• Utiliser les curseur
• Exemple de référence: To-do Notifications (view example live.)