jest-results v1.0.3

jest-results

Capture jest test output and collect it in individual log files.

Features

• console output (.log(), .warn(), etc.) will be captured and written to individual log files next to the test file itself
• actual log output can either be (1) kept in the console or (2) solely written to the log files
• statistics about any given test file will also be written into 1 additional file per test file
• the status of tests (OK, FAIL, SKIP, TODO) is directly visible via log file names
• mechanism correctly handles explicit and implicit skipping of tests (where explicit would be the usage of .skip(), and implicit would be the usage of .only() on other tests - and similar scenarios)
• included command line tool allows to easily clean repo from log- and/or stats-files
• entire mechanism can conditionally be turned off (for instance for CI/CD pipelines via env var process.env.CI === 'true')
• jest-results is actual a set of 2 similar jest testEnvironments, and provides both, a node and a jsdom variant. (For more infos on what that means, please refer to the Jest documentation.)

Install

npm install --save jest-results

Or if you use Yarn:

yarn add jest-results

Usage

To use jest-results simply set it as your testEnvironment. It depends on how you have set up Jest in your project, in case you are using a jest.config.js file for instance, you would just add the following:

module.exports = {
  // ...some already existing here props maybe...

  testEnvironment: "jest-results/node",
  // OR:
  testEnvironment: "jest-results/jsdom",
};

If you run your tests after doing the above, it should already be working (meaning, creating stats- and log-files at the end of each test run).

However, a few things are configurable, and so far it will use the default settings. If you want to have more control over how it behaves, check out the following section.

Options

To configure jest-results provide a testEnvironmentOptions property, similar to how you have already defined the testEnvironment. Again, this can vary, for instance you can also provide these things via command line etc.

The following example, again, shows how to do it via the jest.config.js file:

module.exports = {
  // ...some already existing here props maybe, including your testEnvironment setting!...

  testEnvironmentOptions: {
    jestResults: {
      getIsJestResultsEnabled: () => process.env.CI !== "true",
      keepLoggingToConsole: false,
      ignoreExplicitlySkippedTests: false,
      ignoreImplicitlySkippedTests: true,
      ignoreNotRunTests: false,
      setupHook: () => {
        console.log("Hi from setupHook!");
      },
      teardownHook: () => {
        console.log("Hi from teardownHook!");
      },
    },
  },
};

The following table describes the meaning of these configuration options. None of them is mandatory for now, you can see the corresponding fallback/default value too:

Clean up / Command line tool

A command line tool for cleaning up / removing jest-results files is included.

To use it simply run jest-results somewhere inside your repository. You can use this tool in the root folder as well as some deeper nested directory - the tool is capable of identifying the repository's root - if necessary.

Usage and options for this tool can be found by running jest-results -h, which will show the following:

Usage:
jest-results -c <clean_mode> [-d <directory_option>]

Options:
-h, --help      Display this help info
-v, --version   Return this package's version number
-c              CLEAN MODE
                Select which kinds of files should be removed.
                Accepts one of the following values:
                'all', 'stats', 'logs'
-d              DIRECTORY OPTION (optional)
                Select which directory is going to be clean up recursively.
                Accepts one of the following values:
                'root', 'current'
                When using 'root', which is the default, it does not matter what your current working directory is,
                it will clean your entire repository. When using 'current' it will clean your current working directory
                recursively.
-i              INVERT DIRECTORY SELECTION (optional)
                This can only be used in combination with `-d current`.
                When set, it will clean your entire repository except for the current working directory (and children directories).