CKTIS / JavaScript
IDBKeyRange — rangos de claves de IndexedDB
IDBKeyRange describe un rango de claves para las consultas de IndexedDB. El método only selecciona una clave, mientras que bound define un intervalo cuyos extremos se pueden excluir opcionalmente.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)IDBKeyRange describe claves, no valores de registros. Pásalo a openCursor() de un almacén de objetos o de un índice; en el caso de un índice, el rango se aplica a las claves del índice. Crea los rangos con métodos estáticos, no con new IDBKeyRange().
IDBKeyRange.only(value) abarca exactamente una clave. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) crea un intervalo: ambos indicadores tienen el valor predeterminado false, por lo que se incluyen los extremos; true excluye el extremo correspondiente. includes(key) comprueba si una clave pertenece al rango sin abrir una base de datos.
Una clave no válida, como NaN, provoca un DataError. Lo mismo ocurre si los límites están invertidos o son iguales y se excluye alguno de los extremos. Se aplica el orden de las claves de IndexedDB, no la comparación de sus representaciones textuales.
Es una API web, no una característica de ECMAScript; la especificación la expone en Window y Worker. La presencia de Node 24 no demuestra que sea compatible. Comprueba si está disponible en el navegador de destino; las fuentes no son una tabla de compatibilidad actualizada.
Ejemplos
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))));Resultado
[20] [10,20]
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.