IDBKeyRange: upper-Eigenschaft

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die upper Eigenschaft, die schreibgeschützte Eigenschaft des IDBKeyRange-Interfaces, gibt die obere Grenze des Schlüsselbereichs zurück.

Wert

Die obere Grenze des Schlüsselbereichs (kann jeden Typ haben).

Beispiele

Das folgende Beispiel zeigt, wie man einen Schlüsselbereich verwendet. Hier deklarieren wir keyRangeValue = IDBKeyRange.upperBound("F", "W", true, true); — ein Bereich, der alles zwischen "F" und "W", aber ohne sie, umfasst — da sowohl die obere als auch die untere Grenze als offen (true) angegeben wurden. Wir öffnen eine Transaktion (mithilfe von IDBTransaction) und einen Objektspeicher und öffnen einen Cursor mit IDBObjectStore.openCursor, wobei wir keyRangeValue als optionalen Schlüsselbereichswert angeben.

Nach der Deklaration des Schlüsselbereichs protokollieren wir seinen upper-Eigenschaftswert in die Konsole, der als "W" erscheinen sollte.

Hinweis: Für ein vollständigeres Beispiel, das Ihnen erlaubt mit Schlüsselbereichen zu experimentieren, schauen Sie sich unser IDBKeyRange-Beispiel Repository an (sehen Sie sich das Beispiel auch live an.)

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

  const transaction = db.transaction(["fThings"], "readonly");
  const objectStore = transaction.objectStore("fThings");

  objectStore.openCursor(keyRangeValue).onsuccess = (event) => {
    const cursor = event.target.result;
    if (cursor) {
      const listItem = document.createElement("li");
      listItem.textContent = `${cursor.value.fThing}, ${cursor.value.fRating}`;
      list.appendChild(listItem);

      cursor.continue();
    } else {
      console.log("Entries all displayed.");
    }
  };
}

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch