jest-serializer-ansi-escapes

Jest snapshot serializer for ANSI escape sequences.

---

This snapshot serializer converts ANSI escape sequences into human readable text. It supports color, style and cursor control escapes and works with vanilla sequences as well as the output from libraries like chalk, colors, ansi-escapes, ansi-styles or terminal-kit.

For example, the following test:

1// ansiEscapes.test.js
2import { expect, jest, test } from "@jest/globals";
3import ansiEscapesSerializer from "jest-serializer-ansi-escapes";
4
5expect.addSnapshotSerializer(ansiEscapesSerializer);
6
7const output = [];
8
9jest
10  .spyOn(process.stdout, "write")
11  .mockImplementation((chunk) => output.push(chunk));
12
13test("ansi escapes", () => {
14  process.stdout.write("\u001b[1;2mLoading...\u001b[0m");
15  process.stdout.write("\u001b[2K\u001b[G");
16  process.stdout.write("\u001b[3;32mSuccess!\u001b[0m");
17
18  expect(output.join("")).toMatchSnapshot();
19});

would output this snapshot:

1exports[`ansi escapes 1`] = `
2"<bold, dim>Loading...</>
3<eraseLine>
4<moveCursorToColumn1>
5<italic, green>Success!</>"
6`;

Install

1npm add -D jest-serializer-ansi-escapes

Usage with Jest

You can use expect.addSnapshotSerializer() to enable the serializer for a particular test file:

1import { expect } from "@jest/globals";
2import ansiEscapesSerializer from "jest-serializer-ansi-escapes";
3
4expect.addSnapshotSerializer(ansiEscapesSerializer);

If you prefer to use it for all tests in a project, add it to the snapshotSerializers list of your Jest configuration:

1module.exports = {
2  snapshotSerializers: ["jest-serializer-ansi-escapes"],
3};

Usage with Pretty Format

A Jest snapshot serializer is a plugin of Pretty Format, hence this serializer can be also used directly with pretty-format library:

1import { format as prettyFormat } from "pretty-format";
2import ansiEscapesSerializer from "jest-serializer-ansi-escapes";
3
4const sequence = "\u001b[26G";
5
6const formattedSequence = prettyFormat(sequence, {
7  plugins: [ansiEscapesSerializer],
8});
9
10console.log(formattedSequence); // <moveCursorToColumn26>

Notes

Currently only 16 colors are all supported.

Keep in mind that the escape sequences are not validated. Unrecognized sequence will print as <ESC>[a1b2c3, or as <?> in case this is a color or style sequence.

Related

pretty-ansi — Convert ANSI escape sequences to human readable text.

License

MIT