} Skip to content

JSON Driver

O JSON Driver armazena dados em arquivos JSON, ideal para desenvolvimento e aplicações pequenas que precisam de persistência legível.

const { HelperDB } = require('helper.db');
const db = new HelperDB({
driver: 'json',
filePath: './data.json',
autoSave: true,
indent: 2
});
await db.init();
  • Tipo: string
  • Padrão: './db.json'
  • Descrição: Caminho para o arquivo JSON
  • Tipo: boolean
  • Padrão: true
  • Descrição: Salva automaticamente após cada operação
  • Tipo: number
  • Padrão: 2
  • Descrição: Indentação do JSON para melhor legibilidade
  • 📖 Legível: Dados em formato JSON legível
  • 🔧 Simples: Fácil de configurar e usar
  • 📝 Editável: Pode ser editado manualmente
  • 🚀 Rápido: Operações em memória
  • 📏 Tamanho: Não recomendado para grandes volumes
  • 🔒 Concorrência: Não suporta múltiplos processos
  • 💾 Memória: Carrega tudo na memória
// Configuração básica
const db = new HelperDB({
driver: 'json',
filePath: './users.json',
autoSave: true,
indent: 2
});
await db.init();
// Operações básicas
await db.set('user:1', {
name: 'João',
email: 'joao@email.com'
});
const user = await db.get('user:1');
console.log(user); // { name: 'João', email: 'joao@email.com' }
// O arquivo users.json será criado automaticamente:
// {
// "user:1": {
// "name": "João",
// "email": "joao@email.com"
// }
// }
  • Leitura: Muito rápida (dados em memória)
  • Escrita: Rápida para pequenos volumes
  • Recomendado para: < 10MB de dados