支持颜色检测库：supports-color

在开发命令行工具或终端应用时，适配不同终端的颜色支持是一项重要的任务。supports-color 是一个简洁且高效的 Node.js 库，用于检测终端是否支持色彩显示。这个库不仅能够判断基本的彩色支持，还能识别 256 色和真彩色（16百万色）的支持情况。

安装与使用

要开始使用 supports-color，只需简单地通过 NPM 进行安装：

$ npm install supports-color

随后，你可以在你的代码中引入并使用它来检测标准输出流（stdout）或标准错误流（stderr）是否支持颜色：

import supportsColor from 'supports-color';

if (supportsColor.stdout) {
  console.log('Terminal stdout supports color');
}

if (supportsColor.stdout.has256) {
  console.log('Terminal stdout supports 256 colors');
}

if (supportsColor.stderr.has16m) {
  console.log('Terminal stderr supports 16 million colors (truecolor)');
}

API 详解

supports-color 返回一个对象，包含了 stdout 和 stderr 两个属性，分别对应这两个流的颜色支持信息。每个属性都是一个对象，或者如果终端不支持颜色，则为 false。每个对象都有一个 .level 属性，表示支持的颜色级别，并有相应的标志：

• .level = 1 和 .hasBasic = true：基础色支持（16种颜色）
• .level = 2 和 .has256 = true：256色支持
• .level = 3 和 .has16m = true：真彩色支持（16百万色）

此外，库还提供了一个名为 createSupportsColor 的函数，可以为任意的写入流创建自定义颜色支持检测器。

自定义实例

例如，你可以这样为 process.stdout 创建一个定制的实例：

import { createSupportsColor } from 'supports-color';

const stdoutSupportsColor = createSupportsColor(process.stdout);

此处的 stdoutSupportsColor 对象与 supportsColor.stdout 相同。

功能特性

• 遵守 --color 和 --no-color 命令行参数。
• 可以通过环境变量 FORCE_COLOR 强制开启或关闭颜色支持。
• 使用 --color=256 或 --color=16m 参数可强制设置为 256 色或真彩色模式。

相关项目

如果你对相关的终端美化或辅助工具感兴趣，可以查看以下项目：

• supports-color-cli - 该模块的命令行界面工具
• chalk - 端口字符串样式处理库
• is-unicode-supported - 检测终端是否支持Unicode
• is-interactive - 判断 stdout 或 stderr 是否处于交互模式

维护者

本项目的维护者包括 Sindre Sorhus 和 Josh Junon。

---

请注意：为了确保开源软件的可持续发展，该项目也提供了由 Tidelift 提供的专业支持订阅服务。这为开发者提供了保证安全、维护和许可的商业级保证，同时也支持了开源社区。

---

supports-color 是一款强大而易用的工具，将为你在处理终端色彩支持问题上带来极大的便利。无论你是新手还是经验丰富的开发者，都值得一试。立即加入，让你的命令行应用更具色彩！