IDBKeyRange: lower-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 lower schreibgeschützte Eigenschaft der IDBKeyRange-Schnittstelle gibt die untere Grenze des Schlüsselspektrums zurück.

Wert

Die untere Grenze des Schlüsselspektrums (kann jeden Typ haben).

Beispiele

Das folgende Beispiel veranschaulicht, wie Sie ein Schlüsselspektrum verwenden würden. Hier deklarieren wir keyRangeValue = IDBKeyRange.upperBound("F", "W", true, true); — ein Spektrum, das alles zwischen "F" und "W" umfasst, aber sie nicht einschließt — da sowohl die obere als auch die untere Grenze als offen (true) deklariert wurden. Wir öffnen eine Transaktion (mit IDBTransaction) und ein Objekt-Store und öffnen einen Cursor mit IDBObjectStore.openCursor, wobei keyRangeValue als optionaler Schlüsselspektrumswert deklariert wird.

Nachdem das Schlüsselspektrum deklariert wurde, protokollieren wir dessen lower-Eigenschaftswert in der Konsole, die als "F" erscheinen sollte.

Hinweis: Für ein vollständigeres Beispiel, das es Ihnen ermöglicht, mit Schlüsselspektren zu experimentieren, schauen Sie sich unser IDBKeyRange-Beispiel Repository an. (Sie können das Beispiel auch live ansehen).

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

  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-lower①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch