CKTIS / JavaScript
IDBKeyRange — obsegi ključev IndexedDB
IDBKeyRange opisuje obseg ključev za poizvedbe IndexedDB. Metoda only izbere en ključ, medtem ko bound določi interval, katerega končni točki je mogoče po želji izključiti.
Različica: 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če, ne vrednosti zapisov. Posredujte ga metodi openCursor() shrambe objektov ali indeksa; pri indeksu se obseg nanaša na ključe indeksa. Obsege ustvarite s statičnimi metodami, ne z new IDBKeyRange().
IDBKeyRange.only(value) zajema natanko en ključ. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) ustvari interval: obe zastavici imata privzeto vrednost false, zato sta končni točki vključeni; vrednost true izključi ustrezno končno točko. includes(key) preveri pripadnost, ne da bi odprl zbirko podatkov.
Neveljaven ključ, kot je NaN, povzroči DataError. Enako velja za obrnjeni meji ali enaki meji, če je katera od končnih točk izključena. Uporablja se vrstni red ključev IndexedDB, ne primerjava njihovih besedilnih zapisov.
To je spletni API, ne funkcija ECMAScript; specifikacija ga omogoča v Window in Worker. Prisotnost Node 24 ne dokazuje podpore. Preverite razpoložljivost v ciljnem brskalniku; viri niso aktualna tabela združljivosti.
Primeri
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]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.