# @chialab/rna-saucelabs-test-runner

> A test runner for Saucelabs 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-saucelabs-test-runner
pnpm add @chialab/rna-saucelabs-test-runner
yarn add @chialab/rna-saucelabs-test-runner
bun add @chialab/rna-saucelabs-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-05-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18 |
| Dependencies | 4 |
| Unpacked size | 15.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 183 |
| Author | Chialab |
| Maintainers | chialab-admin, chialab-developers |
| Keywords | test-runner, webapp, saucelabs, unit, testing |

## Links

- npm: https://www.npmjs.com/package/@chialab/rna-saucelabs-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-saucelabs-test-runner

## Dependencies (4)

- [@chialab/node-resolve](https://npm.io/package/@chialab/node-resolve.md) ^0.18.0
- [@chialab/wds-plugin-legacy](https://npm.io/package/@chialab/wds-plugin-legacy.md) ^0.18.0
- [@web/test-runner-saucelabs](https://npm.io/package/@web/test-runner-saucelabs.md) ^0.11.0
- [@chialab/rna-browser-test-runner](https://npm.io/package/@chialab/rna-browser-test-runner.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.18.0-alpha.0 — 2023-05-01
- 0.17.1 — 2022-08-23
- 0.17.0 — 2022-08-23
- 0.16.2 — 2022-07-10
- 0.16.1 — 2022-07-07
- 0.16.0 — 2022-06-08
- 0.15.37 — 2022-05-26
- 0.15.36 — 2022-05-24
- 0.15.35 — 2022-05-19
- 0.15.34 — 2022-05-19
- 0.15.33 — 2022-05-16
- 0.15.32 — 2022-05-12
- … 161 more at https://npm.io/package/@chialab/rna-saucelabs-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 Saucelabs Test Runner</strong> • A test runner for Saucelabs 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-saucelabs-test-runner"><img alt="NPM" src="https://img.shields.io/npm/v/@chialab/rna-saucelabs-test-runner.svg?style=flat-square"></a>
</p>

---

## Install

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

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

## Usage

Start a saucelabs [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-saucelabs-test-runner';

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

### Via cli

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

Options:
  -P, --port                 dev server port
  --browsers [browsers...]   saucelabs browsers list
  --watch                    watch test files
  --concurrency <number>     number of concurrent browsers
  --coverage                 add coverage to tests
  --manual                   manual test mode
  --open                     open the browser
  -U, --user                 sauce username
  -K, --key                  sauce access key
  -h, --help                 display help for command
```

**Samples**

```sh
rna test:saucelabs
```

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

```sh
rna test:saucelabs 'test/elements.spec.js' --browsers 'ie 11' 'chrome 60' 'ios 10.3'
```

---

## License

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

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