jest-serializer-ansi-escapes

Jest snapshot serializer for ANSI escape sequences.

This snapshot serializer turns ANSI escape sequences into human readable text. It implements serialization of 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:

// ansiEscapes.test.js
import ansiEscapesSerializer from 'jest-serializer-ansi-escapes';

expect.addSnapshotSerializer(ansiEscapesSerializer);

const output = [];

jest
  .spyOn(process.stdout, 'write')
  .mockImplementation((chunk) => output.push(chunk));

test('ansi escapes', () => {
  process.stdout.write('\u001b[1;2mLoading...\u001b[0m');
  process.stdout.write('\u001b[2K\u001b[G');
  process.stdout.write('\u001b[3;32mSuccess!\u001b[0m');

  expect(output.join('')).toMatchSnapshot();
});

would output this snapshot:

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

Install

yarn add --dev jest-serializer-ansi-escapes
# or
npm install --save-dev jest-serializer-ansi-escapes

Usage with Jest

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

import ansiEscapesSerializer from 'jest-serializer-ansi-escapes';

expect.addSnapshotSerializer(ansiEscapesSerializer);

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

module.exports = {
  snapshotSerializers: ['jest-serializer-ansi-escapes'],
};

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:

import { format as prettyFormat } from 'pretty-format';
import ansiEscapesSerializer from 'jest-serializer-ansi-escapes';

const sequence = '\u001b[26G';

const formattedSequence = prettyFormat(sequence, {
  plugins: [ansiEscapesSerializer],
});

console.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.

Contributing

Something is missing for your project? Just open an issue or send a PR.

License

MIT

npm