codeceptjs 4.2.1-beta.2 → 4.2.1

package/docs/helpers/Appium.md

@@ -256,6 +256,10 @@ I.dontSee('#add-to-cart-btn');
 
 Returns **void** automatically synchronized promise through #recorder
 
+### capabilities
+
+Type: CodeceptJS.HelperCapabilities
+
 ### checkIfAppIsInstalled
 
 Returns app installation status.

package/docs/helpers/Kitesurf.md

@@ -79,7 +79,7 @@ Type: [object][4]
 *   `apiBase` **[string][3]?** Cloudflare API base URL
 *   `input` **[string][3]?** how actions are dispatched: `cdp` (real mouse and keyboard events) or `synthetic` (DOM events).
 *   `capabilities` **[object][4]?** browser capabilities; Kitesurf sets `{ layout: 'real', screenshot: true }`.
-*   `xpathPolyfill` **([string][3] | [boolean][17])?** inject an XPath polyfill for browsers with incomplete XPath support. `auto` detects when it is needed.
+*   `xpathPolyfill` **([string][3] | [boolean][18])?** inject an XPath polyfill for browsers with incomplete XPath support. `auto` detects when it is needed.
 *   `waitForTimeout` **[number][8]?** default timeout for wait* actions, in seconds.
 *   `waitForAction` **[number][8]?** fixed delay after each action, in milliseconds. When unset, actions wait only for the navigation they trigger.
 *   `pollInterval` **[number][8]?** interval between checks while waiting, in milliseconds.
@@ -190,6 +190,10 @@ I.dontSee('#add-to-cart-btn');
 
 Returns **void** automatically synchronized promise through #recorder
 
+### capabilities
+
+Type: CodeceptJS.HelperCapabilities
+
 ### checkOption
 
 Selects a checkbox or radio button.
@@ -683,6 +687,22 @@ I.forceClick({css: 'nav a.login'});
 
 Returns **void** automatically synchronized promise through #recorder
 
+### grabAriaSnapshot
+
+Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+The format matches Playwright's [ARIA snapshots][14].
+
+```js
+const snapshot = await I.grabAriaSnapshot();
+const formSnapshot = await I.grabAriaSnapshot('#login-form');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator. Defaults to body element. 
+
+Returns **[Promise][12]<[string][3]>** YAML representation of the accessibility tree
+
 ### grabAttributeFrom
 
 Retrieves an attribute from an element located by CSS or XPath and returns it to test.
@@ -714,7 +734,7 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 *   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 *   `attr` **[string][3]** attribute name.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** attribute value
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
 
 ### grabCookie
 
@@ -742,7 +762,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let cookies = await I.grabCookies();
 ```
 
-Returns **[Promise][12]<[Array][14]<CodeceptJS.Cookie>>** array of cookie objects.
+Returns **[Promise][12]<[Array][15]<CodeceptJS.Cookie>>** array of cookie objects.
 
 ### grabCssPropertyFrom
 
@@ -775,7 +795,7 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 *   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 *   `cssProperty` **[string][3]** CSS property name.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** CSS value
+Returns **[Promise][12]<[Array][15]<[string][3]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -835,7 +855,7 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 *   `locator` &#x20;
 *   `element` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** HTML code for an element
+Returns **[Promise][12]<[Array][15]<[string][3]>>** HTML code for an element
 
 ### grabNumberOfElements
 
@@ -889,7 +909,7 @@ expect(traffics[0].response.status).to.equal(200);
 expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
 ```
 
-Returns **[Array][14]** recorded network traffics
+Returns **[Array][15]** recorded network traffics
 
 ### grabSource
 
@@ -932,7 +952,7 @@ let pins = await I.grabTextFromAll('#pin li');
 
 *   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** attribute value
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
 
 ### grabTitle
 
@@ -974,7 +994,7 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 *   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** attribute value
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
 
 ### grabWebElement
 
@@ -1017,7 +1037,7 @@ I.pressKey(['Control', 'a']);
 
 #### Parameters
 
-*   `key` **([string][3] | [Array][14]<[string][3]>)** a key or an array of keys to combine (modifiers first).
+*   `key` **([string][3] | [Array][15]<[string][3]>)** a key or an array of keys to combine (modifiers first).
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1471,7 +1491,7 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 #### Parameters
 
 *   `select` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
-*   `option` **([string][3] | [Array][14]<any>)** visible text or value of option.
+*   `option` **([string][3] | [Array][15]<any>)** visible text or value of option.
 *   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -1494,7 +1514,7 @@ I.setCookie([
 
 #### Parameters
 
-*   `cookie` **(Cookie | [Array][14]<Cookie>)** a cookie object or array of cookie objects.
+*   `cookie` **(Cookie | [Array][15]<Cookie>)** a cookie object or array of cookie objects.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1544,13 +1564,13 @@ const video = await I.stopScreencast();
 
 *   `options` **[object][4]?** `{ lastFrameDelayMs }`: how long the last frame is shown, in milliseconds (1000 by default). 
 
-Returns **[Promise][12]<([Buffer][15] | null)>** APNG data, or `null` if no frames were recorded.
+Returns **[Promise][12]<([Buffer][16] | null)>** APNG data, or `null` if no frames were recorded.
 
 ### type
 
 Types out the given text into an active field.
 To slow down typing use a second parameter, to set interval between key presses.
-*Note:* Should be used when [`fillField`][16] is not an option.
+*Note:* Should be used when [`fillField`][17] is not an option.
 
 ```js
 // passing in a string
@@ -1570,7 +1590,7 @@ I.type(secret('123456'));
 
 *   `keys` &#x20;
 *   `delay` **[number][8]?** (optional) delay in ms between key presses 
-*   `key` **([string][3] | [Array][14]<[string][3]>)** or array of keys to type.
+*   `key` **([string][3] | [Array][15]<[string][3]>)** or array of keys to type.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1690,7 +1710,7 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 #### Parameters
 
 *   `fn` **([string][3] | [function][11])** to be executed in browser context.
-*   `argsOrSec` **([Array][14]<any> | [number][8])?** (optional, `1` by default) arguments for function or seconds. 
+*   `argsOrSec` **([Array][15]<any> | [number][8])?** (optional, `1` by default) arguments for function or seconds. 
 *   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -1835,7 +1855,7 @@ Probes a `/json/version`-style URL with a short timeout, used for the courtesy-a
 
 *   `url` **[string][3]**&#x20;
 
-Returns **[Promise][12]<[boolean][17]>** true if the URL answered.
+Returns **[Promise][12]<[boolean][18]>** true if the URL answered.
 
 ### _resolveBinary
 
@@ -1892,10 +1912,12 @@ per run and counts directly toward real-world startup latency.
 
 [13]: https://playwright.dev/docs/api/class-locator#locator-focus
 
-[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[14]: https://playwright.dev/docs/aria-snapshots
+
+[15]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[15]: https://nodejs.org/api/buffer.html
+[16]: https://nodejs.org/api/buffer.html
 
-[16]: #fillfield
+[17]: #fillfield
 
-[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean

package/docs/helpers/Obscura.md

@@ -111,8 +111,8 @@ Type: [object][4]
 *   `url` **[string][3]?** base url of website to be tested.
 *   `headers` **[object][4]?** headers sent when connecting to the endpoint, e.g. for authenticated remote browsers.
 *   `input` **[string][3]?** how actions are dispatched: `cdp` (real mouse and keyboard events) or `synthetic` (DOM events). `auto` picks `cdp` when the browser renders layout.
-*   `xpathPolyfill` **([string][3] | [boolean][17])?** inject an XPath polyfill for browsers with incomplete XPath support. `auto` detects when it is needed.
-*   `capabilities` **[object][4]?** browser capabilities (`layout`, `xpath`, `screenshot`, `innerText`) to use instead of detecting them at runtime.
+*   `xpathPolyfill` **([string][3] | [boolean][18])?** inject an XPath polyfill for browsers with incomplete XPath support. `auto` detects when it is needed.
+*   `capabilities` **[object][4]?** browser capabilities (`layout`, `xpath`, `screenshot`, `video`, `innerText`, `aria`) to use instead of detecting them at runtime.
 *   `waitForTimeout` **[number][8]?** default timeout for wait* actions, in seconds.
 *   `waitForAction` **[number][8]?** fixed delay after each action, in milliseconds. When unset, actions wait only for the navigation they trigger.
 *   `pollInterval` **[number][8]?** interval between checks while waiting, in milliseconds.
@@ -250,6 +250,10 @@ I.dontSee('#add-to-cart-btn');
 
 Returns **void** automatically synchronized promise through #recorder
 
+### capabilities
+
+Type: CodeceptJS.HelperCapabilities
+
 ### checkOption
 
 Selects a checkbox or radio button.
@@ -743,6 +747,22 @@ I.forceClick({css: 'nav a.login'});
 
 Returns **void** automatically synchronized promise through #recorder
 
+### grabAriaSnapshot
+
+Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+The format matches Playwright's [ARIA snapshots][14].
+
+```js
+const snapshot = await I.grabAriaSnapshot();
+const formSnapshot = await I.grabAriaSnapshot('#login-form');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator. Defaults to body element. 
+
+Returns **[Promise][12]<[string][3]>** YAML representation of the accessibility tree
+
 ### grabAttributeFrom
 
 Retrieves an attribute from an element located by CSS or XPath and returns it to test.
@@ -774,7 +794,7 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 *   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 *   `attr` **[string][3]** attribute name.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** attribute value
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
 
 ### grabCookie
 
@@ -802,7 +822,7 @@ Resumes test execution, so **should be used inside async function with `await`**
 let cookies = await I.grabCookies();
 ```
 
-Returns **[Promise][12]<[Array][14]<CodeceptJS.Cookie>>** array of cookie objects.
+Returns **[Promise][12]<[Array][15]<CodeceptJS.Cookie>>** array of cookie objects.
 
 ### grabCssPropertyFrom
 
@@ -835,7 +855,7 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 *   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 *   `cssProperty` **[string][3]** CSS property name.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** CSS value
+Returns **[Promise][12]<[Array][15]<[string][3]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -895,7 +915,7 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 *   `locator` &#x20;
 *   `element` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** HTML code for an element
+Returns **[Promise][12]<[Array][15]<[string][3]>>** HTML code for an element
 
 ### grabNumberOfElements
 
@@ -949,7 +969,7 @@ expect(traffics[0].response.status).to.equal(200);
 expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
 ```
 
-Returns **[Array][14]** recorded network traffics
+Returns **[Array][15]** recorded network traffics
 
 ### grabSource
 
@@ -992,7 +1012,7 @@ let pins = await I.grabTextFromAll('#pin li');
 
 *   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** attribute value
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
 
 ### grabTitle
 
@@ -1034,7 +1054,7 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 *   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][14]<[string][3]>>** attribute value
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
 
 ### grabWebElement
 
@@ -1077,7 +1097,7 @@ I.pressKey(['Control', 'a']);
 
 #### Parameters
 
-*   `key` **([string][3] | [Array][14]<[string][3]>)** a key or an array of keys to combine (modifiers first).
+*   `key` **([string][3] | [Array][15]<[string][3]>)** a key or an array of keys to combine (modifiers first).
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1531,7 +1551,7 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 #### Parameters
 
 *   `select` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
-*   `option` **([string][3] | [Array][14]<any>)** visible text or value of option.
+*   `option` **([string][3] | [Array][15]<any>)** visible text or value of option.
 *   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -1554,7 +1574,7 @@ I.setCookie([
 
 #### Parameters
 
-*   `cookie` **(Cookie | [Array][14]<Cookie>)** a cookie object or array of cookie objects.
+*   `cookie` **(Cookie | [Array][15]<Cookie>)** a cookie object or array of cookie objects.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1604,13 +1624,13 @@ const video = await I.stopScreencast();
 
 *   `options` **[object][4]?** `{ lastFrameDelayMs }`: how long the last frame is shown, in milliseconds (1000 by default). 
 
-Returns **[Promise][12]<([Buffer][15] | null)>** APNG data, or `null` if no frames were recorded.
+Returns **[Promise][12]<([Buffer][16] | null)>** APNG data, or `null` if no frames were recorded.
 
 ### type
 
 Types out the given text into an active field.
 To slow down typing use a second parameter, to set interval between key presses.
-*Note:* Should be used when [`fillField`][16] is not an option.
+*Note:* Should be used when [`fillField`][17] is not an option.
 
 ```js
 // passing in a string
@@ -1630,7 +1650,7 @@ I.type(secret('123456'));
 
 *   `keys` &#x20;
 *   `delay` **[number][8]?** (optional) delay in ms between key presses 
-*   `key` **([string][3] | [Array][14]<[string][3]>)** or array of keys to type.
+*   `key` **([string][3] | [Array][15]<[string][3]>)** or array of keys to type.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1750,7 +1770,7 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 #### Parameters
 
 *   `fn` **([string][3] | [function][11])** to be executed in browser context.
-*   `argsOrSec` **([Array][14]<any> | [number][8])?** (optional, `1` by default) arguments for function or seconds. 
+*   `argsOrSec` **([Array][15]<any> | [number][8])?** (optional, `1` by default) arguments for function or seconds. 
 *   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -1895,7 +1915,7 @@ Probes a `/json/version`-style URL with a short timeout, used for the courtesy-a
 
 *   `url` **[string][3]**&#x20;
 
-Returns **[Promise][12]<[boolean][17]>** true if the URL answered.
+Returns **[Promise][12]<[boolean][18]>** true if the URL answered.
 
 ### _resolveBinary
 
@@ -1952,10 +1972,12 @@ per run and counts directly toward real-world startup latency.
 
 [13]: https://playwright.dev/docs/api/class-locator#locator-focus
 
-[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[14]: https://playwright.dev/docs/aria-snapshots
+
+[15]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[15]: https://nodejs.org/api/buffer.html
+[16]: https://nodejs.org/api/buffer.html
 
-[16]: #fillfield
+[17]: #fillfield
 
-[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean

package/docs/helpers/Playwright.md

@@ -440,6 +440,10 @@ Returns **void** automatically synchronized promise through #recorder
 
 Dismisses the active JavaScript popup, as created by window.alert|window.confirm|window.prompt.
 
+### capabilities
+
+Type: CodeceptJS.HelperCapabilities
+
 ### checkOption
 
 [Additional options][14] for check available as 3rd argument.

package/docs/helpers/Puppeteer.md

@@ -39,26 +39,26 @@ Type: [object][6]
 
 *   `url` **[string][5]** base url of website to be tested
 *   `basicAuth` **[object][6]?** (optional) the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
-*   `show` **[boolean][24]?** show Google Chrome window for debug.
-*   `restart` **[boolean][24]?** restart browser between tests.
-*   `disableScreenshots` **[boolean][24]?** don't save screenshot on failure.
-*   `fullPageScreenshots` **[boolean][24]?** make full page screenshots on failure.
-*   `uniqueScreenshotNames` **[boolean][24]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
-*   `trace` **[boolean][24]?** record [tracing information][28] with screenshots.
-*   `keepTraceForPassedTests` **[boolean][24]?** save trace for passed tests.
-*   `keepBrowserState` **[boolean][24]?** keep browser state between tests when `restart` is set to false.
-*   `keepCookies` **[boolean][24]?** keep cookies between tests when `restart` is set to false.
+*   `show` **[boolean][25]?** show Google Chrome window for debug.
+*   `restart` **[boolean][25]?** restart browser between tests.
+*   `disableScreenshots` **[boolean][25]?** don't save screenshot on failure.
+*   `fullPageScreenshots` **[boolean][25]?** make full page screenshots on failure.
+*   `uniqueScreenshotNames` **[boolean][25]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
+*   `trace` **[boolean][25]?** record [tracing information][29] with screenshots.
+*   `keepTraceForPassedTests` **[boolean][25]?** save trace for passed tests.
+*   `keepBrowserState` **[boolean][25]?** keep browser state between tests when `restart` is set to false.
+*   `keepCookies` **[boolean][25]?** keep cookies between tests when `restart` is set to false.
 *   `waitForAction` **[number][11]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
-*   `waitForNavigation` **([string][5] | [Array][17]<[string][5]>)?** when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API][29]. Array values are accepted as well.
+*   `waitForNavigation` **([string][5] | [Array][18]<[string][5]>)?** when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API][30]. Array values are accepted as well.
 *   `pressKeyDelay` **[number][11]?** delay between key presses in ms. Used when calling Puppeteers page.type(...) in fillField/appendField
 *   `getPageTimeout` **[number][11]?** config option to set maximum navigation time in milliseconds. If the timeout is set to 0, then timeout will be disabled.
 *   `waitForTimeout` **[number][11]?** default wait* timeout in ms.
 *   `windowSize` **[string][5]?** default window size. Set a dimension in format WIDTHxHEIGHT like `640x480`.
 *   `userAgent` **[string][5]?** user-agent string.
-*   `manualStart` **[boolean][24]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Puppeteer"]._startBrowser()`.
+*   `manualStart` **[boolean][25]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Puppeteer"]._startBrowser()`.
 *   `browser` **[string][5]?** can be changed to `firefox` when using [puppeteer-firefox][2].
-*   `chrome` **[object][6]?** pass additional [Puppeteer run options][30].
-*   `highlightElement` **[boolean][24]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
+*   `chrome` **[object][6]?** pass additional [Puppeteer run options][31].
+*   `highlightElement` **[boolean][25]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
 
 ## findElement
 
@@ -82,7 +82,7 @@ Note: Unlike Playwright, Puppeteer's Locator API doesn't have .all() method for
 *   `matcher` **[Object][6]** Puppeteer context to search within
 *   `locator` **([Object][6] | [string][5])** Locator specification
 
-Returns **[Promise][12]<[Array][17]>** Array of ElementHandle objects
+Returns **[Promise][12]<[Array][18]>** Array of ElementHandle objects
 
 ## wrapError
 
@@ -340,6 +340,10 @@ Returns **void** automatically synchronized promise through #recorder
 
 Dismisses the active JavaScript popup, as created by window.alert|window.confirm|window.prompt.
 
+### capabilities
+
+Type: CodeceptJS.HelperCapabilities
+
 ### checkOption
 
 Selects a checkbox or radio button.
@@ -917,6 +921,22 @@ I.forceClick({css: 'nav a.login'});
 
 Returns **void** automatically synchronized promise through #recorder
 
+### grabAriaSnapshot
+
+Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+The format matches Playwright's [ARIA snapshots][17].
+
+```js
+const snapshot = await I.grabAriaSnapshot();
+const formSnapshot = await I.grabAriaSnapshot('#login-form');
+```
+
+#### Parameters
+
+*   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator. Defaults to body element. 
+
+Returns **[Promise][12]<[string][5]>** YAML representation of the accessibility tree
+
 ### grabAttributeFrom
 
 Retrieves an attribute from an element located by CSS or XPath and returns it to test.
@@ -948,7 +968,7 @@ let hints = await I.grabAttributeFromAll('.tooltip', 'title');
 *   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `attr` **[string][5]** attribute name.
 
-Returns **[Promise][12]<[Array][17]<[string][5]>>** attribute value
+Returns **[Promise][12]<[Array][18]<[string][5]>>** attribute value
 
 ### grabBrowserLogs
 
@@ -959,7 +979,7 @@ let logs = await I.grabBrowserLogs();
 console.log(JSON.stringify(logs))
 ```
 
-Returns **[Promise][12]<[Array][17]<any>>**&#x20;
+Returns **[Promise][12]<[Array][18]<any>>**&#x20;
 
 ### grabCookie
 
@@ -1009,7 +1029,7 @@ const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
 *   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 *   `cssProperty` **[string][5]** CSS property name.
 
-Returns **[Promise][12]<[Array][17]<[string][5]>>** CSS value
+Returns **[Promise][12]<[Array][18]<[string][5]>>** CSS value
 
 ### grabCurrentUrl
 
@@ -1122,7 +1142,7 @@ let postHTMLs = await I.grabHTMLFromAll('.post');
 *   `locator` &#x20;
 *   `element` **([string][5] | [object][6])** located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][17]<[string][5]>>** HTML code for an element
+Returns **[Promise][12]<[Array][18]<[string][5]>>** HTML code for an element
 
 ### grabNumberOfOpenTabs
 
@@ -1182,7 +1202,7 @@ expect(traffics[0].response.status).to.equal(200);
 expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
 ```
 
-Returns **[Array][17]** recorded network traffics
+Returns **[Array][18]** recorded network traffics
 
 ### grabSource
 
@@ -1225,7 +1245,7 @@ let pins = await I.grabTextFromAll('#pin li');
 
 *   `locator` **([string][5] | [object][6])** element located by CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][17]<[string][5]>>** attribute value
+Returns **[Promise][12]<[Array][18]<[string][5]>>** attribute value
 
 ### grabTitle
 
@@ -1267,7 +1287,7 @@ let inputs = await I.grabValueFromAll('//form/input');
 
 *   `locator` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
 
-Returns **[Promise][12]<[Array][17]<[string][5]>>** attribute value
+Returns **[Promise][12]<[Array][18]<[string][5]>>** attribute value
 
 ### grabWebElement
 
@@ -1303,12 +1323,12 @@ Returns **[Promise][12]<any>** WebElement of being used Web helper
 
 Grab the recording WS messages
 
-Returns **([Array][17]<any> | [undefined][18])**&#x20;
+Returns **([Array][18]<any> | [undefined][19])**&#x20;
 
 ### handleDownloads
 
 Sets a directory to where save files. Allows to test file downloads.
-Should be used with [FileSystem helper][19] to check that file were downloaded correctly.
+Should be used with [FileSystem helper][20] to check that file were downloaded correctly.
 
 By default, files are saved to `output/downloads`.
 This directory is cleaned on every `handleDownloads` call, to ensure no old files are kept.
@@ -1327,13 +1347,13 @@ I.seeFile('avatar.jpg');
 
 ### mockRoute
 
-Mocks network request using [`Request Interception`][20]
+Mocks network request using [`Request Interception`][21]
 
 ```js
 I.mockRoute(/(.png$)|(.jpg$)/, route => route.abort());
 ```
 
-This method allows intercepting and mocking requests & responses. [Learn more about it][20]
+This method allows intercepting and mocking requests & responses. [Learn more about it][21]
 
 #### Parameters
 
@@ -1372,11 +1392,11 @@ I.openNewTab();
 
 ### pressKey
 
-*Note:* Shortcuts like `'Meta'` + `'A'` do not work on macOS ([puppeteer/puppeteer#1313][21]).
+*Note:* Shortcuts like `'Meta'` + `'A'` do not work on macOS ([puppeteer/puppeteer#1313][22]).
 
 Presses a key in the browser (on a focused element).
 
-*Hint:* For populating text field or textarea, it is recommended to use [`fillField`][22].
+*Hint:* For populating text field or textarea, it is recommended to use [`fillField`][23].
 
 ```js
 I.pressKey('Backspace');
@@ -1435,7 +1455,7 @@ Some of the supported key names are:
 
 #### Parameters
 
-*   `key` **([string][5] | [Array][17]<[string][5]>)** key or array of keys to press.
+*   `key` **([string][5] | [Array][18]<[string][5]>)** key or array of keys to press.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1443,7 +1463,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 Presses a key in the browser and leaves it in a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][23]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][24]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1461,7 +1481,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 Releases a key in the browser which was previously set to a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][23]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][24]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1551,7 +1571,7 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 #### Parameters
 
 *   `fileName` **[string][5]** file name to save.
-*   `fullPage` **[boolean][24]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
+*   `fullPage` **[boolean][25]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1991,7 +2011,7 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 #### Parameters
 
 *   `select` **([string][5] | [object][6])** field located by label|name|CSS|XPath|strict locator.
-*   `option` **([string][5] | [Array][17]<any>)** visible text or value of option.
+*   `option` **([string][5] | [Array][18]<any>)** visible text or value of option.
 *   `context` **([string][5]? | [object][6])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2014,7 +2034,7 @@ I.setCookie([
 
 #### Parameters
 
-*   `cookie` **(Cookie | [Array][17]<Cookie>)** a cookie object or array of cookie objects.
+*   `cookie` **(Cookie | [Array][18]<Cookie>)** a cookie object or array of cookie objects.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2129,7 +2149,7 @@ I.switchToPreviousTab(2);
 
 Types out the given text into an active field.
 To slow down typing use a second parameter, to set interval between key presses.
-*Note:* Should be used when [`fillField`][22] is not an option.
+*Note:* Should be used when [`fillField`][23] is not an option.
 
 ```js
 // passing in a string
@@ -2149,7 +2169,7 @@ I.type(secret('123456'));
 
 *   `keys` &#x20;
 *   `delay` **[number][11]?** (optional) delay in ms between key presses 
-*   `key` **([string][5] | [Array][17]<[string][5]>)** or array of keys to type.
+*   `key` **([string][5] | [Array][18]<[string][5]>)** or array of keys to type.
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -2180,7 +2200,7 @@ Use Puppeteer API inside a test.
 First argument is a description of an action.
 Second argument is async function that gets this helper as parameter.
 
-{ [`page`][25], [`browser`][26] } from Puppeteer API are available.
+{ [`page`][26], [`browser`][27] } from Puppeteer API are available.
 
 ```js
 I.usePuppeteerTo('emulate offline mode', async ({ page }) {
@@ -2312,7 +2332,7 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
 #### Parameters
 
 *   `fn` **([string][5] | [function][15])** to be executed in browser context.
-*   `argsOrSec` **([Array][17]<any> | [number][11])?** (optional, `1` by default) arguments for function or seconds. 
+*   `argsOrSec` **([Array][18]<any> | [number][11])?** (optional, `1` by default) arguments for function or seconds. 
 *   `sec` **[number][11]?** (optional, `1` by default) time in seconds to wait 
 
 Returns **void** automatically synchronized promise through #recorder
@@ -2337,7 +2357,7 @@ Returns **void** automatically synchronized promise through #recorder
 
 Waits for navigation to finish. By default, takes configured `waitForNavigation` option.
 
-See [Puppeteer's reference][27]
+See [Puppeteer's reference][28]
 
 #### Parameters
 
@@ -2616,30 +2636,32 @@ Set current page
 
 [16]: https://playwright.dev/docs/api/class-locator#locator-focus
 
-[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+[17]: https://playwright.dev/docs/aria-snapshots
+
+[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
 
-[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined
+[19]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined
 
-[19]: https://codecept.io/helpers/FileSystem
+[20]: https://codecept.io/helpers/FileSystem
 
-[20]: https://pptr.dev/guides/network-interception
+[21]: https://pptr.dev/guides/network-interception
 
-[21]: https://github.com/puppeteer/puppeteer/issues/1313
+[22]: https://github.com/puppeteer/puppeteer/issues/1313
 
-[22]: #fillfield
+[23]: #fillfield
 
-[23]: #click
+[24]: #click
 
-[24]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
 
-[25]: https://github.com/puppeteer/puppeteer/blob/master/docs/api.md#class-page
+[26]: https://github.com/puppeteer/puppeteer/blob/master/docs/api.md#class-page
 
-[26]: https://github.com/puppeteer/puppeteer/blob/master/docs/api.md#class-browser
+[27]: https://github.com/puppeteer/puppeteer/blob/master/docs/api.md#class-browser
 
-[27]: https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.page.waitfornavigation.md
+[28]: https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.page.waitfornavigation.md
 
-[28]: https://pptr.dev/api/puppeteer.tracing
+[29]: https://pptr.dev/api/puppeteer.tracing
 
-[29]: https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.waitforoptions.md
+[30]: https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.waitforoptions.md
 
-[30]: https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.launchoptions.md
+[31]: https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.launchoptions.md

package/docs/helpers/WebDriver.md

@@ -519,6 +519,10 @@ Returns **void** automatically synchronized promise through #recorder
 
 Dismisses the active JavaScript popup, as created by `window.alert|window.confirm|window.prompt`.
 
+### capabilities
+
+Type: CodeceptJS.HelperCapabilities
+
 ### checkOption
 
 Appium: not tested

package/lib/aria.js

@@ -257,4 +257,39 @@ function diffAriaSnapshots(previous, current) {
   return formatDiff(added, removed)
 }
 
-export { diffAriaSnapshots, compactAriaSnapshot }
+// ─────────────────────────────────────────────────────────────────
+// Build: accessibility tree → YAML snapshot
+// ─────────────────────────────────────────────────────────────────
+
+const HIDDEN_ROLES = new Set(['RootWebArea', 'generic', 'none', 'LabelText', 'InlineTextBox', 'LineBreak', 'ListMarker'])
+
+function renderAXTree(node, depth = 0, parentName = '') {
+  if (!node) return []
+  const indent = '  '.repeat(depth)
+  const name = (node.name || '').trim()
+  if (node.role === 'StaticText') return name && name !== parentName ? [`${indent}- text: ${JSON.stringify(name)}`] : []
+  const hidden = HIDDEN_ROLES.has(node.role)
+  const children = (node.children || []).flatMap(child => renderAXTree(child, hidden ? depth : depth + 1, hidden ? parentName : name))
+  if (hidden) return children
+  const line = `${indent}- ${node.role}${name ? ` ${JSON.stringify(name)}` : ''}`
+  return [children.length ? `${line}:` : line, ...children]
+}
+
+// Nested tree shaped like Puppeteer's SerializedAXNode: { role, name, children }
+function ariaSnapshotFromTree(root) {
+  return renderAXTree(root).join('\n')
+}
+
+// Flat `nodes` list from CDP `Accessibility.getFullAXTree`, rooted at a DOM node
+function ariaSnapshotFromAXNodes(axNodes, backendNodeId) {
+  const byId = new Map(axNodes.map(node => [node.nodeId, node]))
+  const toTree = node => ({
+    role: node.ignored ? 'none' : node.role?.value,
+    name: node.name?.value,
+    children: (node.childIds || []).map(id => byId.get(id)).filter(Boolean).map(toTree),
+  })
+  const root = axNodes.find(node => node.backendDOMNodeId === backendNodeId)
+  return root ? ariaSnapshotFromTree(toTree(root)) : ''
+}
+
+export { diffAriaSnapshots, compactAriaSnapshot, ariaSnapshotFromTree, ariaSnapshotFromAXNodes }

package/lib/container.js

@@ -61,7 +61,7 @@ class Container {
    *
    */
   static get STANDARD_ACTING_HELPERS() {
-    return ['Playwright', 'WebDriver', 'Puppeteer', 'Appium']
+    return ['Playwright', 'WebDriver', 'Puppeteer', 'Appium', 'Obscura', 'Lightpanda']
   }
   /**
    * Create container with all required helpers and support objects

package/lib/helper/CDPBrowser.js

@@ -8,10 +8,11 @@ import CDPConnection from './extras/CDPConnection.js'
 import installCodeceptClient from './clientscripts/cdpBrowserClient.js'
 import xpathPolyfillSource from './clientscripts/xpathPolyfill.js'
 import layoutProbe from './clientscripts/layoutProbe.js'
+import { ariaSnapshotFromAXNodes } from '../aria.js'
 import Locator from '../locator.js'
 import output from '../output.js'
 import store from '../store.js'
-import { xpathLocator, normalizePath, resolveUrl, toCamelCase, convertCssPropertiesToCamelCase, normalizeSpacesInString, fileExists, base64EncodeFile, getMimeType, isFile, isWindows } from '../utils.js'
+import { xpathLocator, normalizePath, resolveUrl, toCamelCase, convertCssPropertiesToCamelCase, normalizeSpacesInString, fileExists, base64EncodeFile, getMimeType, isFile, isWindows, screenshotOutputFolder } from '../utils.js'
 import ElementNotFound from './errors/ElementNotFound.js'
 import MultipleElementsFound from './errors/MultipleElementsFound.js'
 import { includes as stringIncludes } from '../assert/include.js'
@@ -38,7 +39,7 @@ import { assembleApng, isPng } from './extras/apngAssembler.js'
  * @prop {object} [headers={}] - headers sent when connecting to the endpoint, e.g. for authenticated remote browsers.
  * @prop {string} [input=auto] - how actions are dispatched: `cdp` (real mouse and keyboard events) or `synthetic` (DOM events). `auto` picks `cdp` when the browser renders layout.
  * @prop {string|boolean} [xpathPolyfill=auto] - inject an XPath polyfill for browsers with incomplete XPath support. `auto` detects when it is needed.
- * @prop {object} [capabilities={}] - browser capabilities (`layout`, `xpath`, `screenshot`, `innerText`) to use instead of detecting them at runtime.
+ * @prop {object} [capabilities={}] - browser capabilities (`layout`, `xpath`, `screenshot`, `video`, `innerText`, `aria`) to use instead of detecting them at runtime.
  * @prop {number} [waitForTimeout=5] - default timeout for wait* actions, in seconds.
  * @prop {number} [waitForAction] - fixed delay after each action, in milliseconds. When unset, actions wait only for the navigation they trigger.
  * @prop {number} [pollInterval=25] - interval between checks while waiting, in milliseconds.
@@ -137,7 +138,8 @@ class CDPBrowser extends Helper {
     this.serverError = null
     this.binaryPath = null
     this._selfManagedResolved = false
-    this.capabilities = { layout: null, xpath: null, screenshot: null, innerText: null, ...this.options.capabilities }
+    /** @type {CodeceptJS.HelperCapabilities} */
+    this.capabilities = { screenshot: null, video: null, trace: false, aria: true, layout: null, xpath: null, innerText: null, ...this.options.capabilities }
     this.withinCandidates = null
     this.requests = []
     this.recording = false
@@ -615,6 +617,9 @@ class CDPBrowser extends Helper {
     if (this.capabilities.screenshot === null) {
       this.capabilities.screenshot = this.capabilities.layout === 'real'
     }
+    if (this.capabilities.video === null) {
+      this.capabilities.video = this.capabilities.screenshot
+    }
     if (this.options.input === 'auto') {
       this.options.input = this.capabilities.layout === 'real' ? 'cdp' : 'synthetic'
     }
@@ -754,6 +759,32 @@ class CDPBrowser extends Helper {
     return this._evaluate('document.documentElement.outerHTML')
   }
 
+  /**
+   * Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+   * The format matches Playwright's [ARIA snapshots](https://playwright.dev/docs/aria-snapshots).
+   *
+   * ```js
+   * const snapshot = await I.grabAriaSnapshot();
+   * const formSnapshot = await I.grabAriaSnapshot('#login-form');
+   * ```
+   *
+   * @param {string|object} [locator='//body'] element located by CSS|XPath|strict locator. Defaults to body element.
+   * @return {Promise<string>} YAML representation of the accessibility tree
+   */
+  async grabAriaSnapshot(locator = '//body') {
+    const candidates = this._candidates(locator)
+    const { found } = await this._run(candidates, 'count')
+    if (!found) throw new ElementNotFound(locator)
+    const scope = this.withinCandidates ? [this.withinCandidates] : null
+    const expression = `window.__codecept.run(${JSON.stringify(candidates)}, 'element', null, ${JSON.stringify(scope)}, ${JSON.stringify(this._selectionDescriptor())}).result`
+    const { result } = await this.cdp.send('Runtime.evaluate', { expression }, this.sessionId)
+    const { node } = await this.cdp.send('DOM.describeNode', { objectId: result.objectId }, this.sessionId)
+    const { nodes } = await this.cdp.send('Accessibility.getFullAXTree', {}, this.sessionId)
+    const snapshot = ariaSnapshotFromAXNodes(nodes, node.backendNodeId)
+    this.debugSection('Aria Snapshot', `${snapshot.split('\n').length} lines`)
+    return snapshot
+  }
+
   _candidates(locator, kind = 'element') {
     locator = new Locator(locator)
     if (locator.isShadow()) {
@@ -1368,9 +1399,8 @@ class CDPBrowser extends Helper {
       this.debug('saveScreenshot skipped: this browser has no rendering engine')
       return
     }
-    const outputDir = global.output_dir || '.'
     const res = await this.cdp.send('Page.captureScreenshot', { format: 'png' }, this.sessionId)
-    fs.writeFileSync(path.join(outputDir, fileName), Buffer.from(res.data, 'base64'))
+    fs.writeFileSync(screenshotOutputFolder(fileName), Buffer.from(res.data, 'base64'))
   }
 
   /**
@@ -1383,10 +1413,9 @@ class CDPBrowser extends Helper {
     }
     const res = await this._run(this._candidates(locator), 'rect')
     if (!res.found) throw new ElementNotFound(locator)
-    const outputDir = global.output_dir || '.'
     const { x, y, width, height } = res.result
     const shot = await this.cdp.send('Page.captureScreenshot', { format: 'png', clip: { x, y, width, height, scale: 1 } }, this.sessionId)
-    fs.writeFileSync(path.join(outputDir, fileName), Buffer.from(shot.data, 'base64'))
+    fs.writeFileSync(screenshotOutputFolder(fileName), Buffer.from(shot.data, 'base64'))
   }
 
   /**

package/lib/helper/Decision.js

@@ -221,7 +221,7 @@ class Decision extends Helper {
       title: await helper.grabTitle(),
     }
 
-    if (helper.grabAriaSnapshot) {
+    if (helper.grabAriaSnapshot && !(helper.capabilities && helper.capabilities.aria === false)) {
       state.aria = compactAriaSnapshot(await helper.grabAriaSnapshot()).slice(0, this.options.maxLength)
       return state
     }
@@ -244,7 +244,7 @@ class Decision extends Helper {
 
   _actingHelper() {
     const helper = pickActingHelper(Container.helpers())
-    if (!helper) throw new Error('Decision helper requires a web helper: Playwright, Puppeteer or WebDriver')
+    if (!helper) throw new Error('Decision helper requires a web helper: Playwright, Puppeteer, WebDriver, Obscura or Lightpanda')
     return helper
   }
 }

package/lib/helper/Playwright.js

@@ -340,6 +340,8 @@ class Playwright extends Helper {
     super(config)
 
     // playwright will be loaded dynamically in _init method
+    /** @type {CodeceptJS.HelperCapabilities} */
+    this.capabilities = { screenshot: true, video: true, trace: true, aria: true }
 
     // set defaults
     this.isRemoteBrowser = false

package/lib/helper/Puppeteer.js

@@ -6,6 +6,7 @@ import Helper from '@codeceptjs/helper'
 import { v4 as uuidv4 } from 'uuid'
 import promiseRetry from 'promise-retry'
 import Locator from '../locator.js'
+import { ariaSnapshotFromTree } from '../aria.js'
 import recorder from '../recorder.js'
 import store from '../store.js'
 import { checkFocusBeforeType, checkFocusBeforePressKey } from './extras/focusCheck.js'
@@ -237,6 +238,8 @@ class Puppeteer extends Helper {
     super(config)
 
     // puppeteer will be loaded dynamically in _init method
+    /** @type {CodeceptJS.HelperCapabilities} */
+    this.capabilities = { screenshot: true, video: false, trace: true, aria: true }
     // set defaults
     this.isRemoteBrowser = false
     this.isRunning = false
@@ -289,6 +292,7 @@ class Puppeteer extends Helper {
 
   _setConfig(config) {
     this.options = this._validateConfig(config)
+    this.capabilities.aria = this.options.browser !== 'firefox'
     this.puppeteerOptions = {
       headless: !this.options.show,
       ...this._getOptions(config),
@@ -1827,6 +1831,27 @@ class Puppeteer extends Helper {
     return this.page.content()
   }
 
+  /**
+   * Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+   * The format matches Playwright's [ARIA snapshots](https://playwright.dev/docs/aria-snapshots).
+   *
+   * ```js
+   * const snapshot = await I.grabAriaSnapshot();
+   * const formSnapshot = await I.grabAriaSnapshot('#login-form');
+   * ```
+   *
+   * @param {string|object} [locator='//body'] element located by CSS|XPath|strict locator. Defaults to body element.
+   * @return {Promise<string>} YAML representation of the accessibility tree
+   */
+  async grabAriaSnapshot(locator = '//body') {
+    const els = await this._locate(locator)
+    assertElementExists(els, locator)
+    const tree = await this.page.accessibility.snapshot({ root: els[0], interestingOnly: false })
+    const snapshot = ariaSnapshotFromTree(tree)
+    this.debugSection('Aria Snapshot', `${snapshot.split('\n').length} lines`)
+    return snapshot
+  }
+
   /**
    * Get JS log from browser.
    *

package/lib/helper/WebDriver.js

@@ -461,6 +461,8 @@ class WebDriver extends Helper {
   constructor(config) {
     super(config)
     // webdriverio will be loaded dynamically in _init method
+    /** @type {CodeceptJS.HelperCapabilities} */
+    this.capabilities = { screenshot: true, video: false, trace: false, aria: false }
 
     // set defaults
     this.root = webRoot

package/lib/helper/clientscripts/cdpBrowserClient.js

@@ -319,6 +319,7 @@ export default function installCodeceptClient(xpathNeedsPolyfill) {
       els[0].blur()
       return true
     },
+    element: els => els[0],
     rect: els => {
       if (els[0].scrollIntoView) els[0].scrollIntoView({ block: 'center', inline: 'center' })
       const r = els[0].getBoundingClientRect()

package/lib/plugin/aiTrace.js

@@ -78,7 +78,7 @@ export default function (config = {}) {
   const helper = pickActingHelper(Container.helpers())
 
   if (!helper) {
-    output.warn('aiTrace plugin: No supported helper found (Playwright, Puppeteer, WebDriver). Plugin disabled.')
+    output.print('aiTrace plugin: No supported helper found. Plugin disabled.')
     return
   }
 

package/lib/plugin/pause.js

@@ -109,7 +109,7 @@ function initUrlMode(pattern) {
   const helper = getBrowserHelper()
 
   if (!helper) {
-    output.error('pause:on=url requires a browser helper (Playwright, WebDriver, Puppeteer, Appium)')
+    output.error('pause:on=url requires a browser helper (Playwright, WebDriver, Puppeteer, Appium, Obscura, Lightpanda)')
     return
   }
 

package/lib/plugin/screencast.js

@@ -350,12 +350,9 @@ function buildSrt(steps) {
   return out
 }
 
-// `getBrowserHelper` (from `pluginParser.js`) only recognizes `Container.STANDARD_ACTING_HELPERS`
-// (`Playwright`/`WebDriver`/`Puppeteer`/`Appium`), so it never finds `CDPBrowser`/`Obscura`/
-// `Kitesurf`. Rather than widen that shared list — used by several other plugins with their own,
-// Playwright/WebDriver-specific assumptions — this plugin does its own duck-typed fallback lookup,
-// scoped to itself: any active helper exposing a `startScreencast` function qualifies, with no
-// hardcoded class names, so any future CDP-family helper picks this up automatically too.
+// `getBrowserHelper` (from `pluginParser.js`) only recognizes `Container.STANDARD_ACTING_HELPERS`,
+// so helpers outside that list (`CDPBrowser`, `Kitesurf`) are found by a duck-typed fallback:
+// any active helper exposing a `startScreencast` function qualifies.
 function getScreencastHelper() {
   const standard = getBrowserHelper()
   if (standard) return standard

package/lib/plugin/screenshot.js

@@ -189,14 +189,15 @@ function scheduleScreenshot(test, fileName, options) {
 }
 
 async function takeScreenshot(test, fileName, options) {
+  const helper = getBrowserHelper()
+  if (!helper || typeof helper.saveScreenshot !== 'function') return
+  if (helper.capabilities && helper.capabilities.screenshot === false) return
+
   const quietMode = !store.outputDir
   if (!quietMode) {
     output.plugin('screenshot', `Saving screenshot ${fileName}`)
   }
 
-  const helper = getBrowserHelper()
-  if (!helper || typeof helper.saveScreenshot !== 'function') return
-
   try {
     if (options.reportDir) {
       fileName = path.join(options.reportDir, fileName)
@@ -332,6 +333,7 @@ function wireSlides(options, trigger) {
 
     const helper = getBrowserHelper()
     if (!helper || typeof helper.saveScreenshot !== 'function') return
+    if (helper.capabilities && helper.capabilities.screenshot === false) return
 
     try {
       const screenshotPath = path.join(dir, fileName)

package/lib/utils/trace.js

@@ -176,7 +176,8 @@ export async function captureSnapshot(helper, {
     } catch {}
   }
 
-  if (captureScreenshot && helper.saveScreenshot) {
+  const canScreenshot = !(helper.capabilities && helper.capabilities.screenshot === false)
+  if (captureScreenshot && canScreenshot && helper.saveScreenshot) {
     try {
       const file = `${prefix}_screenshot.png`
       await helper.saveScreenshot(path.join(dir, file), fullPage)
@@ -201,7 +202,8 @@ export async function captureSnapshot(helper, {
     } catch {}
   }
 
-  if (captureARIA && helper.grabAriaSnapshot) {
+  const canAria = !(helper.capabilities && helper.capabilities.aria === false)
+  if (captureARIA && canAria && helper.grabAriaSnapshot) {
     try {
       const aria = await helper.grabAriaSnapshot()
       const file = `${prefix}_aria.txt`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "4.2.1-beta.2",
+  "version": "4.2.1",
   "type": "module",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [

package/typings/index.d.ts

@@ -465,6 +465,20 @@ declare namespace CodeceptJS {
     y: number
   }
 
+  /**
+   * Features an acting helper supports. Plugins read them to decide what to capture.
+   * `null` means the value is detected at runtime.
+   */
+  interface HelperCapabilities {
+    screenshot: boolean | null
+    video: boolean | null
+    trace: boolean
+    aria: boolean
+    layout?: 'real' | 'none' | null
+    xpath?: 'native' | 'polyfill' | null
+    innerText?: 'native' | 'computed' | null
+  }
+
   // Could get extended by user generated typings
   interface Methods extends ActorStatic {}
   interface I {}

package/typings/promiseBasedTypes.d.ts

@@ -1197,7 +1197,7 @@ declare namespace CodeceptJS {
      * @property [headers = {}] - headers sent when connecting to the endpoint, e.g. for authenticated remote browsers.
      * @property [input = auto] - how actions are dispatched: `cdp` (real mouse and keyboard events) or `synthetic` (DOM events). `auto` picks `cdp` when the browser renders layout.
      * @property [xpathPolyfill = auto] - inject an XPath polyfill for browsers with incomplete XPath support. `auto` detects when it is needed.
-     * @property [capabilities = {}] - browser capabilities (`layout`, `xpath`, `screenshot`, `innerText`) to use instead of detecting them at runtime.
+     * @property [capabilities = {}] - browser capabilities (`layout`, `xpath`, `screenshot`, `video`, `innerText`, `aria`) to use instead of detecting them at runtime.
      * @property [waitForTimeout = 5] - default timeout for wait* actions, in seconds.
      * @property [waitForAction] - fixed delay after each action, in milliseconds. When unset, actions wait only for the navigation they trigger.
      * @property [pollInterval = 25] - interval between checks while waiting, in milliseconds.
@@ -1249,6 +1249,7 @@ declare namespace CodeceptJS {
      */
     class CDPBrowserTs {
         constructor(config: CDPBrowserConfig);
+        capabilities: CodeceptJS.HelperCapabilities;
         /**
          * Opts a subclass into managing its own browser server process. Called from a subclass
          * constructor with the raw user config and a server descriptor:
@@ -1404,6 +1405,18 @@ declare namespace CodeceptJS {
          * @returns source code
          */
         grabSource(): Promise<string>;
+        /**
+         * Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+         * The format matches Playwright's [ARIA snapshots](https://playwright.dev/docs/aria-snapshots).
+         *
+         * ```js
+         * const snapshot = await I.grabAriaSnapshot();
+         * const formSnapshot = await I.grabAriaSnapshot('#login-form');
+         * ```
+         * @param [locator = '//body'] - element located by CSS|XPath|strict locator. Defaults to body element.
+         * @returns YAML representation of the accessibility tree
+         */
+        grabAriaSnapshot(locator?: string | any): Promise<string>;
         /**
          * Checks that a page contains a visible text.
          * Use context parameter to narrow down the search.
@@ -3924,6 +3937,7 @@ declare namespace CodeceptJS {
      * ```
      */
     class PlaywrightTs {
+        capabilities: CodeceptJS.HelperCapabilities;
         /**
          * Use Playwright API inside a test.
          *
@@ -6135,6 +6149,7 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     class PuppeteerTs {
+        capabilities: CodeceptJS.HelperCapabilities;
         /**
          * Use Puppeteer API inside a test.
          *
@@ -7132,6 +7147,18 @@ declare namespace CodeceptJS {
          * @returns source code
          */
         grabSource(): Promise<string>;
+        /**
+         * Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+         * The format matches Playwright's [ARIA snapshots](https://playwright.dev/docs/aria-snapshots).
+         *
+         * ```js
+         * const snapshot = await I.grabAriaSnapshot();
+         * const formSnapshot = await I.grabAriaSnapshot('#login-form');
+         * ```
+         * @param [locator = '//body'] - element located by CSS|XPath|strict locator. Defaults to body element.
+         * @returns YAML representation of the accessibility tree
+         */
+        grabAriaSnapshot(locator?: string | any): Promise<string>;
         /**
          * Get JS log from browser.
          *
@@ -8587,6 +8614,7 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     class WebDriverTs {
+        capabilities: CodeceptJS.HelperCapabilities;
         /**
          * Use [webdriverio](https://webdriver.io/docs/api.html) API inside a test.
          *

package/typings/types.d.ts

@@ -1225,7 +1225,7 @@ declare namespace CodeceptJS {
      * @property [headers = {}] - headers sent when connecting to the endpoint, e.g. for authenticated remote browsers.
      * @property [input = auto] - how actions are dispatched: `cdp` (real mouse and keyboard events) or `synthetic` (DOM events). `auto` picks `cdp` when the browser renders layout.
      * @property [xpathPolyfill = auto] - inject an XPath polyfill for browsers with incomplete XPath support. `auto` detects when it is needed.
-     * @property [capabilities = {}] - browser capabilities (`layout`, `xpath`, `screenshot`, `innerText`) to use instead of detecting them at runtime.
+     * @property [capabilities = {}] - browser capabilities (`layout`, `xpath`, `screenshot`, `video`, `innerText`, `aria`) to use instead of detecting them at runtime.
      * @property [waitForTimeout = 5] - default timeout for wait* actions, in seconds.
      * @property [waitForAction] - fixed delay after each action, in milliseconds. When unset, actions wait only for the navigation they trigger.
      * @property [pollInterval = 25] - interval between checks while waiting, in milliseconds.
@@ -1277,6 +1277,7 @@ declare namespace CodeceptJS {
      */
     class CDPBrowser {
         constructor(config: CDPBrowserConfig);
+        capabilities: CodeceptJS.HelperCapabilities;
         /**
          * Opts a subclass into managing its own browser server process. Called from a subclass
          * constructor with the raw user config and a server descriptor:
@@ -1435,6 +1436,18 @@ declare namespace CodeceptJS {
          * @returns source code
          */
         grabSource(): Promise<string>;
+        /**
+         * Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+         * The format matches Playwright's [ARIA snapshots](https://playwright.dev/docs/aria-snapshots).
+         *
+         * ```js
+         * const snapshot = await I.grabAriaSnapshot();
+         * const formSnapshot = await I.grabAriaSnapshot('#login-form');
+         * ```
+         * @param [locator = '//body'] - element located by CSS|XPath|strict locator. Defaults to body element.
+         * @returns YAML representation of the accessibility tree
+         */
+        grabAriaSnapshot(locator?: string | any): Promise<string>;
         /**
          * Checks that a page contains a visible text.
          * Use context parameter to narrow down the search.
@@ -4027,6 +4040,7 @@ declare namespace CodeceptJS {
      * ```
      */
     class Playwright {
+        capabilities: CodeceptJS.HelperCapabilities;
         /**
          * Use Playwright API inside a test.
          *
@@ -6326,6 +6340,7 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     class Puppeteer {
+        capabilities: CodeceptJS.HelperCapabilities;
         /**
          * Use Puppeteer API inside a test.
          *
@@ -7370,6 +7385,18 @@ declare namespace CodeceptJS {
          * @returns source code
          */
         grabSource(): Promise<string>;
+        /**
+         * Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+         * The format matches Playwright's [ARIA snapshots](https://playwright.dev/docs/aria-snapshots).
+         *
+         * ```js
+         * const snapshot = await I.grabAriaSnapshot();
+         * const formSnapshot = await I.grabAriaSnapshot('#login-form');
+         * ```
+         * @param [locator = '//body'] - element located by CSS|XPath|strict locator. Defaults to body element.
+         * @returns YAML representation of the accessibility tree
+         */
+        grabAriaSnapshot(locator?: string | any): Promise<string>;
         /**
          * Get JS log from browser.
          *
@@ -8868,6 +8895,7 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     class WebDriver {
+        capabilities: CodeceptJS.HelperCapabilities;
         /**
          * Use [webdriverio](https://webdriver.io/docs/api.html) API inside a test.
          *