Method $

lib/element/WebElement.js:395–428

* Find first child element matching the locator * @param {string|Object} locator Element locator * @returns {Promise } WebElement instance or null if not found

(locator)

   * @returns {Promise<WebElement|null>} WebElement instance or null if not found
   */
  async $(locator) {
    let childElement

    switch (this.helperType) {
      case 'playwright':
        // Playwright Locator objects use locator() method
        if (this.element.locator) {
          const childLocator = this.element.locator(this._normalizeLocator(locator))
          // Get the element handle from the locator
          try {
            childElement = await childLocator.elementHandle()
          } catch (e) {
            return null
          }
        } else {
          childElement = await this.element.$(this._normalizeLocator(locator))
        }
        break
      case 'webdriver':
        try {
          childElement = await this.element.$(this._normalizeLocator(locator))
        } catch (e) {
          return null
        }
        break
      case 'puppeteer':
        childElement = await this.element.$(this._normalizeLocator(locator))
        break
      default:
        throw new Error(`Unsupported helper type: ${this.helperType}`)
    }

    return childElement ? new WebElement(childElement, this.helper) : null
  }

  /**
   * Find all child elements matching the locator