IDBKeyRange.only()

Syntaxe

myKeyRange = IDBKeyRange.only(value);

Paramètre

value

La valeur unique de l'intervalle.

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é contenant une valeur unique "A". 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 only() sert à déterminer la valeur unique de l'intervalle.

function displayData() {
  var keyRangeValue = IDBKeyRange.only("A");

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