Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje