ansi-escape

ansi-escape

ANSI escape codes for manipulating the terminal

Usage

var csi = require('ansi-escape')

console.log('1'.repeat(8))
console.log(
  csi
    // underline text
    .underline

    // red text
    .red

    // move cursor one line up
    .cursorUp

    // move cursor 2 cells forward
    .cursorForward(2)

    // the text to be escaped
    .escape('2'.repeat(4))
)

Output:

Cursors

cursorUp(n = 1)

Alias: cuu, up

Moves the cursor n cells up.

cursorDown(n = 1)

Alias: cud, down

Moves the cursor n cells down.

cursorForward(n = 1)

Alias: cuf, forward

Moves the cursor n cells forward.

cursorBackward(n = 1)

Alias: cub, back

Moves the cursor n cells backward.

cursorColumn(n = 1)

Alias: cha, col

Moves the cursor to column n.

cursorPosition(n = 1, m = 1)

Alias: cup

Moves the cursor to row n, column m.

eraseDisplay(n = 0)

Sugar: eraseDisplayEnd, eraseDisplayStart, eraseDisplayEntire

Clears part of the screen.

• If n is 0 (or missing), clear from cursor to end of screen.
• If n is 1, clear from cursor to beginning of the screen.
• If n is 2, clear entire screen (and moves cursor to upper left on DOS ANSI.SYS).

eraseLine(n = 0)

Sugar: eraseLineEnd, eraseLineStart, eraseLineEntire

Erases part of the line.

• If n is 0 (or missing), clear from cursor to the end of the line.
• If n is 1, clear from cursor to beginning of the line.
• If n is 2, clear entire line.

Cursor position does not change.

scrollUp(n = 1)

Alias: su

Scroll whole page up by n (default 1) lines. New lines are added at the bottom.

scrollDown(n = 1)

Alias: sd

Scroll whole page down by n (default 1) lines. New lines are added at the top.

saveCursorPosition

Alias: scp, saveCursor

Saves the cursor position.

restoreCursorPosition

Alias: rcp, restoreCursor

Restores the cursor position.

hideCursor

Alias: hide

Hides the cursor.

showCursor

Alias: show

Shows the cursor.

Styles

Modifiers

• bold
• dim
• italic
• underline
• blink
• inverse
• hidden
• strikethrough

Colors

• black
• red
• green
• yellow
• blue
• magenta
• cyan
• white

Background colors

• bgBlack
• bgRed
• bgGreen
• bgYellow
• bgBlue
• bgMagenta
• bgCyan
• bgWhite

Changelog

v1.0.1 (2015-11-23)

• [7adaaf6] Update readme

• [b17353c] Remove npm badge

• [e19ba23] remove unused gulpfile.js