IDBKeyRange.bound()

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 bound() de l'interface IDBKeyRange renvoie un intervalle de clé entre deux limites .

L'intervalle peut être ouvert (les limites sont exclues) ou fermé (les limites sont incluse). Par défaut, l'intervalle est fermé.

Note : This feature is available in Web Workers.

Syntaxe

myKeyRange = IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen);

Paramètres

lower
La limite inférieur de l'intervalle.
upper
La limite supérieur de l'intervalle.
lowerOpen Facultatif
Si false (valeur par defaut), l'intervalle contient la limite inférieure.
upperOpen Facultatif
Si false (valeur par défaut), l'intervalle contient la limite supérieure.

Renvoie

Un intervalle de clé.

Exceptions

DataError
Cette exception est levé si :
  • Une des limites passé n'est pas valide.
  • La limite inférieur est supèrieur à la limite supérieur.
  • Les limites correspondent et l'intervalle est ouvert.

Exemple

Dans l'exemple suivant on récupère l'intervalle de clé entre "A" et "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 bound() sert à déterminer l'intervalle entre "A" et "F". Ici "A" et "F" sont inclues par défaut.

function displayData() {
  var keyRangeValue = IDBKeyRange.bound("A", "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 'bound()' dans cette spécification.
Recommendation  

Compatibilité avec les navigateurs

Fonctinnalité 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,