Interface Chalk

Hierarchy

  • Use a template string.

    Remarks

    Template literals are unsupported for nested calls (see issue #341)

    Example

    import chalk = require('chalk');

    log(chalk`
    CPU: {red ${cpu.totalPercent}%}
    RAM: {green ${ram.used / ram.total * 100}%}
    DISK: {rgb(255,131,0) ${disk.used / disk.total * 100}%}
    `);

    Example

    import chalk = require('chalk');

    log(chalk.red.bgBlack`2 + 3 = {bold ${2 + 3}}`)

    Parameters

    Returns string

  • Parameters

    • Rest ...text: unknown[]

    Returns string

Properties

Instance bgBlack bgBlackBright bgBlue bgBlueBright bgCyan bgCyanBright bgGray bgGreen bgGreenBright bgGrey bgMagenta bgMagentaBright bgRed bgRedBright bgWhite bgWhiteBright bgYellow bgYellowBright black blackBright blue blueBright bold cyan cyanBright dim gray green greenBright grey hidden inverse italic level magenta magentaBright red redBright reset strikethrough underline visible white whiteBright yellow yellowBright

Methods

ansi ansi256 bgAnsi bgAnsi256 bgHex bgHsl bgHsv bgHwb bgKeyword bgRgb hex hsl hsv hwb keyword rgb

Properties

Instance

Instance: Instance

Return a new Chalk instance.

Readonly bgBlack

bgBlack: Chalk

Readonly bgBlackBright

bgBlackBright: Chalk

Readonly bgBlue

bgBlue: Chalk

Readonly bgBlueBright

bgBlueBright: Chalk

Readonly bgCyan

bgCyan: Chalk

Readonly bgCyanBright

bgCyanBright: Chalk

Readonly bgGray

bgGray: Chalk

Alias for bgBlackBright.

Readonly bgGreen

bgGreen: Chalk

Readonly bgGreenBright

bgGreenBright: Chalk

Readonly bgGrey

bgGrey: Chalk

Alias for bgBlackBright.

Readonly bgMagenta

bgMagenta: Chalk

Readonly bgMagentaBright

bgMagentaBright: Chalk

Readonly bgRed

bgRed: Chalk

Readonly bgRedBright

bgRedBright: Chalk

Readonly bgWhite

bgWhite: Chalk

Readonly bgWhiteBright

bgWhiteBright: Chalk

Readonly bgYellow

bgYellow: Chalk

Readonly bgYellowBright

bgYellowBright: Chalk

Readonly black

black: Chalk

Readonly blackBright

blackBright: Chalk

Readonly blue

blue: Chalk

Readonly blueBright

blueBright: Chalk

Readonly bold

bold: Chalk

Modifier: Make text bold.

Readonly cyan

cyan: Chalk

Readonly cyanBright

cyanBright: Chalk

Readonly dim

dim: Chalk

Modifier: Emitting only a small amount of light.

Readonly gray

gray: Chalk

Alias for blackBright.

Readonly green

green: Chalk

Readonly greenBright

greenBright: Chalk

Readonly grey

grey: Chalk

Alias for blackBright.

Readonly hidden

hidden: Chalk

Modifier: Prints the text, but makes it invisible.

Readonly inverse

inverse: Chalk

Modifier: Inverse background and foreground colors.

Readonly italic

italic: Chalk

Modifier: Make text italic. (Not widely supported)

level

level: Level

The color support for Chalk.

By default, color support is automatically detected based on the environment.

Levels:

  • 0 - All colors disabled.
  • 1 - Basic 16 colors support.
  • 2 - ANSI 256 colors support.
  • 3 - Truecolor 16 million colors support.

Readonly magenta

magenta: Chalk

Readonly magentaBright

magentaBright: Chalk

Readonly red

red: Chalk

Readonly redBright

redBright: Chalk

Readonly reset

reset: Chalk

Modifier: Resets the current color chain.

Readonly strikethrough

strikethrough: Chalk

Modifier: Puts a horizontal line through the center of the text. (Not widely supported)

Readonly underline

underline: Chalk

Modifier: Make text underline. (Not widely supported)

Readonly visible

visible: Chalk

Modifier: Prints the text only when Chalk has a color support level > 0. Can be useful for things that are purely cosmetic.

Readonly white

white: Chalk

Readonly whiteBright

whiteBright: Chalk

Readonly yellow

yellow: Chalk

Readonly yellowBright

yellowBright: Chalk

Methods

ansi

  • Use a Select/Set Graphic Rendition (SGR) color code number to set text color.

    30 <= code && code < 38 || 90 <= code && code < 98 For example, 31 for red, 91 for redBright.

    Parameters

    • code: number

    Returns Chalk

ansi256

  • Use a 8-bit unsigned number to set text color.

    Parameters

    • index: number

    Returns Chalk

bgAnsi

  • Use a Select/Set Graphic Rendition (SGR) color code number to set background color.

    30 <= code && code < 38 || 90 <= code && code < 98 For example, 31 for red, 91 for redBright. Use the foreground code, not the background code (for example, not 41, nor 101).

    Parameters

    • code: number

    Returns Chalk

bgAnsi256

  • Use a 8-bit unsigned number to set background color.

    Parameters

    • index: number

    Returns Chalk

bgHex

  • Use HEX value to set background color.

    Example

    import chalk = require('chalk');

    chalk.bgHex('#DEADED');

    Parameters

    • color: string

      Hexadecimal value representing the desired color.

    Returns Chalk

bgHsl

  • Use HSL values to set background color.

    Parameters

    • hue: number
    • saturation: number
    • lightness: number

    Returns Chalk

bgHsv

  • Use HSV values to set background color.

    Parameters

    • hue: number
    • saturation: number
    • value: number

    Returns Chalk

bgHwb

  • Use HWB values to set background color.

    Parameters

    • hue: number
    • whiteness: number
    • blackness: number

    Returns Chalk

bgKeyword

  • Use keyword color value to set background color.

    Example

    import chalk = require('chalk');

    chalk.bgKeyword('orange');

    Parameters

    • color: string

      Keyword value representing the desired color.

    Returns Chalk

bgRgb

  • Use RGB values to set background color.

    Parameters

    • red: number
    • green: number
    • blue: number

    Returns Chalk

hex

  • Use HEX value to set text color.

    Example

    import chalk = require('chalk');

    chalk.hex('#DEADED');

    Parameters

    • color: string

      Hexadecimal value representing the desired color.

    Returns Chalk

hsl

  • Use HSL values to set text color.

    Parameters

    • hue: number
    • saturation: number
    • lightness: number

    Returns Chalk

hsv

  • Use HSV values to set text color.

    Parameters

    • hue: number
    • saturation: number
    • value: number

    Returns Chalk

hwb

  • Use HWB values to set text color.

    Parameters

    • hue: number
    • whiteness: number
    • blackness: number

    Returns Chalk

keyword

  • Use keyword color value to set text color.

    Example

    import chalk = require('chalk');

    chalk.keyword('orange');

    Parameters

    • color: string

      Keyword value representing the desired color.

    Returns Chalk

rgb

  • Use RGB values to set text color.

    Parameters

    • red: number
    • green: number
    • blue: number

    Returns Chalk

Settings

Member Visibility

Theme