IDBKeyRange: upper-Eigenschaft
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.)
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
- 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).