IDBKeyRange.upper
La propriété upper
, rattachée à l'interface IDBKeyRange
, renvoie la borne supérieure de l'intervalle de clé.
Note : Cette fonctionnalité est disponible via les Web Workers.
Syntaxe
monIntervalle.upper;
Valeur
La borne supérieure de l'intervalle de clé (qui peut être d'un type quelconque).
Exemples
Dans l'exemple qui suit, on voit comment utiliser un intervalle de clé. On déclare keyRangeValue = IDBKeyRange.upperBound("F", "W", true, true);
— ce qui correspond à intervalle qui inclut tout ce qui se trouve entre "F" et "W" mais pas ces valeurs (l'intervalle est « ouvert »). Ensuite, on ouvre une transaction grâce à IDBTransaction
, un magasin d'objet et un curseur grâce à IDBObjectStore.openCursor
pour lequel on déclare que keyRangeValue
est l'intervalle de clé optionnel.
Après avoir déclaré l'intervalle de clé, on affiche la valeur de la propriété upper
dans la console (ce qui doit donner "W").
function displayData() {
var keyRangeValue = IDBKeyRange.bound("F", "W", true, true);
console.log(keyRangeValue.upper);
var transaction = db.transaction(["fThings"], "readonly");
var objectStore = transaction.objectStore("fThings");
objectStore.openCursor(keyRangeValue).onsuccess = function (event) {
var cursor = event.target.result;
if (cursor) {
var listItem = document.createElement("li");
listItem.innerHTML =
"<strong>" + cursor.value.fThing + "</strong>, " + cursor.value.fRating;
list.appendChild(listItem);
cursor.continue();
} else {
console.log("Les éléments ont été affichés.");
}
};
}
Note : Pour un exemple complet qui utilise les intervalles de clé, vous pouvez consulter le dépôt GitHub IDBKeyRange-example (ainsi que la démonstration associée).
Spécifications
Specification |
---|
Indexed Database API 3.0 # ref-for-dom-idbkeyrange-upper① |
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).