CKTIS / JavaScript
IDBKeyRange — IndexedDB-Schlüsselbereiche
IDBKeyRange beschreibt Schlüsselbereiche für IndexedDB-Abfragen. Die Methode only wählt einen einzelnen Schlüssel aus, während bound ein Intervall festlegt, dessen Grenzen optional ausgeschlossen werden können.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)IDBKeyRange beschreibt Schlüssel, nicht Datensatzwerte. Übergeben Sie es an openCursor() eines Objektspeichers oder Indexes; bei einem Index bezieht sich der Bereich auf die Indexschlüssel. Erstellen Sie Bereiche mit statischen Methoden, nicht mit new IDBKeyRange().
IDBKeyRange.only(value) umfasst genau einen Schlüssel. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) erstellt ein Intervall: Beide Flags haben standardmäßig den Wert false, sodass die Grenzen eingeschlossen sind; true schließt die jeweilige Grenze aus. includes(key) prüft die Zugehörigkeit, ohne eine Datenbank zu öffnen.
Ein ungültiger Schlüssel, etwa NaN, verursacht einen DataError. Das gilt ebenso für umgekehrte Grenzen oder gleiche Grenzen, wenn eine der Grenzen ausgeschlossen ist. Maßgeblich ist die Sortierung von IndexedDB-Schlüsseln, nicht der Vergleich ihrer Textdarstellungen.
Dies ist eine Web-API und kein ECMAScript-Feature; die Spezifikation stellt sie in Window und Worker bereit. Dass Node 24 vorhanden ist, belegt keine Unterstützung. Prüfen Sie die Verfügbarkeit im Zielbrowser; die Quellen sind keine aktuelle Kompatibilitätstabelle.
Beispiele
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))));Ergebnis
[20] [10,20]
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.