fix(setCommonPlugins): drop eachElement; use pauseOn instead of pauseOnFail

`eachElement` was removed from CodeceptJS 4.x — it lives on `codeceptjs/effects`
now and was never a plugin in 4.x. Stop adding it to `cfg.plugins`.

`pauseOnFail` is superseded by the `pauseOn` plugin (4.x), which supports
multiple modes (`fail`, `step`, `file`, `url`) controlled via `-p` args.
Register `pauseOn` instead so `-p pauseOn:fail`, `-p pauseOn:step`, etc.
work without config edits.

Tests updated.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: DavertMik

CHANGELOG.md

@@ -1,6 +1,10 @@
 4.0.0-beta.3
 
-* `setCommonPlugins` now registers `browser` and `aiTrace` as discoverable plugins (not enabled by default — activate via `-p <name>` on the CLI or `enabled: true` in user config). `tryTo`/`retryTo` are no longer added; in 4.x they are imported from `codeceptjs/effects`.
+* `setCommonPlugins` aligned with CodeceptJS 4.x plugin set:
+  * Replaces `pauseOnFail` with the newer `pauseOn` plugin (registered, not enabled — activate via `-p pauseOn:fail`, `-p pauseOn:step`, `-p pauseOn:url:...`).
+  * Adds `browser` and `aiTrace` as discoverable plugins (not enabled — activate via `-p browser:...` / `-p aiTrace`).
+  * Drops `eachElement` — removed from CodeceptJS 4.x; available as `eachElement` import from `codeceptjs/effects`.
+  * Drops `tryTo`/`retryTo` plugin entries — also moved to `codeceptjs/effects` in 4.x.
 
 4.0.0
 

README.md

@@ -78,16 +78,15 @@ These plugins will be loaded:
 **Enabled globally**
 
 * `retryFailedStep`
-* `eachElement`
 * `screenshotOnFail`
 
 **Registered but not enabled** — activate ad-hoc via `-p <name>` on the CLI, or by setting `enabled: true` in user config:
 
-* `pauseOnFail` — pause when a step fails (`-p pauseOnFail`)
+* `pauseOn` — pause on failure / step / file / URL (`-p pauseOn:fail`, `-p pauseOn:step`, `-p pauseOn:file:tests/login_test.js`, `-p pauseOn:url:/checkout/*`)
 * `browser` — override browser helper config from CLI (`-p browser:show`, `-p browser:browser=firefox`, etc.)
-* `aiTrace` — capture AI traces
+* `aiTrace` — capture AI traces (`-p aiTrace`)
 
-Note: in CodeceptJS 4.x, `tryTo` and `retryTo` are no longer plugins — import them from `codeceptjs/effects`.
+Note: in CodeceptJS 4.x, `tryTo` / `retryTo` / `eachElement` are no longer plugins — import them from `codeceptjs/effects`.
 
 ### setSharedCookies
 

hooks/setCommonPlugins.js

@@ -6,12 +6,11 @@ export default function () {
 
     // Enabled globally
     cfg.plugins.retryFailedStep = cfg.plugins.retryFailedStep || { enabled: true }
-    cfg.plugins.eachElement = cfg.plugins.eachElement || { enabled: true }
     cfg.plugins.screenshotOnFail = cfg.plugins.screenshotOnFail || {}
 
     // Registered but not enabled — activate via `-p <name>` on the CLI or by
     // setting `enabled: true` in user config.
-    cfg.plugins.pauseOnFail = cfg.plugins.pauseOnFail || {}
+    cfg.plugins.pauseOn = cfg.plugins.pauseOn || {}
     cfg.plugins.browser = cfg.plugins.browser || {}
     cfg.plugins.aiTrace = cfg.plugins.aiTrace || {}
   })

test/index.test.js

@@ -262,11 +262,13 @@ describe('Hooks tests', () => {
       Config.create(config)
       // enabled globally
       assert.ok(Config.get().plugins.screenshotOnFail)
-      assert.ok(Config.get().plugins.eachElement)
-      assert.equal(Config.get().plugins.eachElement.enabled, true)
       assert.equal(Config.get().plugins.retryFailedStep.enabled, true)
+      // removed in 4.x — must NOT be registered
+      assert.equal(Config.get().plugins.eachElement, undefined)
+      assert.equal(Config.get().plugins.pauseOnFail, undefined)
       // registered but not enabled
-      assert.ok(Config.get().plugins.pauseOnFail)
+      assert.ok(Config.get().plugins.pauseOn)
+      assert.equal(Config.get().plugins.pauseOn.enabled, undefined)
       assert.ok(Config.get().plugins.browser)
       assert.equal(Config.get().plugins.browser.enabled, undefined)
       assert.ok(Config.get().plugins.aiTrace)
@@ -280,7 +282,7 @@ describe('Hooks tests', () => {
       Config.create(config)
       assert.ok(Config.get().plugins.screenshotOnFail)
       assert.equal(Config.get().plugins.screenshotOnFail.enabled, false)
-      assert.ok(Config.get().plugins.eachElement)
+      assert.ok(Config.get().plugins.retryFailedStep)
       assert.ok(Config.get().plugins.otherPlugin)
     })
   })