Chalk para JavaScript (Node.js): guia completo com exemplos

O que é Chalk e para que serve?

\n\n

Chalk é uma das bibliotecas mais populares para Node.js, projetada para estilizar a saída no terminal (console). Se você já escreveu console.log() e desejou que o texto fosse colorido, negrito, sublinhado ou piscando — o Chalk resolve esse problema de forma elegante e simples.

\n\n

Para que serve? Em projetos reais, a saída colorida ajuda a:

\n

\n
• Separar visualmente logs (erros em vermelho, avisos em amarelo, sucesso em verde).
\n
• Melhorar a UX de utilitários CLI e scripts.
\n
• Destacar a atenção para mensagens importantes.
\n
• Tornar a saída mais legível em logs longos.
\n

\n\n

Chalk não usa dependências, funciona rapidamente e suporta encadeamento de chamadas (chaining). Ele detecta automaticamente se o terminal suporta cores e, se necessário, desativa a estilização (por exemplo, ao redirecionar a saída para um arquivo).

\n\n

Instalação

\n\n

Chalk é distribuído via npm. Instale-o no seu projeto:

\n\n

npm install chalk

\n\n

Se você usa yarn:

\n\n

yarn add chalk

\n\n

Após a instalação, importe a biblioteca no seu script:

\n\n

const chalk = require('chalk');

\n\n

Para projetos que usam ES modules (type: "module" no package.json), a importação fica assim:

\n\n

import chalk from 'chalk';

\n\n

Importante: A partir da versão Chalk 5.0, a biblioteca tornou-se ESM-only (apenas para ES modules). Se você usa CommonJS (require), instale a versão 4.x:

\n\n

npm install chalk@4.1.2

\n\n

Início rápido

\n\n

Vamos testar o primeiro exemplo. Crie um arquivo example.js e escreva:

\n\n

const chalk = require('chalk');\n\nconsole.log(chalk.blue('Olá, mundo!'));\nconsole.log(chalk.red.bold('Erro!'));\nconsole.log(chalk.green.underline('Sucesso'));\nconsole.log(chalk.yellow.bgBlue('Texto amarelo em fundo azul'));

\n\n

Execute:

\n\n

node example.js

\n\n

Você verá a saída colorida. Se as cores não aparecerem, verifique se o seu terminal suporta cores ANSI (terminais modernos suportam).

\n\n

Métodos e funções principais

\n\n

Chalk fornece dois tipos de API: métodos modificadores (estilos de texto) e métodos de cor (cor do texto e fundo). Todos podem ser combinados através de encadeamento de chamadas.

\n\n

1. chalk.red() — cor vermelha do texto

\n

O que faz: Colore o texto em vermelho. Mais frequentemente usado para mensagens de erro.

\n

Parâmetros: Aceita uma string ou várias strings (separadas por vírgula, serão concatenadas).

\n

console.log(chalk.red('Erro: arquivo não encontrado'));\nconsole.log(chalk.red('Erro', 'crítico', 'do sistema')); // concatena com espaço

\n\n

2. chalk.green() — cor verde do texto

\n

O que faz: Colore o texto em verde. Usado para mensagens de sucesso.

\n

Parâmetros: Similar ao red.

\n

console.log(chalk.green('Operação concluída com sucesso'));\nconsole.log(chalk.green('✓', 'Pronto'));

\n\n

3. chalk.blue() — cor azul do texto

\n

O que faz: Colore o texto em azul. Frequentemente usado para mensagens informativas.

\n

Parâmetros: String ou várias strings.

\n

console.log(chalk.blue('Informação: versão 2.0.1'));

\n\n

4. chalk.yellow() — cor amarela do texto

\n

O que faz: Colore o texto em amarelo. Tradicionalmente usado para avisos.

\n

Parâmetros: String ou várias strings.

\n

console.log(chalk.yellow(