@qntm-code/progress-logger v1.3.2

@qntm-code/progress-logger

A simple progress logger for Node.js that outputs progress and estimated time remaining to the console.

• @qntm-code/progress-logger
  • Installation
    • npm
    • yarn
  • Usage
    • Constructor Arguments
    • Methods
      • itemCompleted
      • destroy
    • Example

Installation

You can install via npm or yarn.

npm

npm install --save @qntm-code/progress-logger

yarn

yarn add @qntm-code/progress-logger

Usage

Constructor Arguments

First you must create a new instance of the ProgressLogger class. The constructor takes the following arguments:

Methods

itemCompleted

Call itemCompleted on the ProgressLogger instance to increment the progress bar by one item. This method takes the following arguments:

If you don't pass a time argument when calling itemCompleted, the average time will be calculated using the durations between each time itemCompleted is called. This is useful if you are processing items batches as multiple items may be being processed at the same time.

destroy

After you've finished processing your items, you must call destroy on the ProgressLogger instance to ensure the progress logger is destroyed and prevent a memory leak.

Example

import { ProgressLogger } from '@qntm-code/progress-logger';

async function someAsyncProcess(): Promise<void> {
  // Do something
}

async function main(): Promise<void> {
  const itemsToProcess = [
    /* Some data */
  ];
  const total = itemsToProcess.length;

  const logger = new ProgressLogger({
    total,
    message: 'Processing',
    averageMessage: 'Average process time',
  });

  for (let i = 0; i < total; i++) {
    const startTime = performance.now();

    await someAsyncProcess();

    logger.itemCompleted(performance.now() - startTime);
  }

  /**
   * You must call destroy() after you've finshed processing your items to ensure the progress logger is
   * destroyed and prevent a memory leak.
   */
  logger.destroy();
}