Add bySelectorAndVisible function (#2288)

Author: soulgalore

lib/core/engine/command/wait.js

@@ -160,6 +160,38 @@ export class Wait {
     }
   }
 
+  /**
+   * Waits for an element located by a CSS selector to be visible within a maximum time.
+   *
+   * @async
+   * @param {string} selector - The CSS selector of the element to wait for.
+   * @param {number} maxTime - Maximum time to wait in milliseconds.
+   * @returns {Promise<void>} A promise that resolves when the element is found or the time times out.
+   * @throws {Error} Throws an error if the element is not found within the specified time.
+   */
+  async bySelectorAndVisible(selector, maxTime = 6000) {
+    const driver = this.browser.getDriver();
+
+    try {
+      await driver.wait(
+        webdriver.until.elementIsVisible(
+          driver.findElement(webdriver.By.css(selector))
+        ),
+        maxTime
+      );
+    } catch (error) {
+      log.error(
+        'Element by selector %s was not visible in %s ms',
+        selector,
+        maxTime
+      );
+      log.verbose(error);
+      throw new Error(
+        `Element by selector ${selector} was not visible in ${maxTime} ms`
+      );
+    }
+  }
+
   /**
    * Waits for a specified amount of time.
    *