IDBKeyRange: phương thức tĩnh upperBound()

Cú pháp

IDBKeyRange.upperBound(upper)
IDBKeyRange.upperBound(upper, open)

Tham số

upper

Chỉ định giới hạn trên của phạm vi khóa mới.

open Optional

Cho biết giới hạn trên có loại trừ giá trị đầu mút hay không. Mặc định là false.

Giá trị trả về

IDBKeyRange: Phạm vi khóa vừa được tạo.

Ngoại lệ

DataError DOMException

Được ném ra nếu khóa gắn với tham số upper không phải là một khóa hợp lệ.

Ví dụ

Ví dụ sau minh họa cách dùng phạm vi khóa chỉ có giới hạn trên. Ở đây chúng ta khai báo keyRangeValue = IDBKeyRange.upperBound("F"); - một phạm vi bao gồm giá trị "F" và mọi giá trị trước nó. Chúng ta mở một transaction (dùng IDBTransaction) và một object store, rồi mở một cursor bằng IDBObjectStore.openCursor, với keyRangeValue là giá trị phạm vi khóa tùy chọn.

Nếu dùng IDBKeyRange.upperBound("F", true);, thì phạm vi sẽ loại trừ "F" và chỉ gồm các giá trị trước nó.

function displayData() {
  const keyRangeValue = IDBKeyRange.upperBound("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.");
    }
  };
}

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• Dùng IndexedDB
• Bắt đầu transaction: IDBDatabase
• Dùng transaction: IDBTransaction
• Thiết lập một phạm vi khóa: IDBKeyRange
• Truy xuất và sửa đổi dữ liệu của bạn: IDBObjectStore
• Dùng cursor: IDBCursor
• Ví dụ tham khảo: To-do Notifications (Xem ví dụ trực tiếp).