Frontend testing

​

Prerequisites

• It is not recommended to run tests on your working project, since failed tests can leave behind empty pipelines, triggers, etc. Set up your development environment.
• Make sure user authentication is enabled.
• Make sure your development server is running.

​

Configuration

• Tests default to “fail” if a client error occurs. Add the following to the top of the test file to disable this check.

test.use({ failOnClientError: false });

• Certain setting features are enabled by default. Refer to base.ts for more information, and use the following snippet when needed.

test.use({ settingFeaturesToDisable: { [FeatureUUIDEnum.LOCAL_TIMEZONE]: true } });

​

Running the tests

You have the option to just run one specific test or all tests at once. There are several ways to run specific tests.

# Run everything, headless by default.
yarn test
# Run everything with a browser.
yarn test:h

# Run test files that have the word "pipelines" in their names.
yarn test pipelines

You can run the frontend tests using the CI/CD Playwright configuration with the following command:

yarn test:ci

​

Creating a test

Refer to the Playwright docs for examples on writing frontend tests.

​

Debugging

The easiest way to debug is to run tests in UI mode so you can see what went wrong.

yarn test --ui

# Or
yarn test:ci --ui

If you are running into issues with the app and would like to report it, you can tell us about it either on GitHub or Slack.