Skip to content

tasshi-me/jest-md-dashboard

Repository files navigation

jest-md-dashboard

npm version codecov test lint License: MIT

Generating a pretty Markdown dashboard for Jest

Table of Contents

Example

See #20

Installation

npm

npm install -D jest-md-dashboard

yarn

yarn add -D jest-md-dashboard

pnpm

pnpm add -D jest-md-dashboard

Usage

Add reporters field in jest.config.js.

const config = {
  reporters: ["default", "jest-md-dashboard"],
};
module.exports = config;

Run jest and the dashboard is generated to test-dashboard.md.

With options

const config = {
  reporters: ["default", ["jest-md-dashboard", { title: "My Dashboard" }]],
};
module.exports = config;

Options

Name Type Default Description
title string "Test Dashboard" The title of a dashboard.
It will be printed at the top of the markdown output.
outputPath string test-dashboard.md The file path to output dashboard.
If you want to output to stdout, specify -.
permalinkBaseUrl string undefined Override baseUrl of permalink.
See Permalink section for more information.

Permalink

jest-md-dashboard generates permalink to test files on GitHub (or other services) by default.

It tries to find git information from the following sources.

  1. permalinkBaseUrl option
  2. (on GitHub Actions) environment variables
  3. (in git repository) repository config

1. permalinkBaseUrl option

If permalinkBaseUrl is specified on jest config, jest-md-dashboard generates permalink using it.

Specify this option when if generated permalinks are incorrect.

The URL must have a trailing slash.

e.g. https://github.com/tasshi-me/jest-md-dashboard/blob/

2. Run on GitHub Actions

If jest runs on GitHub Actions, jest-md-dashboard refers to the the environment variables.

3. Run in git repository

If jest runs in a git repository, jest-md-dashboard refers to the local repository config.

Contribution

We appreciate your help!

License