IDBFactory.cmp()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
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
Chargement…
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).