IDBKeyRange.upperBound()

Par défaut, la limite supérieur est incluse dans l'intervalle.

Syntaxe

myKeyRange = IDBKeyRange.upperBound(bound, open);

Paramètres

bound

La valeur de la limite supérieur de l'intervalle.

open Facultatif

false la limite est incluse, true la limite n'est pas incluse.

Renvoie

Un intervalle de clé.

Exceptions

DataError

Cette exception est levé si la valeur passé en paramètre n'est pas une clé valide.

Exemple

Dans l'exemple suivant on récupère l'intervalle de clé supérieur à "F". Puis on ouvre une transaction sur la connexion pour avoir l’accès au magasin d'objets 'fThings'. On met en place un curseur sur l'intervalle pour afficher dans une liste les valeurs des propriétés fThing et fRating des objets trouvés.

La méthode upperBound() sert à déterminer la limite supérieur de l'intervalle.

function displayData() {
  var keyRangeValue = IDBKeyRange.upperBound("F");

  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('Entries all displayed.');
      }
    };
  };

Pour un exemple de travail complet, voir notre To-do Notifications app (view example live).

Spécification

Compatibilité avec les navigateurs

Voir aussi

• Utiliser IndexedDB
• Débuter une connexion
• Utilisé les transactions
• Définir l'intervalle des clés
• Accès aux magasins d'objets
• Utiliser les curseur
• Exemple de référence: To-do Notifications (view example live.)