Function selectElement

lib/helper/extras/elementSelection.js:18–56

(els, locator, helper)

}

function selectElement(els, locator, helper) {
  const opts = store.currentStep?.opts
  const rawIndex = opts?.elementIndex
  const elementIndex = resolveElementIndex(rawIndex)

  if (elementIndex != null) {
    if (els.length === 1) return els[0]

    if (!Number.isInteger(elementIndex) || elementIndex === 0) {
      throw new Error(`elementIndex must be a non-zero integer or 'first'/'last', got: ${rawIndex}`)
    }

    let idx
    if (elementIndex > 0) {
      idx = elementIndex - 1
      if (idx >= els.length) {
        throw new Error(`elementIndex ${elementIndex} exceeds the number of elements found (${els.length}) for "${locator}"`)
      }
    } else {
      idx = els.length + elementIndex
      if (idx < 0) {
        throw new Error(`elementIndex ${elementIndex} exceeds the number of elements found (${els.length}) for "${locator}"`)
      }
    }

    output.debug(`[Elements] Using element #${elementIndex} out of ${els.length}`)
    return els[idx]
  }

  if (isStrictStep(opts, helper)) {
    if (els.length > 1) {
      const webElements = Array.from(els).map(el => new WebElement(el, helper))
      throw new MultipleElementsFound(locator, webElements)
    }
  }

  if (els.length > 1) output.debug(`[Elements] Using first element out of ${els.length}`)
  return els[0]
}

export { selectElement }