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
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
Specification |
---|
Indexed Database API 3.0 # ref-for-dom-idbfactory-cmp① |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- Utiliser IndexedDB
- Initier une connexion :
IDBDatabase
- Utiliser les transactions :
IDBTransaction
- Définir un intervalle de clés :
IDBKeyRange
- Récupérer et modifier les données :
IDBObjectStore
- Utiliser les curseurs
IDBCursor
- Exemple de référence : To-do Notifications (exemple live).