Method waitForVisible

lib/helper/Appium.js:1796–1821

* {{> waitForVisible }} *

(locator, sec = null)

   *
   */
  async waitForVisible(locator, sec = null) {
    if (this.isWeb) return super.waitForVisible(locator, sec)

    // For mobile native apps, use safe isDisplayed wrapper
    const parsedLocator = parseLocator.call(this, locator)
    const aSec = sec || this.options.waitForTimeoutInSeconds

    return this.browser.waitUntil(
      async () => {
        const res = await this._res(parsedLocator)
        if (!res || res.length === 0) return false

        const selected = []
        for (const el of res) {
          const displayed = await this._isDisplayedSafe(el)
          if (displayed) selected.push(true)
        }

        return selected.length > 0
      },
      {
        timeout: aSec * 1000,
        timeoutMsg: `element (${Locator.build(parsedLocator)}) still not visible after ${aSec} sec`,
      },
    )
  }

  /**
   * {{> waitForInvisible }}