Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori