Capybara会话测试结束后无法关闭，触发JS弹窗致测试失败

这个问题我之前帮团队排查过好几次，本质是页面的beforeunload事件在浏览器关闭时触发了确认弹窗，Capybara没法自动处理这个弹窗导致超时失败。给你几个实用的解决办法，按场景选就行：

方法1：提前重置表单状态（贴近真实用户操作） #

如果你的测试只是验证错误提示，不需要保留修改后的表单数据，在关闭浏览器前把表单重置回初始状态，就不会触发离开提示了。可以用原生JS重置所有表单：

page.execute_script("document.querySelectorAll('form').forEach(form => form.reset())")

或者如果页面有「取消」按钮，直接模拟点击取消更符合真实流程：

click_button 'Cancel' if page.has_button?('Cancel')

方法2：直接禁用beforeunload事件（最简单高效） #

测试环境里我们根本不需要这个用户提示，直接用JS把它关掉最省心。在测试结束前执行这段代码：

page.execute_script("window.onbeforeunload = null")

把这个逻辑放到RSpec的after钩子中，就能全局解决所有测试的这个问题：

RSpec.configure do |config|
  config.after(:each) do
    page.execute_script("window.onbeforeunload = null")
  end
end

方法3：自动处理确认弹窗（适合必须保留beforeunload的场景） #

如果你的测试需要保留这个事件，那可以让Capybara自动接受离开提示。注意要处理「没有弹窗」的异常，避免报错：

begin
  alert = page.driver.browser.switch_to.alert
  alert.accept
rescue Selenium::WebDriver::Error::NoAlertPresentError
  # 没有弹窗就跳过
end

同样可以把这段代码放到after钩子中，确保每次测试结束都检查并处理弹窗。

小提示 #

如果你的页面用了React、Vue这类前端框架，原生的form.reset()可能没法完全重置框架维护的表单状态，这时候优先用方法2禁用beforeunload会更稳妥，避免框架状态和原生DOM不一致导致的问题。

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