CKTIS / JavaScript
IDBKeyRange — zakres kluczy IndexedDB
IDBKeyRange opisuje zakres kluczy dla zapytań IndexedDB. Metoda only wybiera jeden klucz, a bound wyznacza przedział z opcjonalnym wyłączeniem jego końców.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)IDBKeyRange opisuje klucze, nie wartości rekordów. Można przekazać go do openCursor() magazynu lub indeksu; dla indeksu zakres dotyczy kluczy indeksu. Zakres tworzy się metodami statycznymi, nie przez new IDBKeyRange().
IDBKeyRange.only(value) obejmuje dokładnie jeden klucz. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) tworzy przedział: obie flagi domyślnie mają wartość false, czyli włączają końce; true wyłącza odpowiedni koniec. includes(key) sprawdza przynależność bez otwierania bazy.
Nieprawidłowy klucz, np. NaN, powoduje DataError. Tak samo działa odwrócenie granic lub ich zrównanie przy wyłączeniu któregoś końca. Obowiązuje porządek kluczy IndexedDB, nie porównywanie tekstowych reprezentacji.
To Web API, nie funkcja ECMAScript; specyfikacja udostępnia je w Window i Worker. Obecność Node 24 nie dowodzi obsługi. Sprawdź dostępność w docelowej przeglądarce; źródła nie stanowią aktualnej tabeli zgodności.
Przykłady
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))));Wynik
[20] [10,20]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.