Spec-Zone.ru › Web APIs

IDBIndex: свойство unique

Базовая Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2021 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Web Workers.

Свойство unique только для чтения возвращает булево значение, указывающее, разрешает ли индекс дублирование ключей.

Это определяется при создании индекса с помощью метода IDBObjectStore.createIndex. Этот метод принимает необязательный параметр unique, который, если установлен в true, означает, что индекс не сможет принимать дублированные записи.

Значение

Булевое значение:

Значение Эффект
true Текущий индекс не допускает дублирования значений ключа.
false Текущий индекс допускает дублирование значений ключа.

Примеры

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

Статус уникальности индекса регистрируется в консоли: он должен быть возвращён как false.

Наконец, мы итерируем по каждой записи и вставляем данные в таблицу 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.unique);

  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.");
    }
  };
}

Спецификации

Спецификация
Indexed Database API 3.0
# dom-idbindex-unique

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet WebView Android
unique 23 12 10 15 8 25 22 14 8 1.5 4.4

См. также

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

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IDBIndex/unique

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API