CKTIS / JavaScript
IDBKeyRange — rasponi ključeva IndexedDB
IDBKeyRange opisuje raspon ključeva za upite IndexedDB. Metoda only odabire jedan ključ, dok bound određuje interval čije se krajnje točke po želji mogu isključiti.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)IDBKeyRange opisuje ključeve, a ne vrijednosti zapisa. Proslijedite ga metodi openCursor() spremišta objekata ili indeksa; kod indeksa raspon se odnosi na ključeve indeksa. Raspone stvarajte statičkim metodama, a ne pomoću new IDBKeyRange().
IDBKeyRange.only(value) obuhvaća točno jedan ključ. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) stvara interval: obje zastavice prema zadanim postavkama imaju vrijednost false, pa su krajnje točke uključene; vrijednost true isključuje odgovarajuću krajnju točku. includes(key) provjerava pripadnost bez otvaranja baze podataka.
Nevažeći ključ, primjerice NaN, uzrokuje DataError. Isto vrijedi za obrnute granice ili jednake granice ako je jedna od krajnjih točaka isključena. Primjenjuje se redoslijed ključeva IndexedDB, a ne usporedba njihovih tekstualnih prikaza.
Ovo je Web API, a ne značajka ECMAScripta; specifikacija ga izlaže u Window i Worker. Sama prisutnost Nodea 24 ne dokazuje podršku. Provjerite dostupnost u ciljnom pregledniku; izvori nisu aktualna tablica kompatibilnosti.
Primjeri
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))));Rezultat
[20] [10,20]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.