KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

IDBKeyRange — IndexedDB-sleutelbereiken

IDBKeyRange beschrijft een bereik van sleutels voor IndexedDB-query's. De methode only selecteert één sleutel, terwijl bound een interval bepaalt waarvan de eindpunten eventueel kunnen worden uitgesloten.

Versie: 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 beschrijft sleutels, geen recordwaarden. Geef het door aan openCursor() van een object store of index; bij een index geldt het bereik voor indexsleutels. Maak bereiken met statische methoden, niet met new IDBKeyRange().

IDBKeyRange.only(value) omvat precies één sleutel. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) maakt een interval: beide vlaggen zijn standaard false, waardoor de eindpunten zijn inbegrepen; true sluit het betreffende eindpunt uit. includes(key) controleert of een sleutel binnen het bereik valt zonder een database te openen.

Een ongeldige sleutel, zoals NaN, veroorzaakt een DataError. Dat geldt ook voor omgekeerde grenzen of gelijke grenzen wanneer een van de eindpunten is uitgesloten. De volgorde van IndexedDB-sleutels is van toepassing, niet een vergelijking van de tekstuele weergaven ervan.

Dit is een Web API, geen ECMAScript-functie; volgens de specificatie is deze beschikbaar in Window en Worker. De aanwezigheid van Node 24 bewijst niet dat de API wordt ondersteund. Controleer de beschikbaarheid in de doelbrowser; de bronnen vormen geen actuele compatibiliteitstabel.

Voorbeelden

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

Resultaat

[20]
[10,20]

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen