Method switchToWindowWithTitle

test/e2e/webdriver/driver.js:1370–1405

* Switches the context of the browser session to the window tab with the given title. * This functionality is especially valuable in complex testing scenarios involving multiple window tabs, * allowing for interaction with a particular window or tab based on its title * * @param {string}

(title)

   * @throws {Error} throws an error if no window with the specified title is found
   */
  async switchToWindowWithTitle(title) {
    if (this.windowHandles) {
      await this.windowHandles.switchToWindowWithProperty('title', title);
      return;
    }

    let windowHandles = await this.driver.getAllWindowHandles();
    let timeElapsed = 0;

    while (timeElapsed <= this.timeout) {
      for (const handle of windowHandles) {
        // Wait 25 x 200ms = 5 seconds for the title to match the target title
        const handleTitle = await retry(
          {
            retries: 25,
            delay: 200,
          },
          async () => {
            await this.driver.switchTo().window(handle);
            return await this.driver.getTitle();
          },
        );

        if (handleTitle === title) {
          return;
        }
      }
      const delayTime = 1000;
      await this.delay(delayTime);
      timeElapsed += delayTime;
      // refresh the window handles
      windowHandles = await this.driver.getAllWindowHandles();
    }

    throw new Error(`No window with title: ${title}`);
  }

  /**
   * Waits until there is a window/tab with the given title, without changing the current window focus.