IDBKeyRange.bound()

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

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

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.)