Skip to content

API Reference

Detailed documentation for all Console exports.

Exports

typescript
import {
  // Main class
  Konsole,

  // Transport classes
  HttpTransport,
  ConsoleTransport,
  FileTransport,
  StreamTransport,

  // Formatter utilities
  resolveTimestampConfig,
  formatTimestamp,

  // Redaction utilities
  compileRedactPaths,
  applyRedaction,
  REDACTED,

  // Types
  LogEntry,
  Transport,          // interface
  TransportConfig,
  KonsoleOptions,
  KonsoleChildOptions,
  KonsolePublic,
  TimestampFormat,
  TimestampOptions,
  Criteria,
  FileFormat,
} from 'konsole-logger';

// Default export
import Konsole from 'konsole-logger';

Quick Reference

Static Methods

MethodReturnsDescription
Konsole.getLogger(namespace?)KonsoleGet or create a logger by namespace
Konsole.getNamespaces()string[]List all registered namespaces
Konsole.exposeToWindow()voidExpose debug handle to window.__Konsole
Konsole.enableGlobalPrint(enabled)voidOverride output for all loggers
Konsole.addGlobalTransport(config)voidAdd transport to every logger
Konsole.shutdown()Promise<void>Flush and destroy all registered loggers
Konsole.enableShutdownHook()voidRegister SIGTERM/SIGINT/beforeExit handlers

Instance Methods

MethodReturnsDescription
trace(...args)voidLevel 10 — verbose tracing
debug(...args)voidLevel 20 — developer detail
info(...args)voidLevel 30 — general messages
log(...args)voidAlias for info()
warn(...args)voidLevel 40 — unexpected but recoverable
error(...args)voidLevel 50 — operation failed (stderr)
fatal(...args)voidLevel 60 — unrecoverable failure (stderr)
child(bindings, options?)KonsoleCreate a child logger with bound fields
setLevel(level)voidChange minimum log level at runtime
setTimestamp(format)voidChange timestamp format at runtime
setCriteria(criteria)voidChange output filter at runtime (deprecated)
addTransport(transport)voidAdd a transport to this logger
flushTransports()Promise<void>Force-flush all transport batches
getLogs()ReadonlyArray<LogEntry>Get all stored entries
getLogsAsync()Promise<ReadonlyArray<LogEntry>>Get entries (worker-aware)
clearLogs()voidEmpty the circular buffer
viewLogs(batchSize?)voidPrint entries via console.table
resetBatch()voidReset viewLogs() pagination cursor
getStats()objectMemory usage stats
destroy()Promise<void>Flush, stop timers, deregister

Pages