IDBKeyRange: lowerBound() 靜態方法
注意：此功能在 Web Workers 中可用。
lowerBound() 靜態方法是 IDBKeyRange 介面的一個方法，它建立一個只有下限的新鍵範圍。預設情況下，它包含下邊界值且是閉合的。
語法
js
IDBKeyRange.lowerBound(lower)
IDBKeyRange.lowerBound(lower, open)
引數
返回值
IDBKeyRange: 新建立的鍵範圍。
異常
DataErrorDOMException-
如果與
lower引數關聯的鍵無效，則丟擲此異常。
示例
以下示例說明了如何使用下限鍵範圍。此處我們宣告 keyRangeValue = IDBKeyRange.lowerBound("F", false); — 該範圍包含值 "F" 及其之後的所有值。我們開啟一個事務（使用 IDBTransaction）和一個物件儲存，並透過 IDBObjectStore.openCursor 開啟一個遊標，將 keyRangeValue 宣告為其可選鍵範圍值。這意味著遊標將僅檢索鍵值為 "F" 的記錄及其之後的所有記錄。如果我們使用 IDBKeyRange.lowerBound("F", true);，則該範圍不包含 "F"；只包含其之後的值。
注意：有關一個更完整的示例，允許您嘗試鍵範圍，請檢視我們的 IDBKeyRange-example 倉庫（也可以 線上檢視示例）。
js
function displayData() {
const keyRangeValue = IDBKeyRange.lowerBound("F");
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.");
}
};
}
規範
| 規範 |
|---|
| Indexed Database API 3.0 # ref-for-dom-idbkeyrange-lowerbound① |
瀏覽器相容性
載入中…
另見
- 使用 IndexedDB
- 開始事務：
IDBDatabase - 使用事務：
IDBTransaction - 設定鍵的範圍：
IDBKeyRange - 檢索和修改資料：
IDBObjectStore - 使用遊標：
IDBCursor - 參考示例：待辦事項通知（檢視即時示例）。