IDBRequest

Thuộc tính thể hiện

Cũng kế thừa các thuộc tính từ EventTarget.

IDBRequest.error Read only

Trả về một DOMException trong trường hợp request không thành công, cho biết lỗi đã xảy ra là gì.

IDBRequest.result Read only

Trả về kết quả của request. Nếu request chưa hoàn tất, kết quả sẽ không khả dụng và ngoại lệ InvalidStateError sẽ được ném ra.

IDBRequest.source Read only

Nguồn của request, chẳng hạn một IDBIndex hoặc IDBObjectStore. Nếu không có nguồn nào tồn tại, ví dụ khi gọi IDBFactory.open, thuộc tính này trả về null.

IDBRequest.readyState Read only

Trạng thái của request. Mọi request đều bắt đầu ở trạng thái pending. Trạng thái sẽ chuyển thành done khi request hoàn tất thành công hoặc khi xảy ra lỗi.

IDBRequest.transaction Read only

Transaction của request. Thuộc tính này có thể là null đối với một số request, ví dụ các request được trả về từ IDBFactory.open trừ khi cần nâng cấp. Khi đó bạn chỉ đang kết nối tới cơ sở dữ liệu, nên không có transaction nào để trả về.

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

Không có phương thức, nhưng kế thừa các phương thức từ EventTarget.

Sự kiện

Nghe các sự kiện này bằng addEventListener() hoặc bằng cách gán trình xử lý sự kiện vào thuộc tính oneventname của giao diện này.

error

Được kích hoạt khi một lỗi làm request thất bại.

success

Được kích hoạt khi IDBRequest thành công.

Ví dụ

Trong đoạn mã sau, chúng ta mở một cơ sở dữ liệu bất đồng bộ và tạo một request; các hàm onerror và onsuccess được dùng để xử lý trường hợp thành công và lỗi. Để xem một ví dụ hoạt động đầy đủ, hãy xem ứng dụng To-do Notifications của chúng tôi (xem ví dụ trực tiếp).

let db;

// Mở cơ sở dữ liệu của chúng ta
const DBOpenRequest = window.indexedDB.open("toDoList", 4);

// hai trình xử lý sự kiện này phản ứng khi cơ sở dữ liệu
// được mở thành công hoặc không thành công
DBOpenRequest.onerror = (event) => {
  note.appendChild(document.createElement("li")).textContent =
    "Error loading database.";
};

DBOpenRequest.onsuccess = (event) => {
  note.appendChild(document.createElement("li")).textContent =
    "Database initialized.";

  // lưu kết quả mở cơ sở dữ liệu
  db = DBOpenRequest.result;
};

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à thay đổ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).