Method selectOption

lib/helper/Puppeteer.js:1688–1721

* {{> selectOption }}

(select, option, context = null)

   * {{> selectOption }}
   */
  async selectOption(select, option, context = null) {
    const pageContext = await this._getContext()
    const matchedLocator = new Locator(select)

    let contextEl
    if (context) {
      const contextEls = await findElements.call(this, pageContext, context)
      assertElementExists(contextEls, context, 'Context element')
      contextEl = contextEls[0]
    }

    // Strict locator
    if (!matchedLocator.isFuzzy()) {
      this.debugSection('SelectOption', `Strict: ${JSON.stringify(select)}`)
      const els = contextEl ? await findElements.call(this, contextEl, select) : await this._locate(select)
      assertElementExists(els, select, 'Selectable element')
      return proceedSelect.call(this, pageContext, selectElement(els, select, this), option)
    }

    // Fuzzy: try combobox
    this.debugSection('SelectOption', `Fuzzy: "${matchedLocator.value}"`)
    const comboboxSearchCtx = contextEl || pageContext
    let els = await findByRole(comboboxSearchCtx, { role: 'combobox', name: matchedLocator.value })
    if (els?.length) return proceedSelect.call(this, pageContext, selectElement(els, select, this), option)

    // Fuzzy: try listbox
    els = await findByRole(comboboxSearchCtx, { role: 'listbox', name: matchedLocator.value })
    if (els?.length) return proceedSelect.call(this, pageContext, selectElement(els, select, this), option)

    // Fuzzy: try native select
    const visibleEls = await findVisibleFields.call(this, select, context)
    assertElementExists(visibleEls, select, 'Selectable field')
    return proceedSelect.call(this, pageContext, selectElement(visibleEls, select, this), option)
  }

  /**
   * {{> grabNumberOfVisibleElements }}