Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri