Preferência de cor lida pela ferramenta
A NO_COLOR é uma variável de ambiente usada por uma convenção informal para desativar as cores que ferramentas de terminal acrescentam por padrão. Um programa compatível verifica se a variável existe e contém um valor não vazio. Nesse caso, deixa de adicionar os códigos de cor ANSI à saída.
A verificação acontece no programa, por isso a variável só tem efeito nas ferramentas que a implementam. O terminal continua capaz de mostrar cores produzidas por outros programas.
Um exemplo com Node.js
Num shell compatível com a sintaxe abaixo, você pode fornecer a variável apenas à execução de um comando:
NO_COLOR=1 node -p 'process.env.NO_COLOR'O comando imprime 1, o que demonstra que o processo recebeu a variável, sem testar uma saída colorida. Para conferir o efeito visual, você precisa executar uma ferramenta compatível que acrescente cores por padrão.
A convenção aceita qualquer valor não vazio, portanto o texto false também desativa as cores por padrão. Uma opção explícita de cor na chamada do programa pode prevalecer sobre a preferência definida no ambiente.
Dúvidas frequentes
Perguntas frequentes sobre NO_COLOR
- NO_COLOR=0 permite usar cores?
- Pela convenção, o texto 0 é um valor não vazio e sinaliza a preferência por saída sem cores. O conteúdo do valor não funciona como um booleano.
- Uma opção explícita de cor pode prevalecer sobre NO_COLOR?
- A convenção prevê que argumentos da execução e configurações específicas do programa tenham prioridade sobre a variável de ambiente.
- A variável também desativa negrito e sublinhado?
- A convenção trata da adição de cores ANSI à saída. Ela não exige retirar outros atributos de apresentação, como negrito e sublinhado.
Para continuar
Recursos relacionados
Documentação
NO_COLOR: convenção de preferência da saída
Define a verificação de valor não vazio e a prioridade das configurações específicas do programa.
Abrir recursoAplicação na formação
Developer Workspace
Ao configurar o terminal de trabalho, você pode ajustar a saída das ferramentas compatíveis com a convenção NO_COLOR.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.