Skip to content
Endform logo Endform logo Endform docs

Requirements

Endform is a fully parallel, remote test runner. Each of your playwright tests will be run on a separate machine in the cloud.

Fully parallel

Section titled “Fully parallel”

All of your tests will run at the same time with endform, which means that your tests need to be completely independent of each other.

If you keep your tests decoupled from your application already by, for example, using apis to generate data, you are probably ready to use endform.

Remote

Section titled “Remote”

Since your tests will be running on remote machines, the servers you are testing against need to be accesible to the remote runners. There are two ways to acheive this:

  • You are running preview infrastructure or a testing environment that is exposed to the internet anyway.
  • You can use the endform-proxy-network addon to shuttle traffic between the remote runners and the machine your CLI runs on. Check out the guide on proxying traffic via your local network for more information about this approach.

Playwright Requirements

Section titled “Playwright Requirements”
  • We support playwright projects written in typescript and javascript.
  • The length of an individual test run is limited to 4 minutes (same as the testConfig.timeout option). The playwright default timeout is 30 seconds. This does not include retries.
  • We currently only support the latest minor version of playwright (1.53.0 at the time of writing).
  • We currently only support Chrome. We run the same version of Chrome as the playwright version you are running ships with. Let us know if you are in need of more browsers and we can prioritise this.

Playwright Configuration Options

Section titled “Playwright Configuration Options”

Endform tries to directly use or replicate all playwright configuration options. To understand how most of these options work, please refer to the Playwright documentation.

There are a few exceptions to this.

Options that we currently don’t support, but will do in the future (let us know and we will prioritize them):

  • forbidOnly
  • the on-all-retries, on-first-retry, retain-on-first-failure trace recording options. If you are using one of these, we will override the config to use retain-on-failure. off, on and retain-on-failure are our reccomended options for trace recording.

Options that aren’t supported since they don’t make sense in a remote context:

  • fullyParallel is always true, but you can limit concurrency using settings in the endform dashboard.

Node Requirements

Section titled “Node Requirements”
  • A version of Node.js that is more recent than the latest LTS version (Node 22+).
  • In the remote test environment, your tests will run on node lts.

Browser Requirements

Section titled “Browser Requirements”
  • We currently only support Chrome. We run the same version of Chrome as the playwright version you are running ships with.

Operating System Requirements

Section titled “Operating System Requirements”
  • We currently only support Linux and MacOS.