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 nyan-progress with all npm packages installed. Try it out:

var nyanProgress = require("nyan-progress")

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

nyan-progress v1.1.0

Nyan cat progress bar because why not?

nyan-progress

A nyan cat progress bar for Node. npm version

NPM

screenshot


Installation

yarn add nyan-progress

or if you use npm instead,

npm install --save nyan-progress

Usage

import nyanProgress from 'nyan-progress';
// OR
// const nyanProgress = require('nyan-progress);

const progress = nyanProgress(); // initialize
progress.start({ total: 100 }); // start the progress

const timer = setInterval(() => {
  progress.tick();

  if (progress.isComplete) {
    clearInterval(timer);
  }
}, 100);

The above example will produce the result shown in the gif in the begining.

options

The start() function can pass in an option object, the available options are listed below.

  • curr: the start point of the progress. Default: 0.
  • total: the end point of the progress. Default: 100.
  • width: the length of the progress bar. Default: 20.
  • renderThrottle: the interval that the progress update, in milliseconds. Default: 500.
  • message: an object containing the message to show in the progress.
    • downloading: a list of frames to show when downloading. Default: ['Nyaning. ', 'Nyaning.. ', 'Nyaning...'].
    • finished: a string to show when the progress is completed. Default: 'Nyaned'.
    • error: a string to show when the progress is interupted. Default: 'Something nyan wrong...'.
  • callback: callback function to do when completed.

You can also pass the callback function as second argument of the start() function.

progress.start({}, callback);

The start() function also return a promise.

progress.start().then(callback);

API

start(options, callback?)

The function to nyan the cat.

tick(value? = 1)

The function that increment curr by value, value is default to 1 if not specified. When curr reached to total, the progress will stop.

interupt()

For whatever reason you want to interupt the nyaning, call it. Note that it would not throw any error but display error message in the progress itself.

License

MIT

Credits

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