語法
js
IDBKeyRange.only(value)
引數
value-
新鍵範圍的值。
返回值
IDBKeyRange: 新建立的鍵範圍。
異常
DataErrorDOMException-
如果
value引數不是有效鍵，則丟擲此異常。
示例
下面的示例說明了如何使用 only 鍵範圍。在這裡，我們宣告 keyRangeValue = IDBKeyRange.only("A"); — 一個僅包含值 "A" 的範圍。我們開啟一個事務（使用 IDBTransaction）和一個物件儲存，並使用 IDBObjectStore.openCursor 開啟一個遊標，將 keyRangeValue 宣告為其可選的鍵範圍值。這意味著遊標將僅檢索鍵值為 "A" 的記錄。
注意： 要獲得更完整的示例，允許您嘗試鍵範圍，請檢視我們的 IDBKeyRange 儲存庫（也可以 線上檢視示例）。
js
function displayData() {
const keyRangeValue = IDBKeyRange.only("A");
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-only① |
瀏覽器相容性
載入中…
另見
- 使用 IndexedDB
- 開始事務：
IDBDatabase - 使用事務：
IDBTransaction - 設定鍵的範圍：
IDBKeyRange - 檢索和修改資料：
IDBObjectStore - 使用遊標：
IDBCursor - 參考示例：待辦事項通知（檢視即時示例）。