CKTIS / JavaScript
IDBKeyRange — rozsahy klíčů IndexedDB
IDBKeyRange popisuje rozsah klíčů pro dotazy IndexedDB. Metoda only vybere jeden klíč, zatímco bound určuje interval, jehož koncové body lze volitelně vyloučit.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)IDBKeyRange popisuje klíče, nikoli hodnoty záznamů. Předejte jej metodě openCursor() úložiště objektů nebo indexu; u indexu se rozsah vztahuje na klíče indexu. Rozsahy vytvářejte statickými metodami, ne pomocí new IDBKeyRange().
IDBKeyRange.only(value) zahrnuje přesně jeden klíč. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) vytvoří interval: oba příznaky mají ve výchozím nastavení hodnotu false, takže koncové body zahrnují; hodnota true příslušný koncový bod vyloučí. includes(key) ověří příslušnost, aniž by otevřela databázi.
Neplatný klíč, například NaN, způsobí DataError. Totéž platí pro obrácené hranice nebo stejné hranice, pokud je některý koncový bod vyloučen. Používá se řazení klíčů IndexedDB, nikoli porovnávání jejich textových podob.
Jde o Web API, nikoli o funkci ECMAScript; specifikace je zpřístupňuje v Window a Worker. Přítomnost Node 24 nedokazuje podporu. Ověřte dostupnost v cílovém prohlížeči; zdroje nepředstavují aktuální tabulku kompatibility.
Příklady
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))));Výsledek
[20] [10,20]
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.