1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
# Colorette [](https://www.npmjs.org/package/colorette)
> Color your terminal using pure idiomatic JavaScript.
Colorette is a Node.js library for embellishing your CLI tools with colors and styles using [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code).
- ~1.5x faster than alternatives ([run the benchmarks](#run-the-benchmarks)).
- No wonky prototype-based method chains.
- Automatic color support detection.
- ~80 LOC and no dependencies.
- [`NO_COLOR`](https://no-color.org) friendly.
## Quickstart
```console
npm i colorette
```
Import the [styles](#styles) you need. [Here](#supported-styles)'s the list of styles you can use.
```js
import { red, blue, bold } from "colorette"
```
Wrap your strings in one or more styles to produce the finish you're looking for.
```js
console.log(bold(blue("Engage!")))
```
Mix it with [template literals](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals) to interpolate variables, expressions and create multi-line strings easily.
```js
console.log(`
Beets are ${red("red")},
Plums are ${blue("blue")},
${bold("Colorette!")}.
`)
```
Using `console.log`'s [string substitution](https://nodejs.org/api/console.html#console_console_log_data_args) can be useful too.
```js
console.log(bold("Total: $%f"), 1.99)
```
You can also nest styles without breaking existing escape codes.
```js
console.log(red(`Red Shirt ${blue("Blue Shirt")} Red Shirt`))
```
Feeling adventurous? Try the [pipeline operator](https://github.com/tc39/proposal-pipeline-operator).
```js
console.log("Make it so!" |> bold |> blue)
```
## Supported styles
Colorette supports the standard and bright color variations out-of-the-box. See [this issue](https://github.com/jorgebucaran/colorette/issues/27) if you were looking for TrueColor support.
| Colors | Background Colors | Bright Colors | Bright Background Colors | Modifiers |
| ------- | ----------------- | ------------- | ------------------------ | ----------------- |
| black | bgBlack | blackBright | bgBlackBright | dim |
| red | bgRed | redBright | bgRedBright | **bold** |
| green | bgGreen | greenBright | bgGreenBright | hidden |
| yellow | bgYellow | yellowBright | bgYellowBright | _italic_ |
| blue | bgBlue | blueBright | bgBlueBright | underline |
| magenta | bgMagenta | magentaBright | bgMagentaBright | ~~strikethrough~~ |
| cyan | bgCyan | cyanBright | bgCyanBright | reset |
| white | bgWhite | whiteBright | bgWhiteBright | |
| gray | | | | |
## API
### <code><i>style</i>(string)</code>
Returns a string wrapped in the corresponding ANSI escape codes.
```js
red("Red Alert") //=> \u001b[31mRed Alert\u001b[39m
```
### `options.enabled`
Color will be enabled if your terminal supports it, `FORCE_COLOR` is defined in [`process.env`](https://nodejs.org/dist/latest-v8.x/docs/api/process.html#process_process_env) and if `NO_COLOR` isn't, but you can always override it if you want.
```js
import { options } from "colorette"
options.enabled = false
```
## Run the benchmarks
```
npm i -C bench && node bench
```
<pre>
colorette × 759,429 ops/sec
chalk × 524,034 ops/sec
kleur × 490,347 ops/sec
colors × 255,661 ops/sec
ansi-colors × 317,605 ops/sec
</pre>
## License
[MIT](LICENSE.md)
|
