quick-logtime

Tiny utility that adds automatic timestamps to console.* output.
Zero dependencies. Works in Node.js, Deno, Bun and browsers.

quick-logtime patches the global console so every log automatically includes a timestamp.

Perfect for:

• CLI tools
• scripts
• small services
• debugging
• quick instrumentation without a full logging framework

Highlights

• Zero dependencies
• Small and focused API
• Works with console.log, info, warn, error, debug
• TypeScript types included
• Optional: colored output, delta timing, custom prefix or formatter

Installation

# npm install quick-logtime
# or
npm install quick-logtime
# or
bun add quick-logtime

Deno users can import from the npm specifier or a CDN (e.g. esm.sh).

Quick usage

import { patchConsole } from "quick-logtime"

patchConsole()
console.log("hello world")

Output:

[14:21:03] hello world

Options

patchConsole accepts an optional Options object:

type Options = {
  format?: "time" | "iso" | ((date: Date) => string)
  color?: boolean
  delta?: boolean
  prefix?: string
}

• format: default is "time" (HH:mm:ss). Use "iso" for full ISO timestamps or pass a custom formatter (date) => string.
• color: add ANSI color per level (useful in terminals).
• delta: show delta since previous log (e.g. +12ms).
• prefix: optional short label to include inside the timestamp brackets.

Example with options

patchConsole({
  format: (d) => d.toISOString(),
  color: true,
  delta: true,
  prefix: "api"
})

console.info("server started")

Output (example):

[2026-03-06T10:04:01.214Z +12ms api] server started

API

patchConsole(options?: Options): void — patches the global console.

The package exports TypeScript types and compiles to dist/ (see package.json).

Development

Build and test locally:

npm install
npm run build   # tsc - emits JS + .d.ts into dist/
npm run test    # run unit tests (Vitest)

The project is ESM-friendly but ships compiled CommonJS by default; see package.json and tsconfig.json if you need ESM-only builds for Deno.

Publishing

Before publishing, check the package name availability on npm. The prepare script runs the build so npm publish will include the compiled dist/.

Compatibility

Works in Node, Bun, Deno and browsers — it only relies on console and Date.

License

MIT