IDBKeyRange.upper

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

La propriété upper, rattachée à l'interface IDBKeyRange, renvoie la borne supérieure de l'intervalle de clé.

Note : Cette fonctionnalité est disponible via les Web Workers.

Syntaxe

js
monIntervalle.upper;

Valeur

La borne supérieure de l'intervalle de clé (qui peut être d'un type quelconque).

Exemples

Dans l'exemple qui suit, on voit comment utiliser un intervalle de clé. On déclare keyRangeValue = IDBKeyRange.upperBound("F", "W", true, true); — ce qui correspond à intervalle qui inclut tout ce qui se trouve entre "F" et "W" mais pas ces valeurs (l'intervalle est « ouvert »). Ensuite, on ouvre une transaction grâce à IDBTransaction, un magasin d'objet et un curseur grâce à IDBObjectStore.openCursor pour lequel on déclare que keyRangeValue est l'intervalle de clé optionnel.

Après avoir déclaré l'intervalle de clé, on affiche la valeur de la propriété upper dans la console (ce qui doit donner "W").

js
function displayData() {
  var keyRangeValue = IDBKeyRange.bound("F", "W", true, true);
  console.log(keyRangeValue.upper);

  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("Les éléments ont été affichés.");
    }
  };
}

Note : Pour un exemple complet qui utilise les intervalles de clé, vous pouvez consulter le dépôt GitHub IDBKeyRange-example (ainsi que la démonstration associée).

Spécifications

Specification
Indexed Database API 3.0
# ref-for-dom-idbkeyrange-upper①

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi