Function findByRole

lib/helper/Puppeteer.js:3560–3586

(matcher, locator)

}

async function findByRole(matcher, locator) {
  const resolved = toLocatorConfig(locator, 'role')
  const roleSelector = buildRoleSelector(resolved)

  if (!resolved.text && !resolved.name) {
    return matcher.$$(roleSelector)
  }

  const allElements = await matcher.$$(roleSelector)
  const filtered = []
  const accessibleName = resolved.text ?? resolved.name
  const matcherFn = createRoleTextMatcher(accessibleName, resolved.exact === true)

  for (const el of allElements) {
    const texts = await el.evaluate(e => {
      const ariaLabel = e.hasAttribute('aria-label') ? e.getAttribute('aria-label') : ''
      const labelText = e.id ? document.querySelector(`label[for="${e.id}"]`)?.textContent.trim() || '' : ''
      const placeholder = e.getAttribute('placeholder') || ''
      const innerText = e.innerText ? e.innerText.trim() : ''
      return [ariaLabel || labelText, placeholder, innerText]
    })

    if (texts.some(text => matcherFn(text))) filtered.push(el)
  }

  return filtered
}

function toLocatorConfig(locator, key) {
  const matchedLocator = new Locator(locator, key)