CKTIS / JavaScript
IDBKeyRange — intervalos de chaves IndexedDB
IDBKeyRange descreve um intervalo de chaves para consultas IndexedDB. O método only seleciona uma única chave, enquanto bound define um intervalo cujos extremos podem ser excluídos opcionalmente.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
IDBKeyRange.only(value)
IDBKeyRange.bound(lower, upper)
IDBKeyRange.bound(lower, upper, lowerOpen)
IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen)
range.includes(key)IDBKeyRange descreve chaves, não valores de registos. Passe-o a openCursor() de um armazém de objetos ou de um índice; no caso de um índice, o intervalo aplica-se às chaves do índice. Crie intervalos com métodos estáticos, não com new IDBKeyRange().
IDBKeyRange.only(value) abrange exatamente uma chave. IDBKeyRange.bound(lower, upper, lowerOpen, upperOpen) cria um intervalo: ambos os indicadores têm o valor predefinido false, pelo que os extremos são incluídos; true exclui o extremo correspondente. includes(key) verifica se uma chave pertence ao intervalo sem abrir uma base de dados.
Uma chave inválida, como NaN, provoca um DataError. O mesmo acontece com limites invertidos ou iguais quando um dos extremos é excluído. Aplica-se a ordenação das chaves IndexedDB, não a comparação das respetivas representações textuais.
Esta é uma API Web, não uma funcionalidade ECMAScript; a especificação disponibiliza-a em Window e Worker. A presença do Node 24 não comprova a sua compatibilidade. Verifique a disponibilidade no navegador de destino; as fontes não constituem uma tabela de compatibilidade atualizada.
Exemplos
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]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.