# @skills17/test-result

> Commonly generates and prints test results.

Latest version **2.1.0** (published 2021-11-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @skills17/test-result
pnpm add @skills17/test-result
yarn add @skills17/test-result
bun add @skills17/test-result
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.1.0 |
| Published | 2021-11-24 |
| First published | 2021-01-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 21.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Cyril Wanner |
| Maintainers | cyrilwanner, skills17 |

## Links

- npm: https://www.npmjs.com/package/@skills17/test-result
- Repository: https://github.com/skills17/test-result
- Homepage: https://github.com/skills17/test-result#readme
- Issues: https://github.com/skills17/test-result/issues
- npm.io page: https://npm.io/package/@skills17/test-result

## Recent versions

- 2.1.0 (latest) — 2021-11-24
- 2.0.4 — 2021-09-13
- 2.0.3 — 2021-02-28
- 2.0.2 — 2021-02-22
- 2.0.1 — 2021-02-19
- 2.0.0 — 2021-02-18
- 1.0.2 — 2021-01-07
- 1.0.1 — 2021-01-07
- 1.0.0 — 2021-01-04

## README

# skills17/test-result

This package commonly generates and converts test results.
It can be used to abstract logic for the different testing library helper packages.

## Table of contents

- [Installation](#installation)
- [Usage](#usage)
  - [Specific test overrides](#specific-test-overrides)
  - [Converting to JSON](#converting-to-json)
- [License](#license)

## Installation

```bash
npm install @skills17/test-result
```

## Usage

First, create a new instance for every test run:

```typescript
import { TestRun, Group, Strategy, Override } from '@skills17/test-result';

const run = new TestRun();
```

After that, you have to define and add all test groups:

```typescript
/**
 * Group constructor:
 *
 * @param {string}    match           Tests that match this regular expression
 *                                    get added to the group
 * @param {number}    defaultPoints   Points a test within this group will award
 *                                    by default
 * @param {Strategy}  strategy        Either Strategy.Add or Strategy.Deduct
 * @param {string}    [displayName]   Group name that should be used in outputs
 * @param {number}    [maxPoints]     Only for the deduct strategy, a point maximum
 *                                    can be set
 */

run.addGroup(new Group('CountriesIndex.+', 1, Strategy.Add));
```

Once all groups have been added, you can start recording tests:

```typescript
/**
 * recordTest method:
 *
 * @param {string}    fullName    Full test name including all groups
 * @param {string}    testName    Test name only that is used for display
 * @param {boolean}   extra       Whether it is an extra test or not
 * @param {boolean}   successful  Whether the test was successful or not
 * @returns {Group}               Group that matched or false if no matching group was found
 */

run.recordTest('Countries > IndexAll', 'IndexAll', false, true);
```

The difference between `fullName` and `testName` is that `fullName` should include all groups
(the name of the `describe()` or `context()` calls) as well as the actual test name
(`it()` or `test()` calls) while the `testName` is only the actual test name (`it()` or `test()`).
`fullName` will then be used to match against a group and `testName` will be used for displaying
the result.

After that, points and everything else will get calculated automatically.
To get an overview of available getters and other functions, take a look at the [class implementations](https://github.com/skills17/test-result/tree/master/src).

### Specific test overrides

If specific tests should award more points or have to pass in order that the whole group passes,
overrides can be defined on a group.

```typescript
/**
 * Override constructor:
 *
 * @param {string}  match             The override applies to all tests
 *                                    that match this regular expression
 * @param {boolean} [required=false]  If the test is required for the whole
 *                                    group to pass
 * @param {boolean} [points]          Points this test awards
 */

group.addOverride(new Override('CountriesIndexJson', true, 0));
```

### Converting to JSON

The whole test run can simply be converted to JSON by passing the object to the `JSON.stringify` function:
```typescript
JSON.stringify(run);
```

## License

[MIT](https://github.com/skills17/test-result/blob/master/LICENSE)

---
_Source: https://npm.io/package/@skills17/test-result · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._