# @chialab/rna-browser-test-runner

> A test runner for browsers based on Web Test Runner.

Latest version **0.18.0** (published 2024-01-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install @chialab/rna-browser-test-runner
pnpm add @chialab/rna-browser-test-runner
yarn add @chialab/rna-browser-test-runner
bun add @chialab/rna-browser-test-runner
```

## Health

**Score 35/100 (D)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads; pre 1.0.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 0.18.0 |
| Published | 2024-01-11 |
| First published | 2021-04-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18 |
| Dependencies | 8 |
| Unpacked size | 12.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 183 |
| Author | Chialab |
| Maintainers | chialab-admin, chialab-developers |
| Keywords | test-runner, webapp, browser, unit, testing |

## Links

- npm: https://www.npmjs.com/package/@chialab/rna-browser-test-runner
- Repository: https://github.com/chialab/rna
- Homepage: https://github.com/chialab/rna#readme
- Issues: https://github.com/chialab/rna/issues
- npm.io page: https://npm.io/package/@chialab/rna-browser-test-runner

## Dependencies (8)

- [@web/test-runner-core](https://npm.io/package/@web/test-runner-core.md) ^0.13.0
- [@web/test-runner-mocha](https://npm.io/package/@web/test-runner-mocha.md) ^0.9.0
- [@chialab/rna-dev-server](https://npm.io/package/@chialab/rna-dev-server.md) ^0.18.0
- [@chialab/rna-config-loader](https://npm.io/package/@chialab/rna-config-loader.md) ^0.18.0
- [@chialab/wtr-mocha-reporter](https://npm.io/package/@chialab/wtr-mocha-reporter.md) ^0.18.0
- [@web/test-runner-playwright](https://npm.io/package/@web/test-runner-playwright.md) ^0.11.0
- [@chialab/wtr-coverage-reporter](https://npm.io/package/@chialab/wtr-coverage-reporter.md) ^0.18.0
- [@chialab/wds-plugin-node-resolve](https://npm.io/package/@chialab/wds-plugin-node-resolve.md) ^0.18.0

## Alternatives

- [duck](https://npm.io/package/duck.md) — 4.2M weekly downloads
- [ava](https://npm.io/package/ava.md) — 560.2K weekly downloads
- [storybook-addon-module-mock](https://npm.io/package/storybook-addon-module-mock.md) — 71.7K weekly downloads
- [@ethereum-waffle/mock-contract](https://npm.io/package/@ethereum-waffle/mock-contract.md) — 40.0K weekly downloads
- [aws-elasticsearch-connector](https://npm.io/package/aws-elasticsearch-connector.md) — 37.4K weekly downloads

## Recent versions

- 0.18.0 (latest) — 2024-01-11
- 0.18.0-alpha.1 (alpha) — 2023-08-29
- 0.14.9 (beta) — 2021-12-22
- 0.17.4 — 2023-05-09
- 0.18.0-alpha.0 — 2023-05-01
- 1.0.0-alpha.0 — 2023-05-01
- 0.17.3 — 2023-04-17
- 0.17.2 — 2022-12-13
- 0.17.1 — 2022-08-23
- 1.0.0 — 2022-08-23
- 0.16.2 — 2022-07-07
- 0.16.1 — 2022-06-16
- 0.16.0 — 2022-06-08
- 0.15.37 — 2022-05-26
- 0.15.35 — 2022-05-19
- … 182 more at https://npm.io/package/@chialab/rna-browser-test-runner/versions

## README

<p align="center">
    <a href="https://www.chialab.io/p/rna">
        <img alt="RNA logo" width="144" height="144" src="https://raw.githack.com/chialab/rna/main/logo.svg" />
    </a>
</p>

<p align="center">
    <strong>RNA Browser Test Runner</strong> • A test runner for browsers based on <a href="https://modern-web.dev/docs/test-runner/overview/">Web Test Runner</a>.
</p>

<p align="center">
    <a href="https://www.npmjs.com/package/@chialab/rna-browser-test-runner"><img alt="NPM" src="https://img.shields.io/npm/v/@chialab/rna-browser-test-runner.svg?style=flat-square"></a>
</p>

---

## Install

```sh
npm i @chialab/rna-browser-test-runner -D
```

```sh
yarn add @chialab/rna-browser-test-runner -D
```

## Usage

Start a browser [test runner](https://modern-web.dev/docs/test-runner/overview/) based on the web dev server. It uses [mocha](https://mochajs.org/) but you still need to import an assertion library (recommended [`@open-wc/testing`](https://open-wc.org/docs/testing/testing-package/)).

### Via import

```js
import { test } from '@chialab/rna-browser-test-runner';

/**
 * @see https://modern-web.dev/docs/test-runner/cli-and-configuration/
 */
await test({
    // files: ['...'],
});
```

### Via cli

```
test:browser [options] [specs...]

Options:
  -P, --port                 dev server port
  --watch                    watch test files
  --concurrency <number>     number of concurrent browsers
  --coverage                 add coverage to tests
  --manual                   manual test mode
  --open                     open the browser
  --saucelabs [browsers...]  run tests using Saucelabs browsers
  -h, --help                 display help for command
```

**Samples**

```sh
rna test:browser
```

```sh
rna test:browser 'test/**/*.spec.js' --coverage
```

```sh
rna test:browser 'test/elements.spec.js' --watch --open
```

---

## License

RNA Browser Test Runner is released under the [MIT](https://github.com/chialab/rna/blob/main/packages/rna-browser-test-runner/LICENSE) license.

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