Selenium UnexpectedAlertOpenError问题：accept_confirm仍无法处理弹窗

问题重现 #

编写删除学习笔记的Capybara测试时，明明用了accept_confirm块处理确认弹窗，却依然抛出Selenium::WebDriver::Error::UnexpectedAlertOpenError错误，弹窗文本为Weet u zeker dat u deze bijbelstudie wilt verwijderen?。

测试代码：

feature "Users can delete studynotes", js: true do
  let(:user) { create(:user) }
  let(:otheruser) { create(:user) }

  before { create(:studynote, title: "Jona", author: user) }

  scenario "successfully", js:true do
    login_as(user)

    visit studynotes_path
    click_link "Jona"

    accept_confirm do
      click_link t(:delete_item, item: Studynote.model_name.human)
    end

    expect(page).to have_content(t("activerecord.messages.deleted", model: "bijbelstudie"))
    expect(page).to have_current_path pericopes_path
    expect(page).to have_no_content "Jona"
  end
end

报错核心信息：

Selenium::WebDriver::Error::UnexpectedAlertOpenError:
unexpected alert open: {Alert text : Weet u zeker dat u deze bijbelstudie wilt verwijderen?}
(Session info: headless chrome=119.0.6045.159)

原因分析及解决方案 #

1. 弹窗触发有延迟 #

Selenium的accept_confirm是同步等待弹窗，但如果点击删除后弹窗不是立即弹出（比如前端有异步请求、动画过渡），Capybara可能没及时捕获到弹窗，后续执行断言时弹窗仍处于打开状态，触发错误。

解决方法：
改用accept_alert（部分场景下confirm和alert的处理逻辑有细微差异），或者增加显式等待弹窗的步骤：

# 改用accept_alert处理
accept_alert do
  click_link t(:delete_item, item: Studynote.model_name.human)
end

# 或者添加弹窗等待逻辑（针对延迟场景）
accept_confirm do
  click_link t(:delete_item, item: Studynote.model_name.human)
  wait_for_alert
end

# 辅助方法：循环等待弹窗出现
def wait_for_alert
  loop do
    break if page.driver.browser.switch_to.alert rescue false
    sleep 0.1
  end
end

2. 页面存在未清理的残留弹窗 #

有时候前端逻辑可能重复触发弹窗，或者测试流程中之前的操作遗留了未处理的弹窗，导致后续操作时弹窗冲突。

解决方法：
在执行删除操作前，先检查并清理可能存在的弹窗：

# 预处理弹窗：如果有未处理的弹窗就确认掉
begin
  page.driver.browser.switch_to.alert.accept
rescue Selenium::WebDriver::Error::NoSuchAlertError
  # 没有弹窗则直接继续
end

# 再执行删除的确认流程
accept_confirm do
  click_link t(:delete_item, item: Studynote.model_name.human)
end

3. Headless Chrome弹窗拦截限制 #

Headless模式下Chrome默认可能限制弹窗显示，导致accept_confirm无法捕获到弹窗。

解决方法：
在Capybara的Chrome驱动配置中添加--disable-popup-blocking参数：

Capybara.register_driver :selenium_chrome_headless do |app|
  options = Selenium::WebDriver::Chrome::Options.new
  options.add_argument('--headless=new')
  options.add_argument('--disable-popup-blocking') # 禁用弹窗拦截
  Capybara::Selenium::Driver.new(app, browser: :chrome, options: options)
end

4. 点击事件未正确触发 #

如果删除链接的点击事件是通过JavaScript动态绑定的，Capybara的click_link可能没有正确触发事件，导致弹窗未按预期弹出。

解决方法：
用execute_script直接触发元素的点击事件：

accept_confirm do
  delete_link = find_link(t(:delete_item, item: Studynote.model_name.human))
  page.execute_script("arguments[0].click();", delete_link.native)
end

验证要点 #

修改代码后重新运行测试，确认：

• 弹窗被正确捕获并确认
• 页面跳转至pericopes_path
• 页面不再显示已删除的笔记标题

内容的提问来源于stack exchange，提问作者andreheijstek