Logging Sucks

Requires Node.js 20.10+, 22.0+, 24.0+, or above.

Inspired by https://loggingsucks.com/.

Example

import { log, captureLogs, logItems } from "loggingsucks/json"
import { writeFileSync } from "fs"

// Capture the time and any other important information given to the program
log(`start`, { date: new Date().toISOString(), args: process.argv })
// You can log whatever you want here as long its JSON-compatible, for example
// environment variables.

function doThing(someArg) {
	// Takes a name and an immediately invoked callback
	captureLogs(`doThings()`, ({ log }) => {
		// When looking through logs, it can be useful to know function args
		log({ someArg })
		// The `log()` function provided by `captureLogs()` doesn't need a name

		// ...
	})
}

// Write the log items to a JSON file
writeFileSync(`log.json`, JSON.stringify(logItems, undefined, "\t"))
// You can report the logs in any way you want, for example you could use
// `process.on("beforeExit")` and send an email

---

This package is available on JSR and NPM.