Function element

lib/els.js:11–37

(purpose, locator, fn)

import WebElement from './element/WebElement.js'

function element(purpose, locator, fn) {
  let stepConfig
  if (StepConfig.isStepConfig(arguments[arguments.length - 1])) {
    stepConfig = arguments[arguments.length - 1]
  }

  if (!fn || fn === stepConfig) {
    fn = locator
    locator = purpose
    purpose = 'first element'
  }

  const step = prepareStep(purpose, locator, fn)
  if (!step) return

  return executeStep(
    step,
    async () => {
      const els = await step.helper._locate(locator)
      output.debug(`Found ${els.length} elements, using first element`)

      const wrapped = new WebElement(els[0], step.helper)
      return fn(wrapped)
    },
    stepConfig,
  )
}

function eachElement(purpose, locator, fn) {
  if (!fn) {