# @testcafe/testcafe

> Automated browser testing for the modern web development stack.

Latest version **1.0.0-alpha.1** (published 2018-12-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install @testcafe/testcafe
pnpm add @testcafe/testcafe
yarn add @testcafe/testcafe
bun add @testcafe/testcafe
```

Provides the command `testcafe`.

## Health

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

Positive: has types; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 1.0.0-alpha.1 |
| Published | 2018-12-28 |
| First published | 2018-12-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=6.0.0 |
| Dependencies | 71 |
| Unpacked size | 3.4 MB |
| Known vulnerabilities | 0 (+8 in 4 direct dependencies) |
| Install scripts | no |
| GitHub stars | 9892 |
| Author | Developer Express Inc. |
| Maintainers | belym.a.2105 |
| Keywords | automated, functional, browser, browsers, website, webapp, testing, automation, test, runner, tdd, assert, assertion, QA, ES6, ES2015, async, await |

## Links

- npm: https://www.npmjs.com/package/@testcafe/testcafe
- Repository: https://github.com/DevExpress/testcafe
- Homepage: https://devexpress.github.io/testcafe/
- Issues: https://github.com/DevExpress/testcafe/issues
- npm.io page: https://npm.io/package/@testcafe/testcafe

## Dependencies (71)

- [del](https://npm.io/package/del.md) ^3.0.0
- [tmp](https://npm.io/package/tmp.md) 0.0.28
- [chai](https://npm.io/package/chai.md) ^4.1.2
- [pify](https://npm.io/package/pify.md) ^2.3.0
- [chalk](https://npm.io/package/chalk.md) ^1.1.0
- [debug](https://npm.io/package/debug.md) ^2.2.0
- [is-ci](https://npm.io/package/is-ci.md) ^1.0.10
- [json5](https://npm.io/package/json5.md) ^2.1.0
- [pngjs](https://npm.io/package/pngjs.md) ^3.3.1
- [dedent](https://npm.io/package/dedent.md) ^0.4.0
- [globby](https://npm.io/package/globby.md) ^3.0.1
- [lodash](https://npm.io/package/lodash.md) ^4.17.10
- [moment](https://npm.io/package/moment.md) ^2.10.3
- [nanoid](https://npm.io/package/nanoid.md) ^1.0.1
- [parse5](https://npm.io/package/parse5.md) ^1.5.0
- [pinkie](https://npm.io/package/pinkie.md) ^2.0.4
- [is-glob](https://npm.io/package/is-glob.md) ^2.0.1
- [ps-node](https://npm.io/package/ps-node.md) ^0.1.6
- [callsite](https://npm.io/package/callsite.md) ^1.0.0
- [emittery](https://npm.io/package/emittery.md) ^0.4.1
- [make-dir](https://npm.io/package/make-dir.md) ^1.3.0
- [mustache](https://npm.io/package/mustache.md) ^2.1.2
- [commander](https://npm.io/package/commander.md) ^2.8.1
- [gulp-data](https://npm.io/package/gulp-data.md) ^1.3.1
- [is-stream](https://npm.io/package/is-stream.md) ^1.1.0
- [os-family](https://npm.io/package/os-family.md) ^1.0.0
- [strip-bom](https://npm.io/package/strip-bom.md) ^2.0.0
- [tree-kill](https://npm.io/package/tree-kill.md) ^1.1.0
- [useragent](https://npm.io/package/useragent.md) ^2.1.7
- [babel-core](https://npm.io/package/babel-core.md) ^6.22.1
- [replicator](https://npm.io/package/replicator.md) ^1.0.3
- [typescript](https://npm.io/package/typescript.md) ^2.2.2
- [graceful-fs](https://npm.io/package/graceful-fs.md) ^4.1.11
- [import-lazy](https://npm.io/package/import-lazy.md) ^3.1.0
- [map-reverse](https://npm.io/package/map-reverse.md) ^1.0.1
- [resolve-cwd](https://npm.io/package/resolve-cwd.md) ^1.0.0
- [coffeescript](https://npm.io/package/coffeescript.md) ^2.3.1
- [node-version](https://npm.io/package/node-version.md) ^1.0.0
- [resolve-from](https://npm.io/package/resolve-from.md) ^4.0.0
- [babel-runtime](https://npm.io/package/babel-runtime.md) ^6.22.0
- [indent-string](https://npm.io/package/indent-string.md) ^1.2.2
- [endpoint-utils](https://npm.io/package/endpoint-utils.md) ^1.0.2
- [async-exit-hook](https://npm.io/package/async-exit-hook.md) ^1.1.2
- [callsite-record](https://npm.io/package/callsite-record.md) ^4.0.0
- [elegant-spinner](https://npm.io/package/elegant-spinner.md) ^1.0.1
- [promisify-event](https://npm.io/package/promisify-event.md) ^1.0.0
- [qrcode-terminal](https://npm.io/package/qrcode-terminal.md) ^0.10.0
- [babel-preset-env](https://npm.io/package/babel-preset-env.md) ^1.1.8
- [babel-preset-flow](https://npm.io/package/babel-preset-flow.md) ^6.23.0
- [sanitize-filename](https://npm.io/package/sanitize-filename.md) ^1.6.0
- [error-stack-parser](https://npm.io/package/error-stack-parser.md) ^1.3.6
- [read-file-relative](https://npm.io/package/read-file-relative.md) ^1.2.0
- [source-map-support](https://npm.io/package/source-map-support.md) ^0.5.5
- [time-limit-promise](https://npm.io/package/time-limit-promise.md) ^1.0.2
- [bin-v8-flags-filter](https://npm.io/package/bin-v8-flags-filter.md) ^1.1.2
- [testcafe-hammerhead](https://npm.io/package/testcafe-hammerhead.md) 14.4.8
- [testcafe-legacy-api](https://npm.io/package/testcafe-legacy-api.md) 3.1.9
- [babel-preset-stage-2](https://npm.io/package/babel-preset-stage-2.md) ^6.22.0
- [log-update-async-hook](https://npm.io/package/log-update-async-hook.md) ^2.0.2
- [testcafe-browser-tools](https://npm.io/package/testcafe-browser-tools.md) 1.6.5
- [testcafe-reporter-json](https://npm.io/package/testcafe-reporter-json.md) ^2.1.0
- [testcafe-reporter-list](https://npm.io/package/testcafe-reporter-list.md) ^2.1.0
- [testcafe-reporter-spec](https://npm.io/package/testcafe-reporter-spec.md) ^2.1.1
- [chrome-remote-interface](https://npm.io/package/chrome-remote-interface.md) ^0.25.3
- [testcafe-reporter-xunit](https://npm.io/package/testcafe-reporter-xunit.md) ^2.1.0
- [testcafe-reporter-minimal](https://npm.io/package/testcafe-reporter-minimal.md) ^2.1.0
- [chrome-emulated-devices-list](https://npm.io/package/chrome-emulated-devices-list.md) ^0.1.0
- [babel-plugin-transform-runtime](https://npm.io/package/babel-plugin-transform-runtime.md) ^6.22.0
- [moment-duration-format-commonjs](https://npm.io/package/moment-duration-format-commonjs.md) ^1.0.0
- [babel-plugin-transform-for-of-as-array](https://npm.io/package/babel-plugin-transform-for-of-as-array.md) ^1.1.1
- [babel-plugin-transform-class-properties](https://npm.io/package/babel-plugin-transform-class-properties.md) ^6.24.1

## 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

- 1.0.0-alpha.1 (latest) — 2018-12-28

## README

<h1 align="center">
    <a href="https://devexpress.github.io/testcafe">
        <img src="https://raw.githubusercontent.com/DevExpress/testcafe/master/media/testcafe-logo.svg?sanitize=true" alt="testcafe" />
    </a>
</h1>

<p align="center">
<a href="https://ci.appveyor.com/project/DevExpress/testcafe"><img alt="Functional Windows desktop" src="https://ci.appveyor.com/api/projects/status/ftelkyuiji8lyadf?svg=true"></a>
<a href="https://travis-ci.org/DevExpress/testcafe"><img alt="All Travis tasks (server, client, functional: mobile, macOS, Edge)" src="https://travis-ci.org/DevExpress/testcafe.svg"></a>
<a href="https://www.npmjs.com/package/testcafe"><img alt="NPM Version" src="https://img.shields.io/npm/v/testcafe.svg" data-canonical-src="https://img.shields.io/npm/v/testcafe.svg" style="max-width:100%;"></a>
</p>

<p align="center">
<i>A Node.js tool to automate end-to-end web testing.<br/>Write tests in JS or TypeScript, run them and view results.</i>
</p>

<p align="center">
<a href="https://devexpress.github.io/testcafe">https://devexpress.github.io/testcafe</a>
</p>

----

* **Works on all popular environments**: TestCafe runs on Windows, MacOS, and Linux. It supports desktop, mobile, remote and cloud [browsers](https://devexpress.github.io/testcafe/documentation/using-testcafe/common-concepts/browsers/browser-support.html) (UI or headless).
* **1 minute to set up**: You [do not need WebDriver](https://devexpress.github.io/testcafe/faq/#i-have-heard-that-testcafe-does-not-use-selenium-how-does-it-operate) or any other testing software. Install TestCafe with one command, and you are ready to test: `npm install -g testcafe`
* **Free and open source**: TestCafe is free to use under the [MIT license](https://github.com/DevExpress/testcafe/blob/master/LICENSE). [Plugins](#plugins) provide custom reports, integration with other tools, launching tests from IDE, etc. You can use the plugins made by the GitHub community or make your own.

![Install TestCafe and Run a Test](https://raw.githubusercontent.com/DevExpress/testcafe/master/media/install-and-run-test.gif)

<p align="center">
<i>Running a sample test in Safari</i>
</p>

## Table of contents

* [Features](#features)
* [IDE for End-to-End Web Testing](#ide-for-end-to-end-web-testing)
* [Getting Started](#getting-started)
* [Documentation](#documentation)
* [Get Help](#get-help)
* [Issue Tracker](#issue-tracker)
* [Stay in Touch](#stay-in-touch)
* [Contributing](#contributing)
* [Plugins](#plugins)
* [Different Versions of TestCafe](#different-versions-of-testcafe)
* [Badge](#badge)
* [License](#license)
* [Creators](#creators)

## Features

**Stable tests and no manual timeouts**<br/>
TestCafe automatically waits for page loads and XHRs before the test starts and after each action.
It also features smart test actions and assertions that wait for page elements to appear.
You can change the maximum wait time.
If elements load faster, tests skip the timeout and continue.

**Rapid test development tool**<br/>
Changes in test code immediately restart the test, and you see the results instantly.<br/>
See how it works in the [TestCafe Live repository](https://github.com/DevExpress/testcafe-live).

**Latest JS and TypeScript support**<br/>
TestCafe supports the latest JavaScript features, including ES2017 (for example, async/await).
You can also [use TypeScript](https://devexpress.github.io/testcafe/documentation/test-api/typescript-support.html)
if you prefer a strongly typed language.

**Detects JS errors in your code**<br/>
TestCafe reports JS errors that it finds on the webpage.
Tests automatically fail because of that.
However, you can disable this.

**Concurrent tests launch**<br/>
TestCafe can open multiple instances of the same browser to run parallel
tests which decreases test execution time.

**PageObject pattern support**<br/>
The TestCafe's [Test API](https://devexpress.github.io/testcafe/documentation/test-api/)
includes a high-level selector library, assertions, etc.
You can combine them to implement readable tests with the [PageObject pattern](https://devexpress.github.io/testcafe/documentation/recipes/using-page-model.html).

```js
const macOSInput = Selector('.column').find('label').withText('MacOS').child('input');
```

**Easy to include in a continuous integration system**<br/>
You can run TestCafe from a console, and its reports can be viewed in a CI system's interface
(TeamCity, Jenkins, Travis & etc.)

## IDE for End-to-End Web Testing

We've got one more tool for you!

Check out [TestCafe Studio](https://testcafe-studio.devexpress.com): all the perks of TestCafe + GUI + Visual Test Recorder

![Get Started with TestCafe Studio](https://raw.githubusercontent.com/DevExpress/testcafe/master/media/testcafe-studio-get-started.gif)

<p align="center">
<i>Record and Run a Test in TestCafe Studio</i>
</p>

## Getting Started

### Installation

Ensure that [Node.js](https://nodejs.org/) (version 6 or newer) and [npm](https://www.npmjs.com/) are installed on your computer before running it:

```sh
npm install -g testcafe
```

### Creating the Test

As an example, we are going to test the [https://devexpress.github.io/testcafe/example](https://devexpress.github.io/testcafe/example) page.

Create a `.js` or `.ts` file on your computer.
Note that it needs to have a specific structure: tests must be organized into fixtures.
You can paste the following code to see the test in action:

```js
import { Selector } from 'testcafe'; // first import testcafe selectors

fixture `Getting Started`// declare the fixture
    .page `https://devexpress.github.io/testcafe/example`;  // specify the start page


//then create a test and place your code there
test('My first test', async t => {
    await t
        .typeText('#developer-name', 'John Smith')
        .click('#submit-button')

        // Use the assertion to check if the actual header text is equal to the expected one
        .expect(Selector('#article-header').innerText).eql('Thank you, John Smith!');
});
```

### Running the Test

Call the following command in a command shell.
Specify the [target browser](https://devexpress.github.io/testcafe/documentation/using-testcafe/command-line-interface.html#browser-list)
and [file path](https://devexpress.github.io/testcafe/documentation/using-testcafe/command-line-interface.html#file-pathglob-pattern).

```sh
testcafe chrome test1.js
```

TestCafe opens the browser and starts executing the test.

> Important! Make sure to stay in the browser tab that is running tests.
> Do not minimize the browser window. Tests are not guaranteed to execute correctly
> in inactive tabs and minimized browser windows because they switch to a lower resource consumption mode.

### Viewing the Results

TestCafe outputs the results into a command shell by default. See [Reporters](https://devexpress.github.io/testcafe/documentation/using-testcafe/common-concepts/reporters.html)
for more information. You can also use [plugins](#plugins) to customize the reports.

![Test Report](docs/articles/images/report.png)

Read the [Getting Started](https://devexpress.github.io/testcafe/documentation/getting-started/) page for a more detailed guide.

## Documentation

Go to our website for full [documentation](https://devexpress.github.io/testcafe/documentation/getting-started/) on TestCafe.

## Get Help

Join the TestCafe community on Stack Overflow to get help. Ask and answer [questions with the TestCafe tag](https://stackoverflow.com/questions/tagged/testcafe).

## Issue Tracker

Use our GitHub issues page to [report bugs](https://github.com/DevExpress/testcafe/issues/new?template=bug-report.md) and [suggest improvements](https://github.com/DevExpress/testcafe/issues/new?template=feature_request.md).

## Stay in Touch

Follow us on [Twitter](https://twitter.com/DXTestCafe). We post TestCafe news and updates, several times a week.

## Contributing

Read our [Contributing Guide](https://github.com/DevExpress/testcafe/blob/master/CONTRIBUTING.md) to learn how to contribute to the project.

To create your own plugin for TestCafe, you can use these plugin generators:

* [Build a browser provider](https://devexpress.github.io/testcafe/documentation/extending-testcafe/browser-provider-plugin/)
  to set up tests on your on-premises server farm, to use a cloud testing platform, or to start your local browsers in a special way. Use this [Yeoman generator](https://www.npmjs.com/package/generator-testcafe-browser-provider) to write only a few lines of code.
* To [build a custom reporter](https://devexpress.github.io/testcafe/documentation/extending-testcafe/reporter-plugin/)
  with your formatting and style, check out this [generator](https://www.npmjs.com/package/generator-testcafe-reporter).

If you want your plugin to be listed below, [send us a note in a Github issue](https://github.com/DevExpress/testcafe/issues/new).

Thank you to all the people who already contributed to TestCafe!

[<img alt="Farfurix" src="https://avatars2.githubusercontent.com/u/30019338?v=4&s=117" width="117">](https://github.com/Farfurix) |[<img alt="aleks-pro" src="https://avatars1.githubusercontent.com/u/14822473?v=4&s=117" width="117">](https://github.com/aleks-pro) |[<img alt="ericyd" src="https://avatars2.githubusercontent.com/u/8379268?v=4&s=117" width="117">](https://github.com/ericyd) |[<img alt="NickCis" src="https://avatars0.githubusercontent.com/u/174561?v=4&s=117" width="117">](https://github.com/NickCis) |[<img alt="andrewbranch" src="https://avatars0.githubusercontent.com/u/3277153?v=4&s=117" width="117">](https://github.com/andrewbranch) |[<img alt="radarhere" src="https://avatars2.githubusercontent.com/u/3112309?v=4&s=117" width="117">](https://github.com/radarhere) |
:---: |:---: |:---: |:---: |:---: |:---: |
[Farfurix](https://github.com/Farfurix) |[aleks-pro](https://github.com/aleks-pro) |[ericyd](https://github.com/ericyd) |[NickCis](https://github.com/NickCis) |[andrewbranch](https://github.com/andrewbranch) |[radarhere](https://github.com/radarhere) |

[<img alt="ai" src="https://avatars1.githubusercontent.com/u/19343?v=4&s=117" width="117">](https://github.com/ai) |[<img alt="lzxb" src="https://avatars0.githubusercontent.com/u/8424643?v=4&s=117" width="117">](https://github.com/lzxb) |[<img alt="arubtsov" src="https://avatars0.githubusercontent.com/u/10169557?v=4&s=117" width="117">](https://github.com/arubtsov) |[<img alt="caseyWebb" src="https://avatars3.githubusercontent.com/u/5419074?v=4&s=117" width="117">](https://github.com/caseyWebb) |[<img alt="smockle" src="https://avatars1.githubusercontent.com/u/3104489?v=4&s=117" width="117">](https://github.com/smockle) |[<img alt="beyondcompute" src="https://avatars0.githubusercontent.com/u/248055?v=4&s=117" width="117">](https://github.com/beyondcompute) |
:---: |:---: |:---: |:---: |:---: |:---: |
[ai](https://github.com/ai) |[lzxb](https://github.com/lzxb) |[arubtsov](https://github.com/arubtsov) |[caseyWebb](https://github.com/caseyWebb) |[smockle](https://github.com/smockle) |[beyondcompute](https://github.com/beyondcompute) |

[<img alt="GeoffreyBooth" src="https://avatars2.githubusercontent.com/u/456802?v=4&s=117" width="117">](https://github.com/GeoffreyBooth) |[<img alt="mcjim" src="https://avatars0.githubusercontent.com/u/485440?v=4&s=117" width="117">](https://github.com/mcjim) |[<img alt="MatthewNielsen27" src="https://avatars2.githubusercontent.com/u/35040439?v=4&s=117" width="117">](https://github.com/MatthewNielsen27) |[<img alt="renancouto" src="https://avatars0.githubusercontent.com/u/230893?v=4&s=117" width="117">](https://github.com/renancouto) |[<img alt="sgrillon14" src="https://avatars0.githubusercontent.com/u/5530550?v=4&s=117" width="117">](https://github.com/sgrillon14) |[<img alt="varunkumar" src="https://avatars1.githubusercontent.com/u/509433?v=4&s=117" width="117">](https://github.com/varunkumar) |
:---: |:---: |:---: |:---: |:---: |:---: |
[GeoffreyBooth](https://github.com/GeoffreyBooth) |[mcjim](https://github.com/mcjim) |[MatthewNielsen27](https://github.com/MatthewNielsen27) |[renancouto](https://github.com/renancouto) |[sgrillon14](https://github.com/sgrillon14) |[varunkumar](https://github.com/varunkumar) |

[<img alt="theghostbel" src="https://avatars2.githubusercontent.com/u/482899?v=4&s=117" width="117">](https://github.com/theghostbel) |[<img alt="aha-oretama" src="https://avatars0.githubusercontent.com/u/7259161?v=4&s=117" width="117">](https://github.com/aha-oretama) |[<img alt="bsmithb2" src="https://avatars2.githubusercontent.com/u/1773789?v=4&s=117" width="117">](https://github.com/bsmithb2) |[<img alt="link89" src="https://avatars2.githubusercontent.com/u/3314130?v=4&s=117" width="117">](https://github.com/link89) |[<img alt="murajun1978" src="https://avatars3.githubusercontent.com/u/911903?v=4&s=117" width="117">](https://github.com/murajun1978) |[<img alt="pietrovich" src="https://avatars2.githubusercontent.com/u/1728613?v=4&s=117" width="117">](https://github.com/pietrovich) |
:---: |:---: |:---: |:---: |:---: |:---: |
[theghostbel](https://github.com/theghostbel) |[aha-oretama](https://github.com/aha-oretama) |[bsmithb2](https://github.com/bsmithb2) |[link89](https://github.com/link89) |[murajun1978](https://github.com/murajun1978) |[pietrovich](https://github.com/pietrovich) |

[<img alt="VasilyStrelyaev" src="https://avatars1.githubusercontent.com/u/11459924?v=4&s=117" width="117">](https://github.com/VasilyStrelyaev) |[<img alt="AndreyBelym" src="https://avatars1.githubusercontent.com/u/4479386?v=4&s=117" width="117">](https://github.com/AndreyBelym) |[<img alt="inikulin" src="https://avatars1.githubusercontent.com/u/453071?v=4&s=117" width="117">](https://github.com/inikulin) |[<img alt="helen-dikareva" src="https://avatars1.githubusercontent.com/u/12034551?v=4&s=117" width="117">](https://github.com/helen-dikareva) |[<img alt="miherlosev" src="https://avatars2.githubusercontent.com/u/4133518?v=4&s=117" width="117">](https://github.com/miherlosev) |[<img alt="AlexKamaev" src="https://avatars3.githubusercontent.com/u/1678902?v=4&s=117" width="117">](https://github.com/AlexKamaev) |
:---: |:---: |:---: |:---: |:---: |:---: |
[VasilyStrelyaev](https://github.com/VasilyStrelyaev) |[AndreyBelym](https://github.com/AndreyBelym) |[inikulin](https://github.com/inikulin) |[helen-dikareva](https://github.com/helen-dikareva) |[miherlosev](https://github.com/miherlosev) |[AlexKamaev](https://github.com/AlexKamaev) |

[<img alt="MargaritaLoseva" src="https://avatars2.githubusercontent.com/u/12034505?v=4&s=117" width="117">](https://github.com/MargaritaLoseva) |[<img alt="churkin" src="https://avatars3.githubusercontent.com/u/5182202?v=4&s=117" width="117">](https://github.com/churkin) |[<img alt="LavrovArtem" src="https://avatars2.githubusercontent.com/u/5373460?v=4&s=117" width="117">](https://github.com/LavrovArtem) |[<img alt="kirovboris" src="https://avatars0.githubusercontent.com/u/3633477?v=4&s=117" width="117">](https://github.com/kirovboris) |[<img alt="AlexSkorkin" src="https://avatars3.githubusercontent.com/u/995726?v=4&s=117" width="117">](https://github.com/AlexSkorkin) |[<img alt="Nuarat" src="https://avatars0.githubusercontent.com/u/11683678?v=4&s=117" width="117">](https://github.com/Nuarat) |
:---: |:---: |:---: |:---: |:---: |:---: |
[MargaritaLoseva](https://github.com/MargaritaLoseva) |[churkin](https://github.com/churkin) |[LavrovArtem](https://github.com/LavrovArtem) |[kirovboris](https://github.com/kirovboris) |[AlexSkorkin](https://github.com/AlexSkorkin) |[Nuarat](https://github.com/Nuarat) |

[<img alt="superroma" src="https://avatars0.githubusercontent.com/u/8553464?v=4&s=117" width="117">](https://github.com/superroma) |[<img alt="AndyWendt" src="https://avatars0.githubusercontent.com/u/6130713?v=4&s=117" width="117">](https://github.com/AndyWendt) |
:---: |:---: |
[superroma](https://github.com/superroma) |[AndyWendt](https://github.com/AndyWendt) |

## Plugins

TestCafe developers and community members made these plugins:

* **Rapid test development tool**<br/>
  Changes in test code immediately restart the test, and you see the results instantly.
  * [TestCafe Live](https://github.com/DevExpress/testcafe-live) (by [@DevExpress](https://github.com/DevExpress))

* **Browser Providers**<br/>
  Allow you to use TestCafe with cloud browser providers and emulators.
  * [SauceLabs provider](https://github.com/DevExpress/testcafe-browser-provider-saucelabs) (by [@AndreyBelym](https://github.com/AndreyBelym))
  * [BrowserStack provider](https://github.com/DevExpress/testcafe-browser-provider-browserstack) (by [@AndreyBelym](https://github.com/AndreyBelym))
  * [CrossBrowserTesting provider](https://github.com/sijosyn/testcafe-browser-provider-crossbrowsertesting) (by [@sijosyn](https://github.com/sijosyn))
  * [Nightmare headless provider](https://github.com/ryx/testcafe-browser-provider-nightmare) (by [@ryx](https://github.com/ryx))
  * [fbsimctl iOS emulator](https://github.com/Ents24/testcafe-browser-provider-fbsimctl) (by [@ents24](https://github.com/Ents24))
  * [Electron](https://github.com/DevExpress/testcafe-browser-provider-electron) (by [@AndreyBelym](https://github.com/AndreyBelym))
  * [Puppeteer](https://github.com/jdobosz/testcafe-browser-provider-puppeteer) (by [@jdobosz](https://github.com/jdobosz))

* **Framework-Specific Selectors**<br/>
  Work with page elements in a way that is native to your framework.
  * [React](https://github.com/DevExpress/testcafe-react-selectors) (by [@kirovboris](https://github.com/kirovboris))
  * [Angular](https://github.com/DevExpress/testcafe-angular-selectors) (by [@miherlosev](https://github.com/miherlosev))
  * [Vue](https://github.com/devexpress/testcafe-vue-selectors) (by [@miherlosev](https://github.com/miherlosev))
  * [Aurelia](https://github.com/miherlosev/testcafe-aurelia-selectors) (by [@miherlosev](https://github.com/miherlosev))

* **Plugins for Task Runners**<br/>
  Integrate TestCafe into your project's workflow.
  * [Grunt](https://github.com/crudo/grunt-testcafe) (by [@crudo](https://github.com/crudo))
  * [Gulp](https://github.com/DevExpress/gulp-testcafe) (by [@inikulin](https://github.com/inikulin))

* **Custom Reporters**<br/>
  View test results in different formats.
  * [TeamCity](https://github.com/Soluto/testcafe-reporter-teamcity) (by [@nirsky](https://github.com/nirsky))
  * [Slack](https://github.com/Shafied/testcafe-reporter-slack) (by [@Shafied](https://github.com/Shafied))
  * [NUnit](https://github.com/AndreyBelym/testcafe-reporter-nunit) (by [@AndreyBelym](https://github.com/AndreyBelym))
  * [TimeCafe](https://github.com/jimthedev/timecafe) (by [@jimthedev](https://github.com/jimthedev))

* **Test Accessibility**<br/>
  Find accessibility issues in your web app.
  * [axe-testcafe](https://github.com/helen-dikareva/axe-testcafe) (by [@helen-dikareva](https://github.com/helen-dikareva))

* **IDE Plugins**<br/>
  Run tests and view results from your favorite IDE.
  * [Visual Studio Code](https://github.com/romanresh/vscode-testcafe) (by [@romanresh](https://github.com/romanresh))
  * [SublimeText](https://github.com/churkin/testcafe-sublimetext) (by [@churkin](https://github.com/churkin))

* **ESLint**<br/>
  Use ESLint when writing and editing TestCafe tests.
  * [ESLint plugin](https://github.com/miherlosev/eslint-plugin-testcafe) (by [@miherlosev](https://github.com/miherlosev))
  
## Different Versions of TestCafe

There is a line of products called `TestCafe`. Below are the similarities and key differences between them.

* All three versions share the same core features:
  * No need for WebDriver, browser plugins or other tools.
  * Cross-platform and cross-browser out of the box.

* [**TestCafe**](https://testcafe.devexpress.com/)<br/>
  *first released in 2013, commercial web application*
  * Visual Test Recorder and web GUI to create, edit and run tests.
  * You can record tests or edit them as JavaScript code.

* [**TestCafe**](https://devexpress.github.io/testcafe) - you are here<br/>
  *first released in 2016, free and open-source node.js application*
  * You can write tests in the latest JavaScript or TypeScript.
  * Clearer and more flexible [API](https://devexpress.github.io/testcafe/documentation/test-api/) supports ES6 and [PageModel pattern](https://devexpress.github.io/testcafe/documentation/recipes/using-page-model.html).
  * More stable tests due to the [Smart Assertion Query Mechanism](https://devexpress.github.io/testcafe/documentation/test-api/assertions/#smart-assertion-query-mechanism).
  * Tests run faster due to improved [Automatic Waiting Mechanism](https://devexpress.github.io/testcafe/documentation/test-api/waiting-for-page-elements-to-appear.html) and [Concurrent Test Execution](https://devexpress.github.io/testcafe/documentation/using-testcafe/common-concepts/concurrent-test-execution.html).
  * Easy integration: it is a node.js solution with CLI and reporters for popular CI systems.
  * You can extend it with [plugins](#plugins) and other Node.js modules.

* [**TestCafe Studio**](https://testcafe-studio.devexpress.com/)<br/>
  *Preview released in 2018, commercial desktop application*
  * Based on the open-source TestCafe, and supports its major features.
  * You can record tests or edit them as JavaScript or TypeScript code.
  * New [Visual Test Recorder](https://testcafe-studio.devexpress.com/documentation/guides/record-tests/) and [IDE-like GUI](https://testcafe-studio.devexpress.com/documentation/guides/write-test-code.html) to record, edit, run and debug tests.
  * Currently available as a free preview version. The release version will replace the 2013 version of TestCafe.

## Badge

Show everyone you are using TestCafe: ![Tested with TestCafe](https://img.shields.io/badge/tested%20with-TestCafe-2fa4cf.svg)

To display this badge, add the following code to your repository readme:

```html
<a href="https://github.com/DevExpress/testcafe">
    <img alt="Tested with TestCafe" src="https://img.shields.io/badge/tested%20with-TestCafe-2fa4cf.svg">
</a>
```

## Thanks to BrowserStack

We are grateful to BrowserStack for providing the infrastructure that we use to test code in this repository.

<a href="https://www.browserstack.com/"><img alt="BrowserStack Logo" src="https://raw.github.com/DevExpress/testcafe/master/media/BrowserStack.png"/></a>

## License

Code released under the [MIT license](LICENSE).

## Creators

Developer Express Inc. ([https://devexpress.com](https://devexpress.com))

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