IDBCursor

Thuộc tính thể hiện

IDBCursor.source Read only

Trả về IDBObjectStore hoặc IDBIndex mà con trỏ đang duyệt. Hàm này không bao giờ trả về null hay ném ngoại lệ, ngay cả khi con trỏ đang được duyệt, đã đi quá phạm vi, hoặc transaction của nó không còn hoạt động.

IDBCursor.direction Read only

Trả về hướng duyệt của con trỏ.

IDBCursor.key Read only

Trả về khóa của bản ghi tại vị trí con trỏ. Nếu con trỏ nằm ngoài phạm vi, giá trị này được đặt là undefined. Khóa của con trỏ có thể là bất kỳ kiểu dữ liệu nào.

IDBCursor.primaryKey Read only

Trả về khóa chính hiệu lực hiện tại của con trỏ. Nếu con trỏ đang được duyệt hoặc đã duyệt ra ngoài phạm vi, giá trị này được đặt là undefined. Khóa chính của con trỏ có thể là bất kỳ kiểu dữ liệu nào.

IDBCursor.request Read only

Trả về IDBRequest đã được dùng để lấy con trỏ.

Phương thức thể hiện

IDBCursor.advance()

Thiết lập số lần mà con trỏ sẽ di chuyển vị trí của nó về phía trước.

IDBCursor.continue()

Đưa con trỏ đến vị trí tiếp theo theo hướng của nó, tới mục có khóa khớp với tham số key tùy chọn.

IDBCursor.continuePrimaryKey()

Đưa con trỏ đến khóa index và khóa chính đã cho dưới dạng đối số.

IDBCursor.delete()

Trả về một đối tượng IDBRequest và, trên một luồng riêng, xóa bản ghi tại vị trí của con trỏ mà không thay đổi vị trí đó. Điều này có thể dùng để xóa các bản ghi cụ thể.

IDBCursor.update()

Trả về một đối tượng IDBRequest và, trên một luồng riêng, cập nhật giá trị tại vị trí hiện tại của con trỏ trong object store. Điều này có thể dùng để cập nhật các bản ghi cụ thể.

Hằng số

• NEXT: "next" : Con trỏ hiển thị tất cả bản ghi, kể cả bản ghi trùng. Nó bắt đầu từ giới hạn dưới của key range và di chuyển lên trên (tăng đơn điệu theo thứ tự khóa).
• NEXTUNIQUE: "nextunique" : Con trỏ hiển thị tất cả bản ghi, loại trừ bản ghi trùng. Nếu có nhiều bản ghi có cùng khóa, chỉ bản ghi đầu tiên được duyệt mới được trả về. Nó bắt đầu từ giới hạn dưới của key range và di chuyển lên trên.
• PREV: "prev" : Con trỏ hiển thị tất cả bản ghi, kể cả bản ghi trùng. Nó bắt đầu từ giới hạn trên của key range và di chuyển xuống dưới (giảm đơn điệu theo thứ tự khóa).
• PREVUNIQUE: "prevunique" : Con trỏ hiển thị tất cả bản ghi, loại trừ bản ghi trùng. Nếu có nhiều bản ghi có cùng khóa, chỉ bản ghi đầu tiên được duyệt mới được trả về. Nó bắt đầu từ giới hạn trên của key range và di chuyển xuống dưới.

Ví dụ

Trong đoạn ví dụ đơn giản này, chúng ta tạo một transaction, lấy một object store, rồi dùng một con trỏ để duyệt qua tất cả bản ghi trong object store. Con trỏ không yêu cầu chúng ta chọn dữ liệu theo khóa; chúng ta chỉ cần lấy toàn bộ dữ liệu. Lưu ý thêm rằng ở mỗi vòng lặp, bạn có thể lấy dữ liệu từ bản ghi hiện tại dưới đối tượng con trỏ bằng cursor.value.foo. Để xem ví dụ hoàn chỉnh, hãy xem ví dụ IDBCursor (xem bản chạy trực tiếp).

function displayData() {
  const transaction = db.transaction(["rushAlbumList"], "readonly");
  const objectStore = transaction.objectStore("rushAlbumList");

  objectStore.openCursor().onsuccess = (event) => {
    const cursor = event.target.result;
    if (cursor) {
      const listItem = document.createElement("li");
      listItem.textContent = `${cursor.value.albumTitle}, ${cursor.value.year}`;
      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

• Using IndexedDB
• Bắt đầu transaction: IDBDatabase
• Sử dụng transaction: IDBTransaction
• Thiết lập một phạm vi khóa: IDBKeyRange
• Truy xuất và thay đổi dữ liệu của bạn: IDBObjectStore
• Tham chiếu ví dụ: To-do Notifications (xem bản chạy trực tiếp).