@geek/spinner

terminal spinner - fork of sindresorhus/ora


Keywords
cli, spinner, spinners, terminal, term, console, ascii, unicode, loading, indicator, progress, busy, wait, idle
License
MIT
Install
npm install @geek/spinner@0.4.0-revision.0

Documentation

ora Build Status

Elegant terminal spinner

Modifications

This has been modified from the original version. The following changes have been made:

  • Added column property
  • Added optional text parameter to several functions

Install

$ npm install --save ora

Usage

const ora = require('ora');

const spinner = ora('Loading unicorns').start();

setTimeout(() => {
    spinner.color = 'yellow';
    spinner.text = 'Loading rainbows';
}, 1000);

API

It will gracefully not do anything when there's no TTY or when in a CI.

ora([options|text])

If a string is provided, it is treated as a shortcut for options.text.

options

Type: object

text

Type: string

Text to display after the spinner.

spinner

Type: string object
Default: dots

Name of one of the provided spinners. See example.js in this repo if you want to test out different spinners.

Or an object like:

{
    interval: 80, // optional
    frames: ['-', '+', '-']
}
color

Type: string
Default: cyan
Values: black red green yellow blue magenta cyan white gray

Color of the spinner.

interval

Type: number
Default: Provided by the spinner or 100

Interval between each frame.

Spinners provide their own recommended interval, so you don't really need to specify this.

stream

Type: WritableStream
Default: process.stderr

Stream to write the output.

You could for example set this to process.stdout instead.

enabled

Type: boolean
Default: false

Force enabling of the spinner regardless of the stream not being run inside a TTY context and/or in a CI environment.

Instance

.start([text])

Start the spinner. Returns the instance.

.stop([text])

Stop and clear the spinner. Returns the instance.

.succeed([text])

Stop the spinner, change it to a green and persist the text. Returns the instance. See the GIF below.

.fail([text])

Stop the spinner, change it to a red and persist the text. Returns the instance. See the GIF below.

.stopAndPersist([symbol], [text])

Stop the spinner, change it to symbol (or ' ' if symbol is not provided) and persist the text. Returns the instance. See the GIF below.

.clear()

Clear the spinner. Returns the instance.

.render()

Manually render a new frame. Returns the instance.

.frame()

Get a new frame.

.text

Change the text.

.color

Change the spinner color.

.column

Change column position of the spinner.

Related

License

MIT © Sindre Sorhus