CKTIS / JavaScript
IDBKeyRange — диапазони от ключове в IndexedDB
IDBKeyRange описва диапазон от ключове за заявки към IndexedDB. Методът only избира един ключ, а bound задава интервал, чиито крайни точки могат по избор да бъдат изключени.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)IDBKeyRange описва ключове, а не стойности на записи. Подайте го на openCursor() на хранилище за обекти или индекс; при индекс диапазонът се отнася за ключовете на индекса. Създавайте диапазони със статични методи, а не с new IDBKeyRange().
IDBKeyRange.only(value) обхваща точно един ключ. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) създава интервал: по подразбиране и двата флага са false, така че крайните точки се включват; true изключва съответната крайна точка. includes(key) проверява дали ключът принадлежи на диапазона, без да отваря база данни.
Невалиден ключ, например NaN, причинява DataError. Същото важи за обърнати граници или равни граници, когато някоя крайна точка е изключена. Прилага се подреждането на ключовете в IndexedDB, а не сравнение на текстовите им представяния.
Това е уеб API, а не функция на ECMAScript; спецификацията го предоставя в Window и Worker. Наличието на Node 24 не доказва поддръжка. Проверете наличността в целевия браузър; източниците не представляват актуална таблица за съвместимост.
Примери
const exact = IDBKeyRange.only(20);
const interval = IDBKeyRange.bound(10, 30, false, true);
const keys = [5, 10, 20, 30, 40];
console.log(JSON.stringify(keys.filter(key => exact.includes(key))));
console.log(JSON.stringify(keys.filter(key => interval.includes(key))));Резултат
[20] [10,20]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.