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

    • text: TemplateStringsArray
    • Rest ...placeholders: unknown[]

    Returns string

  • Parameters

    • Rest ...text: unknown[]

    Returns string

References

Re-exports bold

Properties

Instance: default.Instance

Return a new Chalk instance.

bgBlack: default.Chalk
bgBlackBright: default.Chalk
bgBlue: default.Chalk
bgBlueBright: default.Chalk
bgCyan: default.Chalk
bgCyanBright: default.Chalk
bgGray: default.Chalk
bgGreen: default.Chalk
bgGreenBright: default.Chalk
bgGrey: default.Chalk
bgMagenta: default.Chalk
bgMagentaBright: default.Chalk
bgRed: default.Chalk
bgRedBright: default.Chalk
bgWhite: default.Chalk
bgWhiteBright: default.Chalk
bgYellow: default.Chalk
bgYellowBright: default.Chalk
black: default.Chalk
blackBright: default.Chalk
blueBright: default.Chalk
cyanBright: default.Chalk

Modifier: Emitting only a small amount of light.

green: default.Chalk
greenBright: default.Chalk
hidden: default.Chalk

Modifier: Prints the text, but makes it invisible.

inverse: default.Chalk

Modifier: Inverse background and foreground colors.

italic: default.Chalk

Modifier: Make text italic. (Not widely supported)

level: default.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.
magenta: default.Chalk
magentaBright: default.Chalk
redBright: default.Chalk
reset: default.Chalk

Modifier: Resets the current color chain.

strikethrough: default.Chalk

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

underline: default.Chalk

Modifier: Make text underline. (Not widely supported)

visible: default.Chalk

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

white: default.Chalk
whiteBright: default.Chalk
yellow: default.Chalk
yellowBright: default.Chalk

Methods

  • 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 default.Chalk

  • 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 default.Chalk

  • Use HSL values to set background color.

    Parameters

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

    Returns default.Chalk

  • Use HSV values to set background color.

    Parameters

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

    Returns default.Chalk

  • Use HWB values to set background color.

    Parameters

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

    Returns default.Chalk

  • 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 default.Chalk

  • Use RGB values to set background color.

    Parameters

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

    Returns default.Chalk

  • 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 default.Chalk

  • Use HSL values to set text color.

    Parameters

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

    Returns default.Chalk

  • Use HSV values to set text color.

    Parameters

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

    Returns default.Chalk

  • Use HWB values to set text color.

    Parameters

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

    Returns default.Chalk

  • 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 default.Chalk

  • Use RGB values to set text color.

    Parameters

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

    Returns default.Chalk

Generated using TypeDoc