Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

IDBKeyRange — plages de clés IndexedDB

IDBKeyRange décrit une plage de clés pour les requêtes IndexedDB. La méthode only sélectionne une seule clé, tandis que bound définit un intervalle dont les extrémités peuvent être exclues si nécessaire.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)

IDBKeyRange décrit des clés, et non des valeurs d’enregistrement. Passez-le à openCursor() d’un magasin d’objets ou d’un index ; pour un index, la plage s’applique aux clés de l’index. Créez les plages avec des méthodes statiques, et non avec new IDBKeyRange().

IDBKeyRange.only(value) couvre exactement une clé. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) crée un intervalle : les deux indicateurs valent false par défaut, ce qui inclut les extrémités ; true exclut l’extrémité correspondante. includes(key) vérifie l’appartenance sans ouvrir de base de données.

Une clé invalide, comme NaN, provoque une DataError. Il en va de même pour des bornes inversées ou des bornes égales lorsque l’une des extrémités est exclue. C’est l’ordre des clés IndexedDB qui s’applique, et non la comparaison de leurs représentations textuelles.

Il s’agit d’une API Web, et non d’une fonctionnalité ECMAScript ; la spécification la rend disponible dans Window et Worker. La présence de Node 24 ne prouve pas sa prise en charge. Vérifiez sa disponibilité dans le navigateur cible ; les sources ne constituent pas un tableau de compatibilité à jour.

Exemples

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))));

Résultat

[20]
[10,20]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources