Console

Appearance

What is Console? ​

Console is a structured, namespaced logging library for JavaScript and TypeScript that works in both browser and Node.js environments. It delivers structured output quality with great developer experience — beautiful terminal formatting, browser DevTools styling, and a clean API.

  • Structured logging with a consistent JSON schema
  • Namespaced logging for organized, component-specific logs
  • Child loggers that inherit config and attach request-scoped context
  • Beautiful terminal output with ANSI colors and human-readable formatting
  • Field redaction — mask sensitive data before it reaches any destination
  • Multiple transports — HTTP, file, stream, or console
  • Memory-efficient storage with circular buffers
  • Worker support for background processing (Web Worker in browsers, worker_threads in Node.js)
  • Node.js and browser — works in both without any configuration

Why Console? ​

Traditional console.log statements have several limitations:

  1. No organization — Logs from different parts of your app mix together
  2. No levels — No trace/debug/info/warn/error/fatal distinction
  3. No structure — Can't easily parse logs or send them to aggregators
  4. No context — No way to attach request IDs or user context automatically
  5. No history — Once a log scrolls off screen, it's gone
  6. No backend — You can't send logs to a server for analysis

Console solves all of these while remaining lightweight and dependency-free.

Comparison ​

Featureconsole.logConsole
Namespacing❌✅
Child loggers❌✅
Numeric log levels❌✅
Structured JSON output❌✅
Pretty terminal output❌✅ built-in
Configurable timestamps❌✅ (ISO, epoch, custom, nanosecond)
Field redaction❌✅ (dot-notation paths, inherited by children)
Browser DevTools styling❌✅
Log storage / history❌✅
Multiple transports❌✅
File transport❌✅
Worker transport❌✅ (non-blocking logging in browser and Node.js)
Type safety❌✅
Zero dependencies✅✅
Browser + Node.js✅ (basic)✅ (structured, with DevTools tooling)
Bundle (gzip)0 KB~10 KB (vs Pino ~32 KB, Winston ~70 KB)

Philosophy ​

  • Zero dependencies — No bloat, no supply chain risk
  • TypeScript first — Full type safety out of the box
  • DX over config — Works beautifully out of the box; sensible defaults for every environment
  • Production-ready — Structured output for log aggregators; debug tooling for production incidents

Guides ​