codeceptjs 4.0.0-rc.9 → 4.0.0

package/lib/helper/Puppeteer.js

@@ -8,6 +8,7 @@ import promiseRetry from 'promise-retry'
 import Locator from '../locator.js'
 import recorder from '../recorder.js'
 import store from '../store.js'
+import { checkFocusBeforeType, checkFocusBeforePressKey } from './extras/focusCheck.js'
 import { includes as stringIncludes } from '../assert/include.js'
 import { urlEquals, equals } from '../assert/equal.js'
 import { empty } from '../assert/empty.js'
@@ -44,6 +45,7 @@ import { dontSeeElementError, seeElementError, dontSeeElementInDOMError, seeElem
 import { dontSeeTraffic, seeTraffic, grabRecordedNetworkTraffics, stopRecordingTraffic, flushNetworkTraffics } from './network/actions.js'
 import WebElement from '../element/WebElement.js'
 import { selectElement } from './extras/elementSelection.js'
+import { fillRichEditor } from './extras/richTextEditor.js'
 
 let puppeteer
 
@@ -751,7 +753,7 @@ class Puppeteer extends Helper {
     }
 
     if (this.options.trace) {
-      const fileName = `${`${global.output_dir}${path.sep}trace${path.sep}${uuidv4()}_${clearString(this.currentRunningTest.title)}`.slice(0, 245)}.json`
+      const fileName = `${`${store.outputDir}${path.sep}trace${path.sep}${uuidv4()}_${clearString(this.currentRunningTest.title)}`.slice(0, 245)}.json`
       const dir = path.dirname(fileName)
       if (!fileExists(dir)) fs.mkdirSync(dir)
       await this.page.tracing.start({ screenshots: true, path: fileName })
@@ -819,7 +821,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> moveCursorTo }}
-   * {{ react }}
    */
   async moveCursorTo(locator, offsetX = 0, offsetY = 0) {
     let context = null
@@ -990,7 +991,6 @@ class Puppeteer extends Helper {
    * const elements = await this.helpers['Puppeteer']._locate({name: 'password'});
    * ```
    *
-   * {{ react }}
    */
   async _locate(locator) {
     const context = await this.context
@@ -1005,7 +1005,6 @@ class Puppeteer extends Helper {
    * const element = await this.helpers['Puppeteer']._locateElement({name: 'password'});
    * ```
    *
-   * {{ react }}
    */
   async _locateElement(locator) {
     const context = await this.context
@@ -1189,7 +1188,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> seeElement }}
-   * {{ react }}
    */
   async seeElement(locator, context = null) {
     let els
@@ -1213,7 +1211,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> dontSeeElement }}
-   * {{ react }}
    */
   async dontSeeElement(locator, context = null) {
     let els
@@ -1262,7 +1259,6 @@ class Puppeteer extends Helper {
   /**
    * {{> click }}
    *
-   * {{ react }}
    */
   async click(locator = '//body', context = null) {
     return proceedClick.call(this, locator, context)
@@ -1271,7 +1267,6 @@ class Puppeteer extends Helper {
   /**
    * {{> forceClick }}
    *
-   * {{ react }}
    */
   async forceClick(locator, context = null) {
     let matcher = await this.context
@@ -1301,7 +1296,6 @@ class Puppeteer extends Helper {
   /**
    * {{> clickLink }}
    *
-   * {{ react }}
    */
   async clickLink(locator, context = null) {
     return proceedClick.call(this, locator, context, { waitForNavigation: true })
@@ -1325,7 +1319,7 @@ class Puppeteer extends Helper {
    * @param {string} [downloadPath='downloads'] change this parameter to set another directory for saving
    */
   async handleDownloads(downloadPath = 'downloads') {
-    downloadPath = path.join(global.output_dir, downloadPath)
+    downloadPath = path.join(store.outputDir, downloadPath)
     if (!fs.existsSync(downloadPath)) {
       fs.mkdirSync(downloadPath, '0777')
     }
@@ -1387,7 +1381,7 @@ class Puppeteer extends Helper {
       },
     })
 
-    const outputFile = path.join(`${global.output_dir}/${fileName}`)
+    const outputFile = path.join(`${store.outputDir}/${fileName}`)
 
     try {
       await new Promise((resolve, reject) => {
@@ -1409,7 +1403,6 @@ class Puppeteer extends Helper {
   /**
    * {{> doubleClick }}
    *
-   * {{ react }}
    */
   async doubleClick(locator, context = null) {
     return proceedClick.call(this, locator, context, { clickCount: 2 })
@@ -1418,7 +1411,6 @@ class Puppeteer extends Helper {
   /**
    * {{> rightClick }}
    *
-   * {{ react }}
    */
   async rightClick(locator, context = null) {
     return proceedClick.call(this, locator, context, { button: 'right' })
@@ -1547,6 +1539,7 @@ class Puppeteer extends Helper {
    * {{> pressKeyWithKeyNormalization }}
    */
   async pressKey(key) {
+    await checkFocusBeforePressKey(this, key)
     const modifiers = []
     if (Array.isArray(key)) {
       for (let k of key) {
@@ -1575,6 +1568,8 @@ class Puppeteer extends Helper {
    * {{> type }}
    */
   async type(keys, delay = null) {
+    await checkFocusBeforeType(this)
+
     if (!Array.isArray(keys)) {
       keys = keys.toString()
       keys = keys.split('')
@@ -1588,12 +1583,20 @@ class Puppeteer extends Helper {
 
   /**
    * {{> fillField }}
-   * {{ react }}
    */
   async fillField(field, value, context = null) {
-    const els = await findVisibleFields.call(this, field, context)
+    let els = await findVisibleFields.call(this, field, context)
+    if (!els.length) {
+      els = await findFields.call(this, field, context)
+    }
     assertElementExists(els, field, 'Field')
     const el = selectElement(els, field, this)
+
+    if (await fillRichEditor(this, el, value)) {
+      highlightActiveElement.call(this, el, await this._getContext())
+      return this._waitForAction()
+    }
+
     const tag = await el.getProperty('tagName').then(el => el.jsonValue())
     const editable = await el.getProperty('contenteditable').then(el => el.jsonValue())
     if (tag === 'INPUT' || tag === 'TEXTAREA') {
@@ -1618,7 +1621,6 @@ class Puppeteer extends Helper {
   /**
    * {{> appendField }}
    *
-   * {{ react }}
    */
   async appendField(field, value, context = null) {
     const els = await findVisibleFields.call(this, field, context)
@@ -1652,7 +1654,7 @@ class Puppeteer extends Helper {
    * {{> attachFile }}
    */
   async attachFile(locator, pathToFile, context = null) {
-    const file = path.join(global.codecept_dir, pathToFile)
+    const file = path.join(store.codeceptDir, pathToFile)
 
     if (!fileExists(file)) {
       throw new Error(`File at ${file} can not be found on local system`)
@@ -1720,7 +1722,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> grabNumberOfVisibleElements }}
-   * {{ react }}
    */
   async grabNumberOfVisibleElements(locator) {
     let els = await this._locate(locator)
@@ -1782,7 +1783,6 @@ class Puppeteer extends Helper {
   /**
    * {{> see }}
    *
-   * {{ react }}
    */
   async see(text, context = null) {
     return proceedSee.call(this, 'assert', text, context)
@@ -1798,7 +1798,6 @@ class Puppeteer extends Helper {
   /**
    * {{> dontSee }}
    *
-   * {{ react }}
    */
   async dontSee(text, context = null) {
     return proceedSee.call(this, 'negate', text, context)
@@ -1852,7 +1851,6 @@ class Puppeteer extends Helper {
   /**
    * {{> seeNumberOfElements }}
    *
-   * {{ react }}
    */
   async seeNumberOfElements(locator, num) {
     const elements = await this._locate(locator)
@@ -1862,7 +1860,6 @@ class Puppeteer extends Helper {
   /**
    * {{> seeNumberOfVisibleElements }}
    *
-   * {{ react }}
    */
   async seeNumberOfVisibleElements(locator, num) {
     const res = await this.grabNumberOfVisibleElements(locator)
@@ -1989,7 +1986,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> grabTextFromAll }}
-   * {{ react }}
    */
   async grabTextFromAll(locator) {
     const els = await this._locate(locator)
@@ -2002,7 +1998,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> grabTextFrom }}
-   * {{ react }}
    */
   async grabTextFrom(locator) {
     const texts = await this.grabTextFromAll(locator)
@@ -2063,7 +2058,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> grabCssPropertyFromAll }}
-   * {{ react }}
    */
   async grabCssPropertyFromAll(locator, cssProperty) {
     const els = await this._locate(locator)
@@ -2075,7 +2069,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> grabCssPropertyFrom }}
-   * {{ react }}
    */
   async grabCssPropertyFrom(locator, cssProperty) {
     const cssValues = await this.grabCssPropertyFromAll(locator, cssProperty)
@@ -2090,7 +2083,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> seeCssPropertiesOnElements }}
-   * {{ react }}
    */
   async seeCssPropertiesOnElements(locator, cssProperties) {
     const res = await this._locate(locator)
@@ -2125,7 +2117,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> seeAttributesOnElements }}
-   * {{ react }}
    */
   async seeAttributesOnElements(locator, attributes) {
     const elements = await this._locate(locator)
@@ -2163,7 +2154,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> dragSlider }}
-   * {{ react }}
    */
   async dragSlider(locator, offsetX = 0) {
     const src = await this._locate(locator)
@@ -2185,7 +2175,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> grabAttributeFromAll }}
-   * {{ react }}
    */
   async grabAttributeFromAll(locator, attr) {
     const els = await this._locate(locator)
@@ -2199,7 +2188,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> grabAttributeFrom }}
-   * {{ react }}
    */
   async grabAttributeFrom(locator, attr) {
     const attrs = await this.grabAttributeFromAll(locator, attr)
@@ -2362,7 +2350,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> waitNumberOfVisibleElements }}
-   * {{ react }}
    */
   async waitNumberOfVisibleElements(locator, num, sec) {
     const waitTimeout = sec ? sec * 1000 : this.options.waitForTimeout
@@ -2410,7 +2397,6 @@ class Puppeteer extends Helper {
 
   /**
    * {{> waitForElement }}
-   * {{ react }}
    */
   async waitForElement(locator, sec) {
     const waitTimeout = sec ? sec * 1000 : this.options.waitForTimeout
@@ -2431,7 +2417,6 @@ class Puppeteer extends Helper {
   /**
    * {{> waitForVisible }}
    *
-   * {{ react }}
    */
   async waitForVisible(locator, sec) {
     const waitTimeout = sec ? sec * 1000 : this.options.waitForTimeout
@@ -3008,10 +2993,6 @@ export default Puppeteer
  * @returns {Promise<Array>} Array of ElementHandle objects
  */
 async function findElements(matcher, locator) {
-  // Check if locator is a Locator object with react type, or a raw object with react property
-  const isReactLocator = locator.type === 'react' || (locator.locator && locator.locator.react) || locator.react
-  if (isReactLocator) return findReactElements.call(this, locator)
-  
   locator = new Locator(locator, 'css')
 
   // Check if locator is a role locator and call findByRole
@@ -3078,7 +3059,6 @@ async function findElements(matcher, locator) {
  * @returns {Promise<Object>} Single ElementHandle object
  */
 async function findElement(matcher, locator) {
-  if (locator.react) return findReactElements.call(this, locator)
   locator = new Locator(locator, 'css')
 
   // Check if locator is a role locator and call findByRole
@@ -3564,7 +3544,7 @@ function getNormalizedKey(key) {
 }
 
 function highlightActiveElement(element, context) {
-  if (this.options.highlightElement && global.debugMode) {
+  if (this.options.highlightElement && store.debugMode) {
     highlightElement(element, context)
   }
 }
@@ -3577,75 +3557,6 @@ function _waitForElement(locator, options) {
   }
 }
 
-async function findReactElements(locator) {
-  // Handle both Locator objects and raw locator objects
-  const resolved = locator.locator ? locator.locator : toLocatorConfig(locator, 'react')
-  this.debug(`Finding React elements: ${JSON.stringify(resolved)}`)
-
-  // Use createRequire to access require.resolve in ESM
-  const { createRequire } = await import('module')
-  const require = createRequire(import.meta.url)
-  const resqScript = await fs.promises.readFile(require.resolve('resq'), 'utf-8')
-  await this.page.evaluate(resqScript.toString())
-
-  await this.page.evaluate(() => window.resq.waitToLoadReact())
-  const arrayHandle = await this.page.evaluateHandle(
-    obj => {
-      const { selector, props, state } = obj
-      let elements = window.resq.resq$$(selector)
-      if (Object.keys(props).length) {
-        elements = elements.byProps(props)
-      }
-      if (Object.keys(state).length) {
-        elements = elements.byState(state)
-      }
-
-      if (!elements.length) {
-        return []
-      }
-
-      // resq returns an array of HTMLElements if the React component is a fragment
-      // this avoids having nested arrays of nodes which the driver does not understand
-      // [[div, div], [div, div]] => [div, div, div, div]
-      let nodes = []
-
-      elements.forEach(element => {
-        let { node, isFragment } = element
-
-        if (!node) {
-          isFragment = true
-          node = element.children
-        }
-
-        if (isFragment) {
-          nodes = nodes.concat(node)
-        } else {
-          nodes.push(node)
-        }
-      })
-
-      return [...nodes]
-    },
-    {
-      selector: resolved.react,
-      props: resolved.props || {},
-      state: resolved.state || {},
-    },
-  )
-
-  const properties = await arrayHandle.getProperties()
-  const result = []
-  for (const property of properties.values()) {
-    const elementHandle = property.asElement()
-    if (elementHandle) {
-      result.push(elementHandle)
-    }
-  }
-
-  await arrayHandle.dispose()
-  return result
-}
-
 async function findByRole(matcher, locator) {
   const resolved = toLocatorConfig(locator, 'role')
   const roleSelector = buildRoleSelector(resolved)

package/lib/helper/WebDriver.js

@@ -10,6 +10,7 @@ import promiseRetry from 'promise-retry'
 import { includes as stringIncludes } from '../assert/include.js'
 import { urlEquals, equals } from '../assert/equal.js'
 import store from '../store.js'
+import { checkFocusBeforeType, checkFocusBeforePressKey } from './extras/focusCheck.js'
 import output from '../output.js'
 const { debug } = output
 import { empty } from '../assert/empty.js'
@@ -41,6 +42,7 @@ import { dropFile } from './scripts/dropFile.js'
 import { dontSeeTraffic, seeTraffic, grabRecordedNetworkTraffics, stopRecordingTraffic, flushNetworkTraffics } from './network/actions.js'
 import WebElement from '../element/WebElement.js'
 import { selectElement } from './extras/elementSelection.js'
+import { fillRichEditor } from './extras/richTextEditor.js'
 
 const SHADOW = 'shadow'
 const webRoot = 'body'
@@ -95,11 +97,7 @@ const config = {}
  * WebDriver helper which wraps [webdriverio](http://webdriver.io/) library to
  * manipulate browser using Selenium WebDriver or PhantomJS.
  *
- * WebDriver requires Selenium Server and ChromeDriver/GeckoDriver to be installed. Those tools can be easily installed via NPM. Please check [Testing with WebDriver](https://codecept.io/webdriver/#testing-with-webdriver) for more details.
- *
- * With the release of WebdriverIO version v8.14.0, and onwards, all driver management hassles are now a thing of the past 🙌. Read more [here](https://webdriver.io/blog/2023/07/31/driver-management/).
- * One of the significant advantages of this update is that you can now get rid of any driver services you previously had to manage, such as
- * `wdio-chromedriver-service`, `wdio-geckodriver-service`, `wdio-edgedriver-service`, `wdio-safaridriver-service`, and even `@wdio/selenium-standalone-service`.
+ * No Selenium Server, ChromeDriver, or GeckoDriver to install or start. Since WebdriverIO 9, driver management is fully automatic — WebdriverIO downloads and starts the matching driver for you. Read more [here](https://webdriver.io/blog/2023/07/31/driver-management/). Please check [Testing with WebDriver](https://codecept.io/webdriver/#testing-with-webdriver) for more details.
  *
  * For those who require custom driver options, fear not; WebDriver Helper allows you to pass in driver options through custom WebDriver configuration.
  * If you have a custom grid, use a cloud service, or prefer to run your own driver, there's no need to worry since WebDriver Helper will only start a driver when there are no other connection information settings like hostname or port specified.
@@ -906,13 +904,6 @@ class WebDriver extends Helper {
       return els
     }
 
-    // special locator type for React
-    if (locator.react) {
-      const els = await this.browser.react$$(locator.react, locator.props || undefined, locator.state || undefined)
-      this.debugSection('Elements', `Found ${els.length} react components`)
-      return els
-    }
-
     // special locator type for ARIA roles
     if (locator.role) {
       return this._locateByRole(locator)
@@ -1082,7 +1073,6 @@ class WebDriver extends Helper {
   /**
    * {{> click }}
    *
-   * {{ react }}
    */
   async click(locator, context = null) {
     const clickMethod = this.browser.isMobile && this.browser.capabilities.platformName !== 'android' ? 'touchClick' : 'elementClick'
@@ -1102,7 +1092,6 @@ class WebDriver extends Helper {
   /**
    * {{> forceClick }}
    *
-   * {{ react }}
    */
   async forceClick(locator, context = null) {
     const locateFn = prepareLocateFn.call(this, context)
@@ -1129,7 +1118,6 @@ class WebDriver extends Helper {
   /**
    * {{> doubleClick }}
    *
-   * {{ react }}
    */
   async doubleClick(locator, context = null) {
     const locateFn = prepareLocateFn.call(this, context)
@@ -1149,7 +1137,6 @@ class WebDriver extends Helper {
   /**
    * {{> rightClick }}
    *
-   * {{ react }}
    */
   async rightClick(locator, context) {
     const locateFn = prepareLocateFn.call(this, context)
@@ -1244,7 +1231,6 @@ class WebDriver extends Helper {
   /**
    * {{> forceRightClick }}
    *
-   * {{ react }}
    */
   async forceRightClick(locator, context = null) {
     const locateFn = prepareLocateFn.call(this, context)
@@ -1269,7 +1255,6 @@ class WebDriver extends Helper {
 
   /**
    * {{> fillField }}
-   * {{ react }}
    * {{ custom }}
    *
    */
@@ -1278,6 +1263,11 @@ class WebDriver extends Helper {
     assertElementExists(res, field, 'Field')
     const elem = selectElement(res, field, this)
     highlightActiveElement.call(this, elem)
+
+    if (await fillRichEditor(this, elem, value)) {
+      return
+    }
+
     try {
       await elem.clearValue()
     } catch (err) {
@@ -1294,7 +1284,6 @@ class WebDriver extends Helper {
 
   /**
    * {{> appendField }}
-   * {{ react }}
    */
   async appendField(field, value, context = null) {
     const res = await findFields.call(this, field, context)
@@ -1352,7 +1341,7 @@ class WebDriver extends Helper {
    * {{> attachFile }}
    */
   async attachFile(locator, pathToFile, context = null) {
-    let file = path.join(global.codecept_dir, pathToFile)
+    let file = path.join(store.codeceptDir, pathToFile)
     if (!fileExists(file)) {
       throw new Error(`File at ${file} can not be found on local system`)
     }
@@ -1592,7 +1581,6 @@ class WebDriver extends Helper {
   /**
    * {{> see }}
    *
-   * {{ react }}
    */
   async see(text, context = null) {
     return proceedSee.call(this, 'assert', text, context)
@@ -1608,7 +1596,6 @@ class WebDriver extends Helper {
   /**
    * {{> dontSee }}
    *
-   * {{ react }}
    */
   async dontSee(text, context = null) {
     return proceedSee.call(this, 'negate', text, context)
@@ -1650,7 +1637,6 @@ class WebDriver extends Helper {
 
   /**
    * {{> seeElement }}
-   * {{ react }}
    *
    */
   async seeElement(locator, context = null) {
@@ -1667,7 +1653,6 @@ class WebDriver extends Helper {
 
   /**
    * {{> dontSeeElement }}
-   * {{ react }}
    */
   async dontSeeElement(locator, context = null) {
     const locateFn = prepareLocateFn.call(this, context)
@@ -1752,7 +1737,6 @@ class WebDriver extends Helper {
 
   /**
    * {{> seeNumberOfElements }}
-   * {{ react }}
    */
   async seeNumberOfElements(locator, num) {
     const res = await this._locate(locator)
@@ -1761,7 +1745,6 @@ class WebDriver extends Helper {
 
   /**
    * {{> seeNumberOfVisibleElements }}
-   * {{ react }}
    */
   async seeNumberOfVisibleElements(locator, num) {
     const res = await this.grabNumberOfVisibleElements(locator)
@@ -2237,6 +2220,7 @@ class WebDriver extends Helper {
    * {{> pressKeyWithKeyNormalization }}
    */
   async pressKey(key) {
+    await checkFocusBeforePressKey(this, key)
     const modifiers = []
     if (Array.isArray(key)) {
       for (let k of key) {
@@ -2283,6 +2267,8 @@ class WebDriver extends Helper {
    * {{> type }}
    */
   async type(keys, delay = null) {
+    await checkFocusBeforeType(this)
+
     if (!Array.isArray(keys)) {
       keys = keys.toString()
       keys = keys.split('')
@@ -3480,7 +3466,7 @@ function isModifierKey(key) {
 }
 
 function highlightActiveElement(element) {
-  if (this.options.highlightElement && global.debugMode) {
+  if (this.options.highlightElement && store.debugMode) {
     highlightElement(element, this.browser)
   }
 }
@@ -3491,9 +3477,6 @@ function prepareLocateFn(context) {
     l = new Locator(l, 'css')
     return this._locate(context, true).then(async res => {
       assertElementExists(res, context, 'Context element')
-      if (l.react) {
-        return res[0].react$$(l.react, l.props || undefined)
-      }
       return res[0].$$(l.simplify())
     })
   }

package/lib/helper/errors/NonFocusedType.js

@@ -0,0 +1,8 @@
+class NonFocusedType extends Error {
+  constructor(message) {
+    super(message)
+    this.name = 'NonFocusedType'
+  }
+}
+
+export default NonFocusedType

package/lib/helper/extras/Download.js

@@ -0,0 +1,45 @@
+import fs from 'fs'
+import path from 'path'
+import minimatch from 'minimatch'
+import store from '../../store.js'
+import assert from 'assert'
+
+function getDownloadDir() {
+  return path.join(store.outputDir, 'downloads')
+}
+
+function getNewFiles(downloadDir, sinceTimestamp) {
+  if (!fs.existsSync(downloadDir)) return []
+  return fs.readdirSync(downloadDir).filter(name => {
+    const stat = fs.statSync(path.join(downloadDir, name))
+    return stat.isFile() && stat.mtimeMs >= sinceTimestamp
+  })
+}
+
+function seeFileDownloaded(arg) {
+  const downloadDir = getDownloadDir()
+  const files = getNewFiles(downloadDir, this._downloadStartTimestamp)
+
+  if (arg === undefined || arg === null) {
+    assert.ok(files.length > 0, `No files downloaded to ${downloadDir}`)
+    return
+  }
+  if (typeof arg === 'number') {
+    assert.strictEqual(files.length, arg, `Expected ${arg} downloaded file(s), found ${files.length}: [${files.join(', ')}]`)
+    return
+  }
+  const regexMatch = arg.match(/^\/(.+)\/$/)
+  if (regexMatch) {
+    const re = new RegExp(regexMatch[1])
+    assert.ok(files.some(f => re.test(f)), `No file matches ${arg}. Downloaded: [${files.join(', ')}]`)
+    return
+  }
+  if (/[*?[\]]/.test(arg)) {
+    const matched = minimatch.match(files, arg)
+    assert.ok(matched.length > 0, `No file matches glob "${arg}". Downloaded: [${files.join(', ')}]`)
+    return
+  }
+  assert.ok(files.includes(arg), `File "${arg}" not downloaded. Downloaded: [${files.join(', ')}]`)
+}
+
+export { seeFileDownloaded, getDownloadDir }

package/lib/helper/extras/PlaywrightLocator.js

@@ -0,0 +1,10 @@
+async function findByPlaywrightLocator(matcher, locator) {
+  const pwLocator = locator.locator || locator
+  if (pwLocator && pwLocator.toString && pwLocator.toString().includes(process.env.testIdAttribute)) {
+    return matcher.getByTestId(pwLocator.pw.value.split('=')[1])
+  }
+  const pwValue = typeof pwLocator.pw === 'string' ? pwLocator.pw : pwLocator.pw
+  return matcher.locator(pwValue).all()
+}
+
+export { findByPlaywrightLocator }

package/lib/helper/extras/elementSelection.js

@@ -9,8 +9,15 @@ function resolveElementIndex(value) {
   return value
 }
 
+function isStrictStep(opts, helper) {
+  if (opts?.exact === true || opts?.strictMode === true) return true
+  if (opts?.exact === false || opts?.strictMode === false) return false
+  return helper.options.strict
+}
+
 function selectElement(els, locator, helper) {
-  const rawIndex = store.currentStep?.opts?.elementIndex
+  const opts = store.currentStep?.opts
+  const rawIndex = opts?.elementIndex
   const elementIndex = resolveElementIndex(rawIndex)
 
   if (elementIndex != null) {
@@ -37,9 +44,9 @@ function selectElement(els, locator, helper) {
     return els[idx]
   }
 
-  if (helper.options.strict) {
+  if (isStrictStep(opts, helper)) {
     if (els.length > 1) {
-      const webElements = els.map(el => new WebElement(el, helper))
+      const webElements = Array.from(els).map(el => new WebElement(el, helper))
       throw new MultipleElementsFound(locator, webElements)
     }
   }