test(webapi): cover grabAriaSnapshot across helpers; honor elementIndex in CDP snapshot

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: DavertMik

lib/helper/CDPBrowser.js

@@ -39,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`, `video`, `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.
@@ -776,7 +776,7 @@ class CDPBrowser extends Helper {
     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)}, null).result`
+    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)

test/helper/webapi.js

@@ -1550,6 +1550,27 @@ export function tests() {
     })
   })
 
+  describe('#grabAriaSnapshot', () => {
+    beforeEach(function () {
+      if (!I.grabAriaSnapshot || I.capabilities?.aria === false) this.skip()
+    })
+
+    it('should grab the ARIA snapshot of the page', async () => {
+      await I.amOnPage('/form/field')
+      const snapshot = await I.grabAriaSnapshot()
+      assert.match(snapshot, /^- /m)
+      assert.ok(snapshot.includes('textbox'), snapshot)
+      assert.ok(snapshot.includes('button'), snapshot)
+    })
+
+    it('should grab the ARIA snapshot of an element', async () => {
+      await I.amOnPage('/info')
+      const snapshot = await I.grabAriaSnapshot('form')
+      assert.ok(snapshot.includes('textbox'), snapshot)
+      assert.ok(!snapshot.includes('Information'), snapshot)
+    })
+  })
+
   describe('#saveScreenshot', () => {
     beforeEach(function () {
       if (I.capabilities?.screenshot === false) this.skip() // no rendering engine, screenshots are unsupported