IDBKeyRange.upperBound()

Cet article nécessite une relecture technique. Voici comment vous pouvez aider.

Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.

La méthode upperBound() de l'interface IDBKeyRange renvoie un intervalle de clé avec une limite supérieure.

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

Note : This feature is available in Web Workers.

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

Spécification Statut Commentaire
Indexed Database API
La définition de 'upperBound()' dans cette spécification.
Recommendation  

Compatibilité avec les navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support basique 23webkit
24
10 moz
16.0 (16.0)
10, en partie 15 7.1
Disponible dans workers (Oui) 37.0 (37.0) ? (Oui) ?
Fonctionnalité Android Firefox Mobile (Gecko) Firefox OS IE Phone Opera Mobile Safari Mobile
Support basique 4.4 22.0 (22.0) 1.0.1 10 22 8
Disponible dans workers (Oui) 37.0 (37.0) (Oui) ? (Oui) ?

Voir aussi

Étiquettes et contributeurs liés au document

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