IDBFactory: метод cmp()

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

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

Примечание: Эта функция доступна в Потоках выполнения JavaScript.

Метод cmp() интерфейса IDBFactory сравнивает два значения в качестве ключей, чтобы определить равенство и порядок для операций IndexedDB, таких как хранение и итерация.

Примечание: Не используйте этот метод для сравнения произвольных значений JavaScript, потому что многие значения JavaScript не являются допустимыми ключами IndexedDB (например, булевы значения и объекты) или обрабатываются как эквивалентные ключи IndexedDB (например, IndexedDB игнорирует массивы с нечисловыми свойствами и обрабатывает их как пустые массивы, поэтому любые нечисловые массивы считаются эквивалентными). Это вызывает исключение, если одно из значений не является допустимым ключом.

Синтаксис

cmp(first, second)

Параметры

first: Первый ключ для сравнения.
second: Второй ключ для сравнения.

Возвращаемое значение

Целое число, указывающее результат сравнения; в таблице ниже перечислены возможные значения и их значения:

Возвращаемое значение	Описание
-1	Первый ключ меньше второго ключа
0	Первый ключ равен второму ключу
1	Первый ключ больше второго ключа

Исключения

DataError DOMException: Выбрасывается, если один из предоставленных ключей не является допустимым ключом.

Примеры

const a = 1;
const b = 2;
const result = window.indexedDB.cmp(a, b);
console.log(`Comparison results: ${result}`);

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

Спецификация
Indexed Database API 3.0 # ref-for-dom-idbfactory-cmp①

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`cmp`	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/IDBFactory/cmp