Method waitForBrowserAlert

test/e2e/webdriver/driver.js:1608–1674

* Wait for a browser alert to appear and verify its text. Automatically detects * whether a window switch is needed by comparing current window with target window. * If they match, uses normal alert waiting. If different, attempts window switching * but handles the case where Selenium fails

({ text, windowTitle, timeout = this.timeout })

   * @returns {Promise<void>} Promise that resolves when alert is found and verified.
   */
  async waitForBrowserAlert({ text, windowTitle, timeout = this.timeout }) {
    const currentTitle = await this.driver.getTitle();
    if (currentTitle === windowTitle) {
      await this.driver.wait(until.alertIsPresent(), timeout);
      const alert = await this.driver.switchTo().alert();
      const alertText = await alert.getText();

      if (alertText !== text) {
        throw new Error(
          `Expected alert text to be "${text}", but got "${alertText}".`,
        );
      }
    } else {
      await this.driver.wait(async () => {
        try {
          await this.switchToWindowWithTitle(windowTitle);
          // If window switch succeeds, alert hasn't appeared yet - keep waiting
          return false;
        } catch (error) {
          if (
            error.name === 'UnexpectedAlertOpenError' ||
            (error.message &&
              error.message.includes('unexpected alert open')) ||
            (error.message &&
              error.message.includes('Unexpected alert dialog detected'))
          ) {
            if (process.env.SELENIUM_BROWSER === Browser.FIREFOX) {
              // Firefox doesn't include alert text in error message
              try {
                const alert = await this.driver.switchTo().alert();
                const alertText = await alert.getText();
                if (alertText !== text) {
                  throw new Error(
                    `Expected alert text to be "${text}", but got "${alertText}".`,
                  );
                }
                return true;
              } catch (alertError) {
                console.warn(
                  `Could not access alert directly. Expected: "${text}". Error: ${alertError.message}`,
                );
                return true;
              }
            } else {
              const alertTextMatch = error.message.match(
                /Alert text\s*:\s*(.+?)(?:\s*\}|$)/u,
              );
              if (alertTextMatch) {
                const alertText = alertTextMatch[1].trim();
                if (alertText !== text) {
                  throw new Error(
                    `Expected alert text to be "${text}", but got "${alertText}".`,
                  );
                }
                return true;
              }
              throw new Error(
                `Could not extract alert text from UnexpectedAlertOpenError. Full error message: "${error.message}"`,