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.

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

Browser-Kompatibilität

Siehe auch

• Verwendung von IndexedDB
• Starten von Transaktionen: IDBDatabase
• Verwendung von Transaktionen: IDBTransaction
• Festlegen eines Schlüsselbereichs: IDBKeyRange
• Abrufen und Ändern Ihrer Daten: IDBObjectStore
• Verwendung von Cursorn: IDBCursor
• Referenzbeispiel: To-do Notifications (Beispiel live ansehen).