大网数据广告活动
Web 标准与前端开发

IDBKeyRange.lowerBound()

· 52CE 我爱测

IDBKeyRange 接口的 **`lowerBound()`** 方法创建一个只有下限的新的键范围。默认情况下,它包含较低的端点值。

IndexedDB

IDBKeyRange 接口的 lowerBound() 方法创建一个只有下限的新的键范围。默认情况下,它包含较低的端点值。

语法

IDBKeyRange.lowerBound(lower)
IDBKeyRange.lowerBound(lower, open)

参数

  • lower
    • : 指定新键范围的下限。
  • open
    • : 指示下限是否排除端点值。默认值为 false。

返回值

IDBKeyRange: 新创建的键范围。

异常

此方法可能引发以下类型的 DOMException :

Exception Description
DataError The value parameter passed was not a valid key.

示例

下面的示例演示如何使用下限键范围。在这里,我们声明keyRangeValue = IDBKeyRange.lowerBound("F", false);— 一个包含值“F”及其后所有内容的范围。我们打开一个事务(使用 IDBTransaction)和一个对象存储,并使用 IDBObjectStore.openCursor打开一个游标,声明keyRangeValue 为其可选的键范围值。这意味着光标将只检索键值为“F”及其后面的所有记录。如果使用IDBKeyRange.lowerBound("F", true);,则该范围将不包括端点“F”,仅包括其后面的值。

[!NOTE] 要获得一个更完整的示例,使你能够使用键范围进行实验,请查看我们的 IDBKeyRange-example(实时查看该示例)。

function displayData() {
  var keyRangeValue = IDBKeyRange.lowerBound("F");

  var transaction = db.transaction(["fThings"], "readonly");
  var objectStore = transaction.objectStore("fThings");

  objectStore.openCursor(keyRangeValue).onsuccess = function (event) {
    var cursor = event.target.result;
    if (cursor) {
      var listItem = document.createElement("li");
      listItem.innerHTML =
        "<strong>" + cursor.value.fThing + "</strong>, " + cursor.value.fRating;
      list.appendChild(listItem);

      cursor.continue();
    } else {
      console.log("Entries all displayed.");
    }
  };
}

规范

浏览器兼容性

参见

  • 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 example live.)

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。