MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

IDBObjectStore.getAllKeys()

La méthode getAllKeys(), rattachée ) l'interface IDBObjectStore, renvoie un objet  IDBRequest qui permet de récupérer l'ensemble des clés pour les objets qui correspondent au critère passé en argument (ou les clés de tous les objets du magasin si aucun paramètre n'est fourni).

Si une valeur est trouvée, un clone structurelle sera créé et fourni comme résultat pour la requête.

Cette méthode produira le même résultat pour :

  • un enregistrement qui n'existe pas dans la base de données
  • un enregistrement qui possède une valeur indéfinie

Pour différencier ces deux situations, on peut appeler la méthode openCursor() avec la même clé. Cette méthode fournit un curseur si l'enregistrement existe et ne fournit aucun curseur s'il n'y a pas d'enregistrement.

Syntaxe

var request = objectStore.getAllKeys();
var request = objectStore.getAllKeys(query);
var request = objectStore.getAllKeys(query, count);

Parameters

query Facultatif
Une valeur qui est (ou se résoud) en un intervalle de clés (IDBKeyRange).
count Facultatif
Une valeur qui définit le nombre de valeurs à renvoyer si plusieurs correspondent. Cette valeur doit être supérieure à  0 ou inférieure à 232-1, sinon une exception TypeError sera levée.

Valeur de retour

Un objet IDBRequest pour lequel seront déclenchés les différents évènements relatifs à l'opération.

Exceptions

Cette méthode peut déclencher une exception DOMException ayant le type suivant :

Exception Description
TransactionInactiveError Le magasin d'objets (IDBObjectStore) associé à la transaction est inactif.
DataError

La clé ou l'intervalle de clé fourni contient une clé invalide ou est nul.

InvalidStateError Le magasin d'objets (IDBObjectStore) a été supprimé ou retiré.

Spécifications

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

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support simple 48.0 44 (44) ? 35 ?
Disponible dans les web workers 48.0 ? ? 35 ?
Fonctionnalité Android Webview Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome pour Android
Support simple Pas de support 48.0 44.0 (44) ? 35 ? 48.0
Disponible dans les web workers Pas de support 48.0 ? ? 35 ? 48.0

[1] Cette fonctionnalité était disponible depuis Firefox 27 via la préférence dom.indexedDB.experimental, qui était désactivée par défaut.

Voir aussi

Étiquettes et contributeurs liés au document

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