Reporting in CI
Playwright Sharding and reporting the results to Currents
Last updated
Was this helpful?
Playwright Sharding and reporting the results to Currents
Last updated
Was this helpful?
By default, Playwright runs the test files in parallel using several worker processes that run on the same machine (see Playwright docs). In addition to machine-level parallelization with workers, you can split the spec files between multiple machines using sharding.
As mentioned, Playwright runs test files in parallel by default, but you can scale this behaviour by running tests on multiple machines simultaneously. This is called sharding in Playwright.
This behaviour is activated by using the --shard flag. For example:
Currents collects test results across different machines + workers and presents them in the cloud dashboard, using CI Build ID to assign the results to a build/run.
Running Playwright tests with sharding enabled on localhost requires running two or more playwright commands with the --shard flag and the same CI Build ID.
Open two separate terminals and run an identical pwc command with --shard=1/2 and --shard=2/2 flag respectively and --ci-build-id flag with identical values in both terminals. In the example below we use a dummy CI build ID ciid, you can replace it with any value as long as it's the same.
You will see that two shards are executing different spec files and running in parallel as well as the amount of workers executing tests on each one of the shards.
You don't need to split files manually when using Currents - Playwright does that for you automatically and distributes the spec files between Playwright shards and workers.
By default, Playwright runs test files in alphabetical order and distributes the files between shards and workers on each shard. You can use some naming convention to control the test order, for example:
001-user-signin-flow.spec.ts
002-create-new-document.spec.ts
and so on.
In addition, you can enable Fully Parallel Mode in a single file, so Playwright will split individual tests instead of test files.
Any CI provider or tool that allows creating multiple containers/jobs can be integrated with Currents for running Playwright sharding.
Here are a few example setups for popular CI providers:
