dumpkit

Debugging sem dependências para Node.js

Inspirado no dump() e dd() do PHP/Laravel

ComeçarGitHub

Porquê dumpkit?

Já perdeu minutos a tentar entender uma estrutura de dados complexa com console.log()?

// O que console.log mostra
console.log(usuario);
// { nome: 'João', endereco: [Object], permissoes: [Object], metadata: [Object] }
// Você não vê o que está dentro! 😫

Com dumpkit:

import { dump } from 'dumpkit';

dump(usuario);

Saída completa e legível:

{
  nome: "João",
  endereco: {
    rua: "Rua Augusta",
    cidade: "Lisboa",
    codigoPostal: "1100-053"
  },
  permissoes: ["ler", "escrever", "admin"],
  metadata: Map(2) {
    "criado" => Date(2024-01-15T10:30:00.000Z),
    "ultimoAcesso" => Date(2024-12-20T15:45:00.000Z)
  }
}

Debug que para a execução

Precisa parar o código num ponto específico para inspecionar?

import { dd } from 'dumpkit';

function processarPedido(pedido) {
  // Validação falhou? Para tudo e mostra
  if (!pedido.valido) {
    dd({ erro: 'Pedido inválido', pedido });
  }
  
  // Se chegou aqui, pedido é válido
  return processar(pedido);
}

dd() = dump and die - mostra o valor e termina o processo imediatamente.

Características

API Simples

dump(), dd(), trace(), measure()

Zero Dependências

Sem baggage de npm

Output Bonito

Formatação colorida e legível

Seguro para Circulares

Sem crash em referências circulares

TypeScript

Tipos completos incluídos

Zero Config

Funciona imediatamente

Instalação

yarn add dumpkit

ou

npm install dumpkit