Skip to content

Repository files navigation

quick-logtime

npm versionnpm downloadsMIT license

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:

typeOptions={format?: "time"|"iso"|((date: Date)=>string)color?: booleandelta?: booleanprefix?: 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

About

Tiny utility that adds automatic timestamps to `console.*` output.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages