jest-console-group-reporter

A Jest reporter that groups console messages, allows filtering, and provides flexible display configuration options.

!hero

- Written in Typescript :zap:
- Supports displaying in GitHub Actions
- Provides configuration types for type safety

Table of Contents

- Installation
- Usage
- Basic configuration
- Filtering console messages
- Grouping console messages
- Dynamic group names
- Configuration
- filters
- groups
- consoleLevels
- afterEachTest
- afterAllTests
- useGitHubActions
- onlyFailingTestSuites
- Summary Reporter
- Known issues

Installation

Install jest-console-group-reporter using your favorite package manager:

``bash


npm

npm install jest-console-group-reporter -D

yarn

yarn add jest-console-group-reporter -D

pnpm

pnpm add jest-console-group-reporter -D
`

Minimum requirements

- Jest 25.1
- Node.js 16

Usage

$3

To use jest-console-group-reporter with the default configuration, simply add it to your Jest configuration:

`ts
// Add the reporter to your jest config
module.exports = {
// ...
reporters: ["jest-console-group-reporter"],
};
`

If you would like to use GitHub Actions grouping, see the example here

$3

You can filter specific console messages by providing a string, regular expression, or predicate function in the filters option:

`ts
// Add as many as you like!
const filters = ["error", /^react/];

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { filters }]],
};
`

$3

You can create custom groups by specifying them in the groups option:

`ts
// Add as many as you like!
const groups = [
{
name: "React console messages",
match: /react/,
},
];

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { groups }]],
};
`

$3

You can create dynamic group names by specifying them in the groups option:

`ts
const groups = [
{
name: ({ type }) => React console.${type},
match: /react/,
},
];

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { groups }]],
};
`

$3

Default configuration:

`ts
const defaultOptions: Options = {
consoleLevels: ["error", "warn", "info", "debug", "log"],
filters: [],
groups: [],
onlyFailingTestSuites: false,
afterEachTest: {
enable: true,
reportType: "summary",
filePaths: false,
},
afterAllTests: {
reportType: "detailed",
enable: true,
filePaths: true,
},
useGitHubActions: false,
};
`

Here are the available configuration options:

$3

An array of regular expressions, strings, or functions to filter out console messages.

Type declaration

`ts
interface ConsoleMessage {
type: string;
message: string;
origin: string | undefined;
}

type Filters = Array boolean)>;
`

##### Using a predicate function

When using a predicate function, the return type must be a boolean.

Note: The origin is not available for all types of console message. So you will need to test it before using it.

`ts
interface ConsoleMessage {
origin: string;
type: string | undefined;
message: string;
}

const filters = [
({ message }: ConsoleMessage) => message === "react",
({ origin }: ConsoleMessage) => origin && origin.match(/node_modules/),
({ type }: ConsoleMessage) => type === "error",
];

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { filters }]],
};
`

$3

An array of custom groups, where each group has a name and match property. Messages matching the match criteria will be grouped under the specified name.

Note: The origin is not available for all types of console message. So you will need to test it before using it.

Type declaration

`ts
interface ConsoleMessage {
type: string;
message: string;
origin: string;
}

type Matcher = string | RegExp | (({ type, message, origin }: ConsoleMessage) => boolean);

type Groups = Array<{
match: Matcher;
name: string | (({ type, message, origin }: ConsoleMessage) => string);
}>;
`

#### Using a predicate function

`ts
interface ConsoleMessage {
origin: string;
type: string | undefined;
message: string;
}

const groups = [
{
name: "React warnings",
match: ({ message, type }: ConsoleMessage) => message.match(/react/) && type === "warn",
},
{
name: "Error from some module",
match: ({ origin }: ConsoleMessage) => origin && origin.match(/some_module/),
},
];

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { groups }]],
};
`

$3

An array of console message types to capture (e.g., 'log', 'warn', 'error').

Type declaration

`ts
type ConsoleLevels = string[];
`

#### Example of only capturing error and warning messages

`ts
const consoleLevels = ["error", "warn"];

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { consoleLevels }]],
};
`

$3

Configuration for displaying console messages after each test.

Type declaration

`ts
interface DisplayOptions {
enable: boolean;
filePaths: boolean;
reportType: "summary" | "detailed";
}
`

- enable (boolean): Enable or disable displaying messages after each test.
- filePaths (boolean): Include file paths in the report.
- reportType ("summary" | "detailed"): Choose between "summary" and "detailed" report types

#### Disable displaying summary report after each test

`ts
const afterEachTest = {
enable: false;
}

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { afterEachTest }]],
};
`

$3

Configuration for displaying console messages after all tests have run.

Type declaration

`ts
interface DisplayOptions {
enable: boolean;
filePaths: boolean;
reportType: "summary" | "detailed";
}
`

- enable (boolean): Enable or disable displaying messages after all tests.
- filePaths (boolean): Include file paths in the report.
- reportType ("summary" | "detailed"): Choose between "summary" and "detailed" report types.

#### Disable displaying filePaths

`ts
const afterAllTest = {
filePaths: false;
}

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { afterAllTest }]],
};
`

$3

Enable GitHub Actions specific behavior. This will wrap each console message in a dropdown. You will only want to enable this property when running in github actions.

Type declaration

`ts
type UseGithubActions = boolean;
`

#### Using the is-ci package

`ts
/**
* @see https://www.npmjs.com/package/is-ci
*/
const isCI = require("is-ci");

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { useGithubActions: isCI }]],
};
`

#### Using a process.env variable

`ts
const useGithubActions = process.env.IS_CI;

module.exports = {
// ...
reporters: [["jest-console-group-reporter", { useGithubActions }]],
};
`

$3

This reporter shows console messages for all tests by default. Use the onlyFailingTestSuites option to see messages only for failing test suites. Due to Jest's limitations, messages can't be filtered for individual failing tests, only for the entire failing suites.

`ts
module.exports = {
// ...
reporters: [["jest-console-group-reporter", { onlyFailingTestSuites: true }]],
};
``

Summary Reporter

The jest-console-group-reporter internally uses the summary reporter provided by Jest to display the overall test summary. You do not need to explicitly pass the summary reporter to the reporter options, as it is automatically integrated by default.

Known issues

When running Jest for a single test file (e.g. jest src/someTest.ts), the reporter is not activated. This seems to be a bug with Jest and not this reporter :)