Perj NPM | npm.io

perj

A fast, flexible JSON logger.

Installing

Node.js

The package.json has two configurations related to Node.js installations:

main: points to the minified version compiled for v6.0.0 and above.
module: points to the src files. Module field details.

The index.js points to the minified version compiled for v6.0.0 and above.

npm install --save perj

Browser

Use the dist files or bundle from src.

Type	Size	CDN
gzipped		https://unpkg.com/perj/dist/perj.min.js.gz
minified		https://unpkg.com/perj/dist/perj.min.js
full (source map)		https://unpkg.com/perj/dist/perj.js

See Unpkg for fixed version options.

Goals

Designed to be integrated (DIY) ✔️
Cross platform (Node.js and Browser) ✔️
Flexible log and additional property options ✔️
Fast ✔️

Features

No dependencies.
Flexible API (change almost everything).
Flexible log methods:
- Log items can be any number in any order of any type.
The first string is nested under the 'msg' key:
- First string includes a string argument or an Error message.
- Additional string arguments are nested under the data key.
Objects are nested under the 'data' key as an object or array of objects.
Repeated string top level properties become hierarchical.
Examples to get you started.

Quick Start

Node.js Usage

The following example adds ver, name, host, pid and file top level property to the log output:

const Perj = require('perj')

// Customize the variables below as needed. They are not required.
const ver = 1
const name = 'QuickStart'
const host = require('os').hostname()
const pid = process.pid
const file = require('path').basename(module.filename, '.js')

const log = new Perj({ver, name, host, pid, file})

log.info('the quick brown fox jumps over the lazy dog')

/*

The following string is sent to standard out:

{"level":"info","lvl":30,"ver":1,"name":"QuickStart","host":"Dev","pid":233241,"file":"quick-start","time":1526102959677,"msg":"the quick brown fox jumps over the lazy dog","data":""}

*/

Browser Usage

The following example adds ver, name, and host top level property to the log entries:

const Perj = require('perj')

// Customize the variables below as needed. They are not required.
const ver = 1
const name = 'QuickStart'
const host = location.hostname

const log = new Perj({ver, name, host})

log.info('the quick brown fox jumps over the lazy dog')

/*

The following string is sent to the console:

{"level":"info","lvl":30,"ver":1,"name":"QuickStart","host":"http://Dev","time":1526103303019,"msg":"the quick brown fox jumps over the lazy dog","data":""}

*/

Documentation

For full documentation see the Wiki.

About the Owner

I, Grant Carthew, am a technologist, trainer, and Dad from Queensland, Australia. I work on code in a number of personal projects and when the need arises I build my own packages.

This project exists because I was not happy with other logging packages.

Everything I do in open source is done in my own time and as a contribution to the open source community.

If you are using my projects and would like to thank me or support me, please click the Patreon link below.

See my other projects on NPM.