IDBFactory: phương thức databases()

Cú pháp

databases()

Tham số

Không có.

Giá trị trả về

Một Promise được fulfill với một mảng các đối tượng đại diện cho ảnh chụp nhanh của các cơ sở dữ liệu hiện có, hoặc bị reject với lỗi/ngoại lệ bên dưới.

Mỗi đối tượng trong mảng có các thuộc tính sau:

name

Tên cơ sở dữ liệu.

version

Phiên bản cơ sở dữ liệu.

Lưu ý rằng thứ tự của các đối tượng được trả về là không xác định.

Ngoại lệ

SecurityError DOMException

Được ném ra nếu phương thức được gọi từ một origin mờ đục hoặc người dùng đã tắt lưu trữ.

UnknownError DOMException

Được ném ra nếu không thể xác định tập hợp các cơ sở dữ liệu hiện có vì bất kỳ lý do gì.

Ví dụ

Tạo và liệt kê cơ sở dữ liệu

Ví dụ này tạo/mở một số cơ sở dữ liệu. Khi mỗi cơ sở dữ liệu khởi tạo thành công, nó sẽ liệt kê tất cả các cơ sở dữ liệu hiện có.

<pre id="log"></pre>

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

#log {
  height: 240px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

Trước tiên chúng ta định nghĩa hàm được dùng để lấy và ghi log các cơ sở dữ liệu hiện có. Hàm này chờ promise do indexedDB.databases() trả về rồi lặp qua mảng và ghi lại giá trị của từng phần tử:

async function getDb() {
  const databases = await indexedDB.databases();
  log("Danh sách cơ sở dữ liệu:");
  databases.forEach((element) => {
    log(`name: ${element.name}, version: ${element.version}`);
  });
}

Để minh họa cách dùng hàm trên, bên dưới chúng ta tạo hai cơ sở dữ liệu. Với mỗi cơ sở dữ liệu, chúng ta ghi log ngay trước khi mở nó. Chúng ta cũng ghi log khi khởi tạo thành công (hoặc lỗi), rồi tiếp tục ghi log các cơ sở dữ liệu hiện có.

// Tạo cơ sở dữ liệu có tên toDoList với phiên bản mặc định (1)
const dbName1 = "toDoList";
log(`Đang mở: ${dbName1}`);
let DBOpenRequest = window.indexedDB.open(dbName1);

DBOpenRequest.addEventListener("error", (event) => {
  log(`Lỗi khi mở: ${dbName1}`);
  getDb();
});

DBOpenRequest.addEventListener("success", (event) => {
  log(`Đã khởi tạo: ${dbName1}`);
  getDb();
});

// Tạo cơ sở dữ liệu "AnotherDb"
const dbName2 = "AnotherDb";
log(`Đang mở ${dbName2}`);
DBOpenRequest = window.indexedDB.open(dbName2, 2);

DBOpenRequest.addEventListener("error", (event) => {
  log(`Lỗi khi mở: ${dbName2}`);
  getDb();
});

DBOpenRequest.addEventListener("success", (event) => {
  log(`Đã khởi tạo: ${dbName2}`);
  getDb();
});

Kết quả

Kết quả được hiển thị bên dưới. Lưu ý rằng thời gian cần để lấy danh sách cơ sở dữ liệu và thứ tự của chúng là không xác định.

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).