chalker

Set ansi colors in strings using <> markers and chalk or ansi-colors.

Usage

import chalker from "chalker";

console.log(chalker("<red.bgGreen>Red on Green Text</>"));

// with template string tagging
console.log(chalker`<green>hello world</green>`);
Copy

A typical use case is to easily manage colors for logs that could go to console or log servers.

const msg = `<red>some error occurred...</red>`;

// log to console for visual with colors
if (!production) console.log(chalker(msg));

// log to log server with colors removed
logger.log(chalker.remove(msg));
Copy

Install

npm i --save chalker chalk
Copy

or:

npm i --save chalker ansi-colors
Copy

chalker expects either chalk >= 4 or ansi-colors >= 4 as a peer dependency.

Demo

Marker Details

• Color markers has the <red>red text</red> format. You can use any valid methods chalk supports.

  • For example, <blue.bold>blue bold text</blue.bold> will colorize blue bold text with chalk.blue.bold.
  • Closing marker can be simply </>

• The following HTML entities escapes are supported:

  Entity	Character	Entity	Character
  &lt;	<	&gt;	>
  &amp;	&	&nbsp;	non-breaking space
  &apos;	'	&copy;	©
  &quot;	"	&reg;	®

• HTML escape using code points also works:

  • Hex - &#xhhhh; where hhhh is the Hex code point.
  • Decimal - &#nnnn; where nnnn is the Decimal code point.
  • ie: �� makes 👩

Advanced Chalk Colors

Some advanced color markers use chalker compatibility wrappers when Chalk does not provide the corresponding API directly.

Chalk advanced colors can be applied with:

More details

• a marker is tried with chalk.keyword if:

  • it's not detected as hex value

  • it doesn't contain params enclosed in ()

  • it's not found as a basic color that chalk supports

  • for example, this is a chalk color keyword: <orange>

  • If it's prefixed with "bg-" then it's tried using chalk.bgKeyword

    • ie: <bg-orange>

• All markers can be comined with . in any order as long as they work with chalk

  • ie: <#FF0000.bg#0000FF.bg-orange.keyword(red)>

APIs

See the full API reference for every function, option, and type.

chalker

chalker(str, [chalkInstance]);
Copy

• str - String with chalker color markers
• chalkInstance - Optional custom instance of chalk.
  • ie: created from new chalk.Instance({level: 2})

Returns: A string with terminal/ansi color codes

If chalk.supportsColor is false, then markers are parsed the same way but no colors are applied. The output is the colored output minus the color codes, with HTML entities decoded. Chalk 5+ instances have no supportsColor. At level 0, chalk itself emits no color codes.

chalker.CHALK

import ansiColors from "ansi-colors";
chalker.CHALK = ansiColors;
Copy

Set the default colors library. By default, chalker loads chalk first and falls back to ansi-colors.

With ansi-colors, chalker changes the module object it uses. ansi-colors has no true-color support, so chalker adds rgb, bgRgb, hex and bgHex methods to it. This happens on load: chalker/ansi-colors always does it, and chalker does it when it falls back to ansi-colors. Each true-color marker, such as <#FF0000> or <orange>, also registers a style named like chalker_rgb_255_0_0 through colors.alias().

The default ansi-colors export is shared, so other code that imports ansi-colors sees these changes. Setting chalker.CHALK to an instance from colors.create() keeps the new styles on that instance. The methods added on load stay on the shared module.

chalker is published as an ESM-only package ("type": "module"). It can still be loaded from CommonJS with require("chalker") on Node >=22.18, but since require() of an ESM module returns the module's namespace object, you need to access .default:

const chalker = require("chalker").default;
Copy

chalker.remove

chalker.remove(str, keepHtml);
Copy

• str - String with chalker color markers
• keepHtml - If true, then don't decode HTML entity escapes.

Remove all chalker markers, then decode HTML escapes and return the plain text string. Whitespace is kept as is. Before 2.3.0, leading and trailing whitespace was trimmed.

Returns: A plain text string without chalker color markers

chalker.decodeHtml

chalker.decodeHtml(str);
Copy

• str - String to decode HTML entities

Returns: String with HTML entities escapes decoded

License

Copyright (c) 2022-2026 Joel Chen

Licensed under the Apache License, Version 2.0.