On this page

This recipe migrates from the external ansi-colors package to Node.js's built-in util.styleText API. It transforms ansi-colors method calls to use the native Node.js styling functionality.

Run this codemod with:

npx codemod @nodejs/ansi-colors-to-styletext
 
- import ac from 'ansi-colors';
+ import { styleText, stripVTControlCharacters } from 'node:util';

- console.log(ac.red('Error message'));
+ console.log(styleText('red', 'Error message'));

- console.log(ac.green('Success message'));
+ console.log(styleText('green', 'Success message'));

- console.log(ac.unstyle(ac.bold.blue('Info message')));
+ console.log(stripVTControlCharacters(styleText(['bold', 'blue'], 'Info message')));
Diff
- const ac = require('ansi-colors');
+ const { styleText } = require('node:util');

- console.log(ac.bold.red('Critical error'));
+ console.log(styleText(['bold', 'red'], 'Critical error'));
Diff
- const { red, blue } = require('ansi-colors');
+ const { styleText } = require('node:util');

- console.log(red('Error'));
+ console.log(styleText('red', 'Error'));

- console.log(blue('Info'));
+ console.log(styleText('blue', 'Info'));
Diff
  • Removes ansi-colors dependency from package.json automatically
  • Supports all ansi-colors methods: colors, background colors, text modifiers, and chained styles
  • Unsupported methods: enabled, visible, unstyle, alias, theme, create (warnings will be shown)
  • Runtime toggles like ac.enabled = false require manual intervention
  • Custom themes and aliases need to be rewritten as plain objects
  • Dynamic imports with .then() are not transformed and require manual migration