Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including logger-steps with all npm packages installed. Try it out:

var loggerSteps = require("logger-steps")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

logger-steps v0.0.1

Group log messages and send them in one batch to the logger of your choize


Node NPM Travis David Coverage Status Gitmoji

Group log messages and send them grouped the logger of your choice

Log messages are useful, but they can be missleading if the order is not correct or if related messages do not appear close to each other (which is quite common on asynchronous programming). Grouping messages could be a pain and would force you to refactorize your code deeply.

This library fixes this situation by wrapping the logger of your choize and providing an interface that mimics the one of the logger. Then you can use the returned API in the same way you are used to but messages will be grouped toghether.


The most basic usage is as follows:

import loggerSteps from 'logger-steps';

trace = loggerSteps(console /* Reporter */, 'AUTH-FLOW' /* Flow title */, 15 /* Automatic flush timeout */);'Starting auth flow',;
/* Do things here ...*/
trace.warn('Something failed, trying alternative...');
/* Do more things here */
trace.error('The flow failed totally',error.message)
/* Send all the messages in one go to the selected logger, in this case the console*/
/* Console output...
 { title: 'Starting auth flow', details: '' }
 { title: 'Something failed, trying alternative...' }
 { title: 'The flow failed totally', details: 'User does not exists' }



Install via yarn

yarn add logger-steps (--dev)

or npm

npm install logger-steps (--save-dev)


You can pass in extra options to configure the behavior of the tracer (➕ required, ➖ optional, ✏️ default).

import loggerSteps from 'logger-steps';

logger ( logger )
📝 The logger you want to report to
❗️ currently it should implement the following methods: error, warn, log, info, debug
ℹ️ info
💡 example: console ➖ logger ( String ) ✏️ Steps
📝 The title of the trace
ℹ️ It will appear at the top of the output
💡 example: 'AUTH-FLOW' ➖ logger ( Number ) ✏️ 30
📝 Timeout before triggering an automatic flush
❗️ Setting a big timeout could lead to higher memmory usage in case you forget to flush often
ℹ️ info:
💡 example: 15





See example folder or the runkit example.


If you don't use a package manager, you can access logger-steps via unpkg (CDN), download the source, or point your package manager to the url.

logger-steps is compiled as a collection of CommonJS modules & [ES2015 modules]( -9/es6-modules-final.html) for bundlers that support the jsnext:main or module field in package.json (Rollup, Webpack 2)

The logger-steps package includes precompiled production and development UMD builds in the dist folder. They can be used directly without a bundler and are thus compatible with many popular JavaScript module loaders and environments. You can drop a UMD build as a <script> tag on your page. The UMD builds make logger-steps available as a window.loggerSteps global variable.


The code is available under the MIT license.


We are open to contributions, see for more info.


This module was created using generator-module-boilerplate.


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free