IDBIndex: свойство name

Свойство name интерфейса IDBIndex содержит строку, которая задаёт имя индекса.

Строка, определяющая имя индекса.

Возникает несколько исключений при попытке изменить имя индекса.

InvalidStateError DOMException

Выбрасывается, если индекс или его хранилище объектов было удалено или текущая транзакция не является транзакцией обновления. Переименовать индексы можно только во время транзакций обновления, то есть когда режим равен "versionchange".

TransactionInactiveError DOMException

Выбрасывается, если текущая транзакция не активна.

ConstraintError DOMException

Выбрасывается, если индекс уже использует указанное name.

В следующем примере мы открываем транзакцию и хранилище объектов, затем получаем индекс lName из простой базы данных контактов. Затем мы открываем базовый курсор на индексе, используя IDBIndex.openCursor() — это работает так же, как открытие курсора непосредственно на IDBObjectStore с помощью openCursor(), за исключением того, что возвращаемые записи сортируются на основе индекса, а не первичного ключа.

Имя индекса записывается в консоль: оно должно быть возвращено как lName.

Наконец, мы перебираем каждую запись, вставляя данные в таблицу HTML. Для полного рабочего примера обратитесь к нашему демонстрационному репозиторию IndexedDB-examples (посмотреть пример онлайн).

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

  const myIndex = objectStore.index("lName");
  console.log(myIndex.name);

  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("Entries all displayed.");
    }
  };
}

• Использование IndexedDB
• Начальные транзакции: IDBDatabase
• Использование транзакций: IDBTransaction
• Указание диапазона ключей: IDBKeyRange
• Получение и изменение данных: IDBObjectStore
• Использование курсоров: IDBCursor
• Пример ссылки: Заметки о задачах (посмотреть пример онлайн).