address CR

Author: kobenguyent

docs/configuration.md

@@ -45,6 +45,7 @@ export const config = {
 - `timeout` — default per-test timeout in seconds; a test is killed if it stops responding.
 - `mocha` — [Mocha options](https://mochajs.org/#configuring-mocha-nodejs), including extra reporters. See [Reporters](/reports).
 - `workerInitializationDelay` — delay in milliseconds between spinning up parallel workers to prevent CPU spikes and stagger browser startup. Defaults to `200`. Set to `0` to disable.
+- `workerInitializationMaxDelay` — maximum total delay (in milliseconds) for worker initialization staggering. Defaults to `10000` (10 s). Set to `0` to disable capping.
 
 **BDD**
 

lib/workers.js

@@ -512,15 +512,22 @@ class Workers extends EventEmitter {
       ? this.codecept.config.workerInitializationDelay 
       : 200
 
+    // Maximum total stagger window (default 10 seconds). Allows capping total delay regardless of worker count.
+    const maxStagger = this.codecept.config.workerInitializationMaxDelay ?? 10000
+    // Compute effective per-worker delay to keep total stagger within maxStagger.
+    const effectiveDelay = staggerDelay > 0
+      ? Math.min(staggerDelay, Math.floor(maxStagger / Math.max(1, this.workers.length - 1)))
+      : 0
+
     for (const worker of this.workers) {
       const workerThread = createWorker(worker, this.isPoolMode)
       this._listenWorkerEvents(workerThread)
       workerThreads.push(workerThread)
 
       // Stagger worker creation to prevent CPU spikes 
       // from massive V8 isolate creation and naturally stagger browser init
-      if (this.workers.length > 1 && staggerDelay > 0) {
-        await new Promise(resolve => setTimeout(resolve, staggerDelay))
+      if (this.workers.length > 1 && effectiveDelay > 0) {
+        await new Promise(resolve => setTimeout(resolve, effectiveDelay))
       }
     }