CKTIS / JavaScript
IDBKeyRange — intervalli di chiavi IndexedDB
IDBKeyRange descrive un intervallo di chiavi per le query IndexedDB. Il metodo only seleziona una sola chiave, mentre bound definisce un intervallo i cui estremi possono essere esclusi facoltativamente.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)IDBKeyRange descrive chiavi, non valori dei record. Passalo a openCursor() di un object store o di un indice; nel caso di un indice, l’intervallo si applica alle chiavi dell’indice. Crea gli intervalli con metodi statici, non con new IDBKeyRange().
IDBKeyRange.only(value) comprende esattamente una chiave. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) crea un intervallo: entrambi i flag hanno valore predefinito false, quindi gli estremi sono inclusi; true esclude l’estremo corrispondente. includes(key) verifica l’appartenenza senza aprire un database.
Una chiave non valida, come NaN, causa un DataError. Lo stesso vale per limiti invertiti o uguali quando uno degli estremi è escluso. Si applica l’ordinamento delle chiavi IndexedDB, non il confronto delle loro rappresentazioni testuali.
Questa è una Web API, non una funzionalità ECMAScript; la specifica la rende disponibile in Window e Worker. La presenza di Node 24 non dimostra che sia supportata. Verifica la disponibilità nel browser di destinazione; le fonti non costituiscono una tabella di compatibilità aggiornata.
Esempi
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))));Risultato
[20] [10,20]
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.