https://github.com/f1lt3r/ansi-parse
🤖 Parse ANSI text into an array of ansi-tags and text-chunks.
https://github.com/f1lt3r/ansi-parse
ansi chalk character close color escape open parse parser sequence style text
Last synced: 6 months ago
JSON representation
🤖 Parse ANSI text into an array of ansi-tags and text-chunks.
- Host: GitHub
- URL: https://github.com/f1lt3r/ansi-parse
- Owner: F1LT3R
- License: mit
- Created: 2018-04-02T13:29:48.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-04-07T04:16:14.000Z (over 7 years ago)
- Last Synced: 2025-04-02T10:09:53.886Z (6 months ago)
- Topics: ansi, chalk, character, close, color, escape, open, parse, parser, sequence, style, text
- Language: JavaScript
- Homepage: https://f1lt3r.io
- Size: 47.9 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ansi-parse
> 🤖 Parse ansi into an array of ansi-tags and text-chunks.
[](https://travis-ci.org/F1LT3R/ansi-parse)
[](https://coveralls.io/github/F1LT3R/ansi-parse?branch=master)
[](https://www.npmjs.com/package/@f1lt3r/ansi-parse)
[](https://github.com/sindresorhus/xo)
ANSI-Parse takes an ANSI string as input:
```plain
const text = "🤖\u001B[31m DANGER\u001B[0m Will Robbinson"
console.log(text)
```
When you run your text through the ANSI-Parse...
```js
const ansiParse = require('ansi-parse')
const parsed = ansiParse(text)
console.log(parsed)
```
...ANSI-Parse outputs value, position and style data.
```js
{
raw: '🤖\u001B[31m DANGER\u001B[0m Will Robbinson',
plain: '🤖 DANGER Will Robbinson',
textArea: {columns: 24, rows: 1},
chunks: [{
type: 'text',
value: '🤖',
position: {x: 0, y: 0, n: 0, raw: 0},
style: {}
}, {
type: 'ansi',
value: {tag: 'red', ansi: '\u001b[31m'},
position: {x: 2, y: 0, n: 2, raw: 2}
}, {
type: 'text',
value: ' DANGER',
position: {x: 2,y: 0,n: 2, raw: 7},
style: {
foregroundColor: 'red'
}
}, {
type: 'ansi',
value: {tag: 'reset', ansi: '\u001b[0m'},
position: {x: 9, y: 0, n: 9, raw: 14}
}, {
type: 'text',
value: ' Will Robbinson',
position: {x: 9, y: 0, n: 9, raw: 18},
style: {}
}]
}
```
This data can be used to convert ANSI sequences to other formatsm such as HTML, Image, SVG, etc.
## Chunk
Each object in the output array is called a "chunk". Each chunk represents one or more of the following data types.
1. `ansi` - ANSI escape sequence
1. `newline` - Newline character
1. `text` - Text chunk of like-styles
## Style
The style object contains a list of styles associated with the current chunk. Each style represents an ANSI Escape sequence that is mapped to friendly name called an `ANSI-Tag`.
- Styles are only included in text chunks.
- Styles that are off/closed, are not present in the style object.
The following style object describes a chunk of red text:
```js
{
foregroundColor: 'red'
}
```
This object shows alls styles in combination:
```js
{
backgroundColor: 'bgRed',
foregroundColor: 'white',
dim: true,
bold: true,
italic: true,
underline: true,
strikethrough: true,
inverse: true
}
```
Styles that are closed or reset are not included in the style object.
For example:
```js
// Turn on Bold
const text = '\u001b[1m BOLD' +
// Turn off all styles
'\u001b[0m NORMAL'
const parsed = ansiParse(text)
const styles = parsed
.filter(chunk => chunk.style)
.map(chunk => chunk.style)
console.log(styles)
```
The above code should log:
```js
[
// Turn on Bold
{ bold: true },
// Turn off all styles
{}
]
```
## Position
```js
{x: 2, y: 0, n: 2, raw: 2}
```
The position object contains 4 kinds of position:
1. `x` - Plain-text column at which the chunk starts
1. `y` - Plain-text crow at which the chunk starts
1. `n` - Linear, 1-dimensional plain-text position at which the chunk starts.
1. `raw` - Linear 1-dimensional position at which the chunk starts for ANSI or plain-text. This is the real JavaScript position string position of the chunk.
## Value
### Text Value
The value of a `text` chunk is a JavaScript string. The value of a text chunk should never contain any ANSI escape sequences.
```js
{
type: 'text',
value: ' DANGER',
}
```
### ANSI Value
The value of an `ansi` chunk is an object.
- `value.tag` - Friendly-named ansi-tag.
- `value.ansi` - Raw ANSI string value.
```js
{
type: 'ansi',
value: {
tag: 'red',
ansi: '\u001b[31m'
}
}
```
You can find the list ansi-tags in [types/types.ansi-seqs-to-ansi-tags.js](types/types.ansi-seqs-to-ansi-tags.js).
## Install
```
$ yarn add ansi-parse
```