语法
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 - 参考示例：待办事项通知（查看实时示例）。