Skip to main content

Parallel Testing (Sharding)

Boost test suite efficiency with Argos Parallel Testing: Automate and streamline concurrent test executions across multiple environments effortlessly.


Argos seamlessly integrates with Playwright, offering out-of-the-box support for Playwright tests sharding. This means zero configuration hassle for you. For more details, refer to the Argos Playwright SDK.

Other SDKs

For environments beyond Playwright, Argos facilitates sharding through two key environment variables, simplifying the setup:

  • ARGOS_PARALLEL_TOTAL: Specifies the number of parallel nodes. It's crucial to ensure equal calls to Argos upload across these nodes.
  • ARGOS_PARALLEL_INDEX: Specifies the index of the current parallel node.
  • ARGOS_PARALLEL_NONCE: A unique identifier for each build. In most CI environments, Argos will automatically generate this for you.

Alternatively, use --parallel-nonce, --parallel-total and --parallel-index flags with the CLI or parallel: { nonce: string, total: number, index: number } within SDK options.

Implementing in GitHub Actions

Below is a practical example showcasing how to configure Argos sharding within a GitHub Actions workflow:

timeout-minutes: 60
runs-on: ubuntu-latest
fail-fast: false
shardIndex: [1, 2, 3, 4]
shardTotal: [4]
# ---
# Here you setup your repo and run your E2E tests
# ---
- name: Upload screenshots to Argos
ARGOS_PARALLEL_TOTAL: ${{ matrix.shardTotal }}
ARGOS_PARALLEL_INDEX: ${{ matrix.shardIndex }}
# ARGOS_PARALLEL_NONCE is automatically detected

run: npm exec -- argos upload --parallel ./screenshots