IDBIndex.getAllKeys()

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

requete Facultatif
Une clé ou un intervalle de clé (IDBKeyRange) qui identifie les clés qu'on souhaite récupérer. Si cette valeur vaut null ou est absente, le navigateur utilisera un intervalle de clé sans limite.
quantite Facultatif
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 à 232-1, une exception TypeError sera 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 :

Exception Description
TransactionInactiveError La transaction pour cet index IDBIndex est inactive.
InvalidStateError L'index IDBIndex a été supprimé ou déplacé.
TypeError Le paramètre quantite n'est pas compris entre 0 et 232-1

Exemples

var myIndex = objectStore.index('index');
var getAllKeyRequest = myIndex.getAllKeys();
getAllKeysRequest.onsuccess = function() {
  console.log(getAllKeysRequest.result);
}

Spécifications

Spécification État Commentaires
Indexed Database API Draft
La définition de 'getAll()' dans cette spécification.
Recommendation Définition initiale.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
getAllKeysChrome Support complet 48Edge Support complet OuiFirefox Support complet 44
Désactivée
Support complet 44
Désactivée
Désactivée From version 44: this feature is behind the dom.indexedDB.experimental preference. To change preferences in Firefox, visit about:config.
IE Aucun support NonOpera Support complet 35Safari Support complet 10.1WebView Android Support complet 48Chrome Android Support complet 48Firefox Android Support complet 44
Désactivée
Support complet 44
Désactivée
Désactivée From version 44: this feature is behind the dom.indexedDB.experimental preference. To change preferences in Firefox, visit about:config.
Opera Android Support complet 35Safari iOS Support complet 10.3Samsung Internet Android Support complet 5.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.

Voir aussi