IndexedDB
The upperOpen read-only property of the
IDBKeyRange interface returns a boolean indicating whether the
upper-bound value is included in the key range.
Value
A boolean value:
| Value | Indication |
|---|---|
true |
The upper-bound value is not included in the key range. |
false |
The upper-bound value is included in the key range. |
Examples
The following example illustrates how you'd use a key range. Here we
declare keyRangeValue = IDBKeyRange.upperBound("F", "W", true, true); — a
range that includes everything between "F" and "W" but not including them — since both
the upper and lower bounds have been declared as open (true). We open a
transaction (using IDBTransaction) and an object store, and open a Cursor
with IDBObjectStore.openCursor, declaring keyRangeValue as
its optional key range value.
After declaring the key range, we log its upperOpen property value to the
console, which should appear as "true": the upper bound is open, so won't be included in
the range.
[!NOTE] For a more complete example allowing you to experiment with key range, have a look at our IDBKeyRange-example repo (view the example live too.)
function displayData() {
const keyRangeValue = IDBKeyRange.bound("F", "W", true, true);
console.log(keyRangeValue.upperOpen);
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.");
}
};
}
Specifications
Browser compatibility
See also
- Using IndexedDB
- Starting transactions: IDBDatabase
- Using transactions: IDBTransaction
- Setting a range of keys: IDBKeyRange
- Retrieving and making changes to your data: IDBObjectStore
- Using cursors: IDBCursor
- Reference example: To-do Notifications (View the example live).
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
