Function buildLocatorString

lib/helper/Playwright.js:4177–4194

(locator)

export default Playwright

export function buildLocatorString(locator) {
  if (locator.isXPath()) {
    // Make XPath relative so it works correctly within scoped contexts (e.g. within()).
    // Playwright's XPath engine auto-converts "//..." to ".//..." when the root is not a Document,
    // but only when the selector starts with "/". Locator methods like at() wrap XPath in
    // parentheses (e.g. "(//...)[position()=1]"), bypassing that auto-conversion.
    // We fix this by prepending "." before the first "//" that follows any leading parentheses.
    const value = locator.value.replace(/^(\(*)\/\//, '$1.//')
    return `xpath=${value}`
  }
  if (locator.isShadow()) {
    // Convert shadow locator to CSS with >> chaining operator
    // Playwright pierces shadow DOM by default, >> chains selectors
    // { shadow: ['my-app', 'my-form', 'button'] } => 'my-app >> my-form >> button'
    return locator.value.join(' >> ')
  }
  return locator.simplify()
}

/**
 * Handles role locator objects by converting them to Playwright's getByRole() API