Chalk para JavaScript (Node.js): guía completa con ejemplos

¿Qué es Chalk y para qué sirve?

\n\n

Chalk es una de las bibliotecas más populares para Node.js, diseñada para estilizar la salida en la terminal (consola). Si alguna vez has escrito console.log() y has deseado que el texto fuera de color, negrita, subrayado o parpadeante — Chalk resuelve esta tarea de manera elegante y sencilla.

\n\n

¿Para qué sirve? En proyectos reales, la salida de color ayuda a:

\n

\n
• Separar visualmente los registros (errores en rojo, advertencias en amarillo, éxito en verde).
\n
• Mejorar la UX de utilidades CLI y scripts.
\n
• Destacar la atención en mensajes importantes.
\n
• Hacer la salida más legible en registros largos.
\n

\n\n

Chalk no utiliza dependencias, funciona rápido y admite encadenamiento de llamadas (chaining). Detecta automáticamente si la terminal admite colores y, si es necesario, desactiva la estilización (por ejemplo, al redirigir la salida a un archivo).

\n\n

Instalación

\n\n

Chalk se distribuye a través de npm. Instálalo en tu proyecto:

\n\n

npm install chalk

\n\n

Si usas yarn:

\n\n

yarn add chalk

\n\n

Después de la instalación, importa la biblioteca en tu script:

\n\n

const chalk = require('chalk');

\n\n

Para proyectos que usan módulos ES (type: "module" en package.json), la importación se ve así:

\n\n

import chalk from 'chalk';

\n\n

Importante: A partir de la versión Chalk 5.0, la biblioteca se volvió solo para módulos ES (ESM-only). Si usas CommonJS (require), instala la versión 4.x:

\n\n

npm install chalk@4.1.2

\n\n

Inicio rápido

\n\n

Probemos el primer ejemplo. Crea un archivo example.js y escribe:

\n\n

const chalk = require('chalk');\n\nconsole.log(chalk.blue('¡Hola, mundo!'));\nconsole.log(chalk.red.bold('¡Error!'));\nconsole.log(chalk.green.underline('Éxito'));\nconsole.log(chalk.yellow.bgBlue('Texto amarillo sobre fondo azul'));

\n\n

Ejecuta:

\n\n

node example.js

\n\n

Verás una salida de color. Si los colores no se muestran, verifica si tu terminal admite colores ANSI (las terminales modernas los admiten).

\n\n

Métodos y funciones principales

\n\n

Chalk proporciona dos tipos de API: métodos modificadores (estilos de texto) y métodos de color (color de texto y fondo). Todos se pueden combinar mediante encadenamiento de llamadas.

\n\n

1. chalk.red() — color de texto rojo

\n

Qué hace: Colorea el texto de rojo. Se usa más a menudo para mensajes de error.

\n

Parámetros: Acepta una cadena o varias cadenas (separadas por coma, las une).

\n

console.log(chalk.red('Error: archivo no encontrado'));\nconsole.log(chalk.red('Error', 'crítico', 'del sistema')); // las une con espacio

\n\n

2. chalk.green() — color de texto verde

\n

Qué hace: Colorea el texto de verde. Se usa para mensajes de éxito.

\n

Parámetros: Similar a red.

\n

console.log(chalk.green('Operación completada con éxito'));\nconsole.log(chalk.green('✓', 'Listo'));

\n\n

3. chalk.blue() — color de texto azul

\n

Qué hace: Colorea el texto de azul. Se usa a menudo para mensajes informativos.

\n

Parámetros: Una cadena o varias cadenas.

\n

console.log(chalk.blue('Información: versión 2.0.1'));

\n\n

4. chalk.yellow() — color de texto amarillo

\n

Qué hace: Colorea el texto de amarillo. Tradicionalmente se usa para advertencias.

\n

Parámetros: Una cadena o varias cadenas.

\n

console.log(chalk.yellow(