From 45735c50655706be42250726e58599f49e853fbd Mon Sep 17 00:00:00 2001 From: Tian Feng Date: Fri, 23 Aug 2024 15:57:54 -0700 Subject: [PATCH 1/2] docs: Support sharding by scenario for playwright-cucumber --- .../automated-testing/cucumberjs-playwright/yaml.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md b/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md index 5c07cbf0e1..368b8cbd55 100644 --- a/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md +++ b/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md @@ -920,10 +920,14 @@ suites:

| OPTIONAL | STRING |

-When sharding is configured, `saucectl` automatically splits the tests (e.g., by spec or concurrency) so that they can easily run in parallel. -For sharding by concurrency, `saucectl` splits test files into several groups (the number of groups is determined by the concurrency setting). Each group will then run as an individual job. +When sharding is enabled, `saucectl` automatically distributes the tests (by spec, concurrency, or scenario) to run in parallel. -Selectable values: `spec` to shard by spec file, `concurrency` to shard by concurrency. Remove this field or leave it empty `""` for no sharding. +Selectable options: +- `spec`: Shards by spec file. `saucectl` starts a separate job for each spec file. +- `concurrency`: Shards by concurrency level. `saucectl` divides test files into multiple groups based on the specified concurrency setting. Each group runs as an individual job. +- `scenario`: Shards by scenario name. `saucectl` gathers scenario names from the test files and starts a job for each scenario name. Scenarios with the same name are grouped into a single job. + +To disable sharding, either remove this field or set it to `""`. ```yaml suites: From aa881a8b8db898f9578c37da832906f81c71ad66 Mon Sep 17 00:00:00 2001 From: Tian Feng Date: Fri, 23 Aug 2024 16:06:47 -0700 Subject: [PATCH 2/2] revise --- docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md b/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md index 368b8cbd55..0811724625 100644 --- a/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md +++ b/docs/web-apps/automated-testing/cucumberjs-playwright/yaml.md @@ -920,7 +920,7 @@ suites:

| OPTIONAL | STRING |

-When sharding is enabled, `saucectl` automatically distributes the tests (by spec, concurrency, or scenario) to run in parallel. +When sharding is enabled, `saucectl` automatically distributes the tests to run in parallel. Selectable options: - `spec`: Shards by spec file. `saucectl` starts a separate job for each spec file.