IDBCursor: phương thức update()

Cú pháp

update(value)

Tham số

value

Giá trị mới sẽ được lưu tại vị trí hiện tại.

Giá trị trả về

Một đối tượng IDBRequest, trên đó các sự kiện tiếp theo liên quan đến thao tác này sẽ được phát ra.

Nếu thao tác thành công, giá trị của thuộc tính result của request sẽ là khóa của bản ghi đã được cập nhật.

Ngoại lệ

Phương thức này có thể ném ra một DOMException thuộc một trong các kiểu sau:

TransactionInactiveError DOMException

Được ném ra nếu transaction của IDBCursor này không hoạt động.

ReadOnlyError DOMException

Được ném ra nếu chế độ transaction là chỉ đọc.

InvalidStateError DOMException

Được ném ra nếu con trỏ được tạo bằng IDBindex.openKeyCursor, đang được duyệt, hoặc đã duyệt quá phần cuối.

DataError DOMException

Được ném ra nếu object store bên dưới dùng khóa nội tuyến và thuộc tính trong giá trị tại key path của object store không khớp với khóa ở vị trí hiện tại của con trỏ này.

DataCloneError DOMException

Được ném ra nếu dữ liệu đang được lưu không thể được sao chép bởi thuật toán structured cloning nội bộ.

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 các bản ghi trong object store. Nếu albumTitle của con trỏ hiện tại là "A farewell to kings", chúng ta cập nhật năm phát hành của album bằng const request = cursor.update();.

Lưu ý rằng bạn không thể thay đổi khóa chính bằng cursor.update(), vì vậy chúng ta không đổi tiêu đề album; điều đó sẽ làm hỏng tính toàn vẹn của dữ liệu. Trong trường hợp đó, bạn phải xóa toàn bộ bản ghi rồi thêm một bản ghi mới bằng IDBObjectStore.add. Cũng lưu ý rằng bạn không thể đưa trực tiếp cursor.value vào lời gọi update, vì vậy ví dụ dưới đây dùng biến trung gian updateData.

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 updateResult() {
  list.textContent = "";
  const transaction = db.transaction(["rushAlbumList"], "readwrite");
  const objectStore = transaction.objectStore("rushAlbumList");

  objectStore.openCursor().onsuccess = (event) => {
    const cursor = event.target.result;
    if (cursor) {
      if (cursor.value.albumTitle === "A farewell to kings") {
        const updateData = cursor.value;

        updateData.year = 2050;
        const request = cursor.update(updateData);
        request.onsuccess = () => {
          console.log("A better album year?");
        };
      }

      const listItem = document.createElement("li");
      listItem.textContent = `${cursor.value.albumTitle}, ${cursor.value.year}`;
      list.appendChild(listItem);
      cursor.continue();
    } else {
      console.log("Entries 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
• Sử dụng con trỏ: IDBCursor
• Tham chiếu ví dụ: To-do Notifications (xem bản chạy trực tiếp).