improved output

Author: DavertMik

docs/webapi/click.mustache

@@ -3,9 +3,13 @@ If a fuzzy locator is given, the page will be searched for a button, link, or im
 For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
 For images, the "alt" attribute and inner text of any parent links are searched.
 
+If no locator is provided, defaults to clicking the body element (`'//body'`).
+
 The second parameter is a context (CSS or XPath locator) to narrow the search.
 
 ```js
+// click body element (default)
+I.click();
 // simple link
 I.click('Logout');
 // button of form
@@ -20,6 +24,6 @@ I.click('Logout', '#nav');
 I.click({css: 'nav a.login'});
 ```
 
-@param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+@param {CodeceptJS.LocatorOrString} [locator='//body'] (optional, `'//body'` by default) clickable link or button located by text, or any element located by CSS|XPath|strict locator.
 @param {?CodeceptJS.LocatorOrString | null} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
 @returns {void} automatically synchronized promise through #recorder

lib/command/init.js

@@ -35,7 +35,6 @@ const packages = []
 let isTypeScript = false
 let extension = 'js'
 
-const requireCodeceptConfigure = "const { setHeadlessWhen, setCommonPlugins } = require('@codeceptjs/configure');"
 const importCodeceptConfigure = "import { setHeadlessWhen, setCommonPlugins } from '@codeceptjs/configure';"
 
 const configHeader = `
@@ -232,9 +231,9 @@ export default async function (initPath) {
           fs.writeFileSync(typeScriptconfigFile, configSource, 'utf-8')
           print(`Config created at ${typeScriptconfigFile}`)
         } else {
-          configSource = beautify(`/** @type {CodeceptJS.MainConfig} */\nexports.config = ${inspect(config, false, 4, false)}`)
+          configSource = beautify(`/** @type {CodeceptJS.MainConfig} */\nexport const config = ${inspect(config, false, 4, false)}`)
 
-          if (hasConfigure) configSource = requireCodeceptConfigure + configHeader + configSource
+          if (hasConfigure) configSource = importCodeceptConfigure + configHeader + configSource
 
           fs.writeFileSync(configFile, configSource, 'utf-8')
           print(`Config created at ${configFile}`)

lib/helper/Playwright.js

@@ -1911,7 +1911,7 @@ class Playwright extends Helper {
    * ```
    *
    */
-  async click(locator, context = null, options = {}) {
+  async click(locator = '//body', context = null, options = {}) {
     return proceedClick.call(this, locator, context, options)
   }
 
@@ -2640,6 +2640,33 @@ class Playwright extends Helper {
     return array
   }
 
+  /**
+   * Retrieves the ARIA snapshot for an element using Playwright's [`locator.ariaSnapshot`](https://playwright.dev/docs/api/class-locator#locator-aria-snapshot).
+   * This method returns a YAML representation of the accessibility tree that can be used for assertions.
+   * If no locator is provided, it captures the snapshot of the entire page body.
+   *
+   * ```js
+   * const snapshot = await I.grabAriaSnapshot();
+   * expect(snapshot).toContain('heading "Sign up"');
+   *
+   * const formSnapshot = await I.grabAriaSnapshot('#login-form');
+   * expect(formSnapshot).toContain('textbox "Email"');
+   * ```
+   *
+   * [Learn more about ARIA snapshots](https://playwright.dev/docs/aria-snapshots)
+   *
+   * @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 matchedLocator = new Locator(locator)
+    const els = await this._locate(matchedLocator)
+    assertElementExists(els, locator)
+    const snapshot = await els[0].ariaSnapshot()
+    this.debugSection('Aria Snapshot', snapshot)
+    return snapshot
+  }
+
   /**
    * {{> saveElementScreenshot }}
    *

lib/helper/Puppeteer.js

@@ -1146,7 +1146,7 @@ class Puppeteer extends Helper {
    *
    * {{ react }}
    */
-  async click(locator, context = null) {
+  async click(locator = '//body', context = null) {
     return proceedClick.call(this, locator, context)
   }
 

lib/helper/WebDriver.js

@@ -1048,7 +1048,7 @@ class WebDriver extends Helper {
    *
    * {{ react }}
    */
-  async click(locator, context = null) {
+  async click(locator = '//body', context = null) {
     const clickMethod = this.browser.isMobile && !this.browser.isW3C ? 'touchClick' : 'elementClick'
     const locateFn = prepareLocateFn.call(this, context)
 
@@ -1173,7 +1173,17 @@ class WebDriver extends Helper {
     assertElementExists(res, field, 'Field')
     const elem = usingFirstElement(res)
     highlightActiveElement.call(this, elem)
-    await elem.clearValue()
+    try {
+      await elem.clearValue()
+    } catch (err) {
+      if (err.message && err.message.includes('invalid element state')) {
+        await this.executeScript(el => {
+          el.value = ''
+        }, elem)
+      } else {
+        throw err
+      }
+    }
     await elem.setValue(value.toString())
   }
 
@@ -2912,14 +2922,6 @@ async function findFields(locator) {
   let els = await this._locate(Locator.field.labelEquals(literal))
   if (els.length) return els
 
-  // Try ARIA selector for accessible name
-  try {
-    els = await this._locate(`aria/${locator.value}`)
-    if (els.length) return els
-  } catch (e) {
-    // ARIA selector not supported or failed
-  }
-
   els = await this._locate(Locator.field.labelContains(literal))
   if (els.length) return els
 

test/helper/Playwright_test.js

@@ -800,6 +800,41 @@ describe('Playwright', function () {
         .then(html => assert.equal(html.trim(), '<a href="/login" target="_blank">New tab</a>')))
   })
 
+  describe('#grabAriaSnapshot', () => {
+    it('should grab aria snapshot of entire page when no locator is provided', () =>
+      I.amOnPage('/')
+        .then(() => I.grabAriaSnapshot())
+        .then(snapshot => {
+          assert.ok(snapshot)
+          assert.ok(typeof snapshot === 'string')
+        }))
+
+    it('should grab aria snapshot of entire page using default body locator', () =>
+      I.amOnPage('/')
+        .then(() => I.grabAriaSnapshot('//body'))
+        .then(snapshot => {
+          assert.ok(snapshot)
+          assert.ok(typeof snapshot === 'string')
+        }))
+
+    it('should grab aria snapshot of a specific element', () =>
+      I.amOnPage('/')
+        .then(() => I.grabAriaSnapshot('#area1'))
+        .then(snapshot => {
+          assert.ok(snapshot)
+          assert.ok(typeof snapshot === 'string')
+        }))
+
+    it('should grab aria snapshot from within an iframe', () =>
+      I.amOnPage('/iframe')
+        .then(() => I.switchTo({ frame: 'iframe' }))
+        .then(() => I.grabAriaSnapshot())
+        .then(snapshot => {
+          assert.ok(snapshot)
+          assert.ok(typeof snapshot === 'string')
+        }))
+  })
+
   describe('#grabBrowserLogs', () => {
     it('should grab browser logs', () =>
       I.amOnPage('/')