} Skip to content

get()


title: get description: Recupera um valor do banco de dados usando uma chave

Section titled “title: get description: Recupera um valor do banco de dados usando uma chave”

Obtém um valor da base de dados.

const value = await db.get(key)
  • key (string): A chave do valor a ser obtido
  • Promise<any>: O valor armazenado ou null se não existir
const { HelperDB } = require('helper.db');
const db = new HelperDB();
// Salvar dados
await db.set('usuario', { nome: 'João', idade: 25 });
// Obter dados
const usuario = await db.get('usuario');
console.log(usuario); // { nome: 'João', idade: 25 }
// Valor inexistente
const inexistente = await db.get('nao_existe');
console.log(inexistente); // null
await db.set('usuario', {
nome: 'João',
configuracoes: {
tema: 'escuro',
idioma: 'pt-BR'
},
hobbies: ['programação', 'leitura']
});
// Obter propriedades específicas
const nome = await db.get('usuario.nome');
console.log(nome); // 'João'
const tema = await db.get('usuario.configuracoes.tema');
console.log(tema); // 'escuro'
const primeiroHobby = await db.get('usuario.hobbies.0');
console.log(primeiroHobby); // 'programação'
// Usando operador OR para valor padrão
const config = await db.get('configuracoes') || {
tema: 'claro',
idioma: 'pt-BR'
};
// Função auxiliar para valor padrão
function getWithDefault(key, defaultValue) {
return db.get(key).then(value => value !== null ? value : defaultValue);
}
const pontos = await getWithDefault('usuario.pontos', 0);
interface Usuario {
nome: string;
idade: number;
ativo: boolean;
}
// Especificar tipo de retorno
const usuario = await db.get<Usuario>('usuario');
// usuario: Usuario | null
// Com verificação de tipo
if (usuario) {
console.log(usuario.nome); // TypeScript sabe que é string
}
await db.set('dados', {
a: { b: { c: 'valor' } }
});
// Todos retornam o mesmo resultado
const valor1 = await db.get('dados.a.b.c');
const valor2 = await db.get('dados').then(d => d.a.b.c);
console.log(valor1 === valor2); // true
await db.set('lista', [1, 2, 3, 4, 5]);
const lista = await db.get('lista'); // [1, 2, 3, 4, 5]
const item = await db.get('lista.2'); // 3
const slice = await db.get('lista').then(l => l.slice(1, 3)); // [2, 3]
// ✅ Eficiente - acesso direto
const valor = await db.get('chave.propriedade');
// ❌ Menos eficiente - múltiplas consultas
const objeto = await db.get('chave');
const valor = objeto.propriedade;
db.on('beforeGet', (data) => {
console.log('Buscando dados:', data.key);
});
db.on('get', (data) => {
console.log('Dados obtidos:', data.key, data.value);
});
  • set - Definir valores
  • has - Verificar existência
  • all - Obter todos os dados