IDBFactory.cmp()

La méthode cmp() de l'interface IDBFactory compare deux valeurs de clé et détermine si celles-ci sont égales et sinon, laquelle est la plus grande. Cette opération est utilisée pour l'enregistrement et le parcours des données.

Note : Cette fonctionnalité est disponible via les Web Workers.

Note : Cette méthode ne doit pas être utilisée pour comparer des valeurs JavaScript. En effet, de nombreuses valeurs JavaScript ne sont pas des valeurs valides pour représenter des clés IndexedDB (les booléens et les objets par exemple), dans ces cas, elles peuvent être traitées comme des clés égales (ainsi IndexedDB ignore les tableaux ayant des propriétés non numériques et les considère comme des tableaux vides, de sorte que les éventuels tableaux non numériques seront considérés comme égaux). Une exception est levée si l'une des valeurs n'est pas une clé valide.

Syntaxe

var resultat = window.indexedDB.cmp(a, b);

Paramètres

a
La première clé pour la comparaison.
b
La deuxième clé pour la comparaison.

Valeur de retour

Un entier qui indique le résultat de la comparaison. Le tableau ci-dessous indique les valeurs possibles et leur signification :

Valeur renvoyée Description
-1 La clé 1 est plus petite que la clé 2.
0 Les deux clé sont égales.
1 La clé 1 est plus grande que la clé 2.

Exceptions levées

Cette méthode peut lever une exception DOMException de type :

Exception Description
DataError L'une des clés fournies n'est pas valide.

Exemples

var a = 1;
var b = 2;
var result = window.indexedDB.cmp(a, b);
console.log( "Résultat de la comparaison : " + result );

Spécifications

Spécification État Commentaires
Indexed Database API
La définition de 'cmp' dans cette spécification.
Recommendation  

Compatibilité des navigateurs

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support simple 23webkit
24
(Oui) 10 moz
16.0 (16.0)
10 15 7.1
Disponible dans les workers (Oui) (Oui) 37.0 (37.0) (Oui) (Oui) 10
Fonctionnalité Android Webview Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome pour Android
Support simple 4.4 (Oui) (Oui) 22.0 (22.0) 10 22 8 (Oui)
Disponible dans les workers (Oui) (Oui) (Oui) 37.0 (37.0) (Oui) (Oui) 10 (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

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