Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

IDBKeyRange — rozsahy kľúčov IndexedDB

IDBKeyRange opisuje rozsah kľúčov pre dopyty IndexedDB. Metóda only vyberie jeden kľúč, zatiaľ čo bound určuje interval, ktorého koncové body možno voliteľne vylúčiť.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)

IDBKeyRange opisuje kľúče, nie hodnoty záznamov. Odovzdajte ho metóde openCursor() úložiska objektov alebo indexu; pri indexe sa rozsah vzťahuje na kľúče indexu. Rozsahy vytvárajte statickými metódami, nie pomocou new IDBKeyRange().

IDBKeyRange.only(value) zahŕňa presne jeden kľúč. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) vytvorí interval: oba príznaky majú predvolene hodnotu false, takže koncové body sú zahrnuté; hodnota true príslušný koncový bod vylúči. includes(key) overí príslušnosť bez otvorenia databázy.

Neplatný kľúč, napríklad NaN, spôsobí DataError. To isté platí pre obrátené hranice alebo rovnaké hranice, ak je niektorý koncový bod vylúčený. Uplatňuje sa poradie kľúčov IndexedDB, nie porovnávanie ich textových podôb.

Ide o Web API, nie o funkciu ECMAScript; špecifikácia ho sprístupňuje v Window a Worker. Prítomnosť Node 24 nedokazuje podporu. Overte dostupnosť v cieľovom prehliadači; zdroje nepredstavujú aktuálnu tabuľku kompatibility.

Prí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ýsledok

[20]
[10,20]

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje