Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes