IDBVersionChangeEvent

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note: This feature is available in Web Workers.

Giao diện IDBVersionChangeEvent của IndexedDB API cho biết rằng phiên bản của cơ sở dữ liệu đã thay đổi, là kết quả của hàm xử lý sự kiện onupgradeneeded.

Hàm khởi tạo

IDBVersionChangeEvent(): Tạo và trả về một đối tượng IDBVersionChangeEvent mới được sử dụng để đại diện cho khi phiên bản của cơ sở dữ liệu đã thay đổi.

Thuộc tính phiên bản

Cũng kế thừa các thuộc tính từ giao diện cha, Event.

IDBVersionChangeEvent.oldVersion Read only: Trả về phiên bản cũ của cơ sở dữ liệu.
IDBVersionChangeEvent.newVersion Read only: Trả về phiên bản mới của cơ sở dữ liệu.

Phương thức phiên bản

Không có phương thức đặc thù, nhưng kế thừa các phương thức từ giao diện cha, Event.

Trong đoạn code sau, chúng ta thực hiện một yêu cầu mở cơ sở dữ liệu và bao gồm các trình xử lý cho các trường hợp thành công và lỗi. Sau sự kiện thay đổi phiên bản (sau sự kiện upgradeneeded), sự kiện success sẽ triển khai giao diện IDBVersionChangeEvent. Để có ví dụ hoạt động đầy đủ, xem ứng dụng To-do Notifications (xem ví dụ trực tiếp).

const note = document.querySelector("ul");

// Hãy mở phiên bản 4 của cơ sở dữ liệu
const DBOpenRequest = window.indexedDB.open("toDoList", 4);

// hai trình xử lý sự kiện này hoạt động khi cơ sở dữ liệu được mở thành công hoặc khô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 vào biến db. Điều này được sử dụng nhiều về sau, để mở giao dịch và những thứ tương tự.
  const db = DBOpenRequest.result;
};