Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła