This action installs TestCafe from npm and runs tests.

- uses: actions/checkout@v1
- uses: DevExpress/testcafe-action@latest
  with:
    args: "chrome tests"

In this example, the checkout action checks out the repository, then testcafe-action installs the latest TestCafe version and runs tests from the tests folder in Google Chrome.

The args option specifies command line arguments passed to the testcafe command.

You can also use the version option to specify the TestCafe version to install.

Run the setup-node action before testcafe-action to install a specific Node.js version.

TestCafe command line arguments.

- uses: DevExpress/testcafe-action@latest
  with:
    args: "chrome fixture.js -s takeOnFails=true -q -c 3"

Optional

The TestCafe version to install.

- uses: DevExpress/testcafe-action@latest
  with:
    version: "1.6.0"
    args: "chrome tests"

The latest version is installed by default.

This section contains sample workflows that show how to use testcafe-action.

The following workflow demonstrates the basic usage of testcafe-action.

name: Basic TestCafe Workflow
on: [push]

jobs:
  build:
    name: Run TestCafe Tests
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v1
      - name: Install TestCafe from 'npm' and Run Tests
        uses: DevExpress/testcafe-action@latest
        with:
          args: "chrome my-fixture.js"

The checkout action checks out the repository. Then, testcafe-action installs TestCafe and runs my-fixture.js in Chrome.

This workflow is triggered when you push changes to the repository. The job runs on a Windows virtual machine.

The following workflow demonstrates how to run TestCafe tests across Node.js versions and operating systems.

name: Use Matrix Strategy to Test in Several Node.js Versions
on: [push]

jobs:
  build:
    name: Run Tests With Several Node.js Versions
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, windows-latest]
        node: [8, 10, 12]
    steps:
      - uses: actions/setup-node@v1
        with:
          node-version: ${{ matrix.node }}
      - uses: actions/checkout@v1
      - name: Run TestCafe Tests
        uses: DevExpress/testcafe-action@latest
        with:
          args: "chrome tests"

This job contains a matrix strategy that duplicates it to run on Windows and Ubuntu virtual machines in three Node.js versions (8, 10, and 12).

The setup-node action installs the Node.js version defined in the matrix. Then, checkout fetches the code and testcafe-action runs tests.