IDBObjectStore: phương thức put()

Cú pháp

put(item)
put(item, key)

Tham số

item

Mục bạn muốn cập nhật (hoặc chèn).

key Optional

Khóa chính của bản ghi bạn muốn cập nhật (ví dụ: từ IDBCursor.primaryKey).

Giá trị trả về

Một đối tượng IDBRequest mà các sự kiện tiếp theo liên quan đến thao tác này sẽ được kích hoạt trên đó.

Nếu thao tác thành công, giá trị của thuộc tính result của request là khóa của bản ghi mới hoặc đã cập nhật.

Ngoại lệ

Phương thức này có thể gây ra một DOMException thuộc một trong các loại sau:

ReadOnlyError DOMException

Được ném nếu giao dịch liên quan đến thao tác này đang ở chế độ chỉ đọc.

TransactionInactiveError DOMException

Được ném nếu giao dịch của IDBObjectStore này không hoạt động.

DataError DOMException

Được ném nếu bất kỳ điều kiện nào sau đây áp dụng:

• Object store sử dụng khóa nội tuyến hoặc có bộ tạo khóa, và tham số key đã được cung cấp.
• Object store sử dụng khóa ngoại tuyến và không có bộ tạo khóa, và không có tham số key nào được cung cấp.
• Object store sử dụng khóa nội tuyến nhưng không có bộ tạo key, và đường dẫn khóa của object store không tạo ra một khóa hợp lệ.
• Tham số key đã được cung cấp nhưng không chứa một khóa hợp lệ.

InvalidStateError DOMException

Được ném nếu IDBObjectStore đã bị xóa hoặc loại bỏ.

DataCloneError DOMException

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

Ví dụ

Ví dụ sau yêu cầu một tiêu đề bản ghi nhất định; khi yêu cầu đó thành công, hàm onsuccess lấy bản ghi liên kết từ IDBObjectStore (được cung cấp dưới dạng objectStoreTitleRequest.result), cập nhật một thuộc tính của bản ghi, sau đó đưa bản ghi đã cập nhật trở lại object store trong một yêu cầu khác bằng put(). Để xem ví dụ hoạt động đầy đủ, hãy tham khảo ứng dụng To-do Notifications của chúng tôi (xem ví dụ trực tiếp).

const title = "Walk dog";

// Mở một giao dịch như bình thường
const objectStore = db
  .transaction(["toDoList"], "readwrite")
  .objectStore("toDoList");

// Lấy đối tượng danh sách việc cần làm có tiêu đề này
const objectStoreTitleRequest = objectStore.get(title);

objectStoreTitleRequest.onsuccess = () => {
  // Lấy đối tượng dữ liệu được trả về làm kết quả
  const data = objectStoreTitleRequest.result;

  // Cập nhật giá trị notified trong đối tượng thành "yes"
  data.notified = "yes";

  // Tạo một yêu cầu khác chèn mục này trở lại cơ sở dữ liệu
  const updateTitleRequest = objectStore.put(data);

  // Ghi lại giao dịch đã khởi tạo yêu cầu này
  console.log(
    `The transaction that originated this request is ${updateTitleRequest.transaction}`,
  );

  // Khi yêu cầu mới này thành công, chạy lại hàm displayData() để cập nhật hiển thị
  updateTitleRequest.onsuccess = () => {
    displayData();
  };
};

Đặc tả kỹ thuật

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

Xem thêm

• Sử dụng IndexedDB
• Bắt đầu giao dịch: IDBDatabase
• Sử dụng giao dịch: IDBTransaction
• Thiết lập 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
• Ví dụ tham khảo: To-do Notifications (Xem ví dụ trực tiếp).