Function handleRoleLocator

lib/helper/Playwright.js:4201–4212

* Handles role locator objects by converting them to Playwright's getByRole() API * Accepts both raw objects ({role: 'button', text: 'Submit'}) and Locator-wrapped role objects. * Returns elements array if role locator, null otherwise

(context, locator)

 * Returns elements array if role locator, null otherwise
 */
async function handleRoleLocator(context, locator) {
  const loc = new Locator(locator)
  if (!loc.isRole()) return null

  const roleObj = loc.locator || {}
  const options = {}
  if (roleObj.text) options.name = roleObj.text
  if (roleObj.name) options.name = roleObj.name
  if (roleObj.exact !== undefined) options.exact = roleObj.exact

  return context.getByRole(roleObj.role, Object.keys(options).length > 0 ? options : undefined).all()
}

async function findByRole(context, locator) {
  if (!locator || !locator.role) return null