IDBIndex

Thuộc tính thể hiện

IDBIndex.isAutoLocale Read only Non-standard Deprecated

Trả về một giá trị boolean cho biết index có giá trị locale là auto hay không khi được tạo (xem tham số options của IDBObjectStore.createIndex().)

IDBIndex.locale Read only Non-standard Deprecated

Trả về locale của index, ví dụ en-US hoặc pl, nếu locale đã được chỉ định khi tạo (xem tham số options của IDBObjectStore.createIndex().)

IDBIndex.name

Tên của index này.

IDBIndex.objectStore Read only

Tên của object store được index này tham chiếu.

IDBIndex.keyPath Read only

Đường dẫn khóa của index này. Nếu là null, index này sẽ không được tự động điền.

IDBIndex.multiEntry Read only

Ảnh hưởng đến cách index hoạt động khi kết quả đánh giá key path của index trả về một mảng. Nếu là true, sẽ có một bản ghi trong index cho mỗi phần tử của mảng khóa. Nếu là false, sẽ có một bản ghi cho mỗi khóa là một mảng.

IDBIndex.unique Read only

Nếu là true, index này không cho phép các giá trị trùng lặp cho một khóa.

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

Kế thừa từ: EventTarget

IDBIndex.count()

Trả về một đối tượng IDBRequest và, trong một luồng riêng biệt, trả về số lượng bản ghi trong một phạm vi khóa.

IDBIndex.get()

Trả về một đối tượng IDBRequest và, trong một luồng riêng biệt, tìm giá trị trong object store được tham chiếu tương ứng với khóa đã cho hoặc giá trị tương ứng đầu tiên, nếu key là một IDBKeyRange.

IDBIndex.getKey()

Trả về một đối tượng IDBRequest và, trong một luồng riêng biệt, tìm khóa đã cho hoặc khóa chính, nếu key là một IDBKeyRange.

IDBIndex.getAll()

Trả về một đối tượng IDBRequest và, trong một luồng riêng biệt, tìm tất cả giá trị khớp trong object store được tham chiếu tương ứng với khóa đã cho hoặc nằm trong phạm vi, nếu key là một IDBKeyRange.

IDBIndex.getAllKeys()

Trả về một đối tượng IDBRequest và, trong một luồng riêng biệt, tìm tất cả khóa khớp trong object store được tham chiếu tương ứng với khóa đã cho hoặc nằm trong phạm vi, nếu key là một IDBKeyRange.

IDBIndex.getAllRecords() Experimental

Trả về một đối tượng IDBRequest và, trong một luồng riêng biệt, tìm tất cả bản ghi khớp trong object store được tham chiếu (bao gồm khóa index, khóa chính và giá trị) tương ứng với khóa đã cho hoặc nằm trong phạm vi, nếu key là một IDBKeyRange.

IDBIndex.openCursor()

Trả về một đối tượng IDBRequest và, trong một luồng riêng biệt, tạo một cursor trên phạm vi khóa đã chỉ định.

IDBIndex.openKeyCursor()

Trả về một đối tượng IDBRequest và, trong một luồng riêng biệt, tạo một cursor trên phạm vi khóa đã chỉ định, được sắp xếp theo index này.

Ví dụ

Trong ví dụ sau, chúng ta mở một transaction và một object store, rồi lấy index lName từ một cơ sở dữ liệu liên hệ đơn giản. Sau đó, chúng ta mở một cursor cơ bản trên index bằng IDBIndex.openCursor - thao tác này hoạt động giống như mở cursor trực tiếp trên một ObjectStore bằng IDBObjectStore.openCursor, ngoại trừ việc các bản ghi được trả về được sắp xếp theo index, không phải theo khóa chính.

Cuối cùng, chúng ta lặp qua từng bản ghi và chèn dữ liệu vào một bảng HTML. Để xem ví dụ hoàn chỉnh đang chạy, hãy xem kho demo IndexedDB-examples của chúng tôi (Xem ví dụ trực tiếp).

function displayDataByIndex() {
  tableEntry.textContent = "";
  const transaction = db.transaction(["contactsList"], "readonly");
  const objectStore = transaction.objectStore("contactsList");

  const myIndex = objectStore.index("lName");
  myIndex.openCursor().onsuccess = (event) => {
    const cursor = event.target.result;
    if (cursor) {
      const tableRow = document.createElement("tr");
      for (const cell of [
        cursor.value.id,
        cursor.value.lName,
        cursor.value.fName,
        cursor.value.jTitle,
        cursor.value.company,
        cursor.value.eMail,
        cursor.value.phone,
        cursor.value.age,
      ]) {
        const tableCell = document.createElement("td");
        tableCell.textContent = cell;
        tableRow.appendChild(tableCell);
      }
      tableEntry.appendChild(tableRow);

      cursor.continue();
    } else {
      console.log("Tất cả các mục đã được hiển thị.");
    }
  };
}

Thông số kỹ thuật

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

Xem thêm

• Sử dụng 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 cursor: IDBCursor
• Ví dụ tham khảo: To-do Notifications (Xem ví dụ trực tiếp).