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