如何使用RSpec测试基于Capybara与Selenium的浏览器自动化代码

• 拆分核心逻辑与浏览器交互代码
  把数据处理、表单规则校验这类和浏览器操作无关的逻辑抽成独立模块，直接写单元测试就行，不用启动浏览器，既高效又稳定。比如：

# 独立的数据处理函数
def format_user_data(raw_data)
  {
    name: raw_data[:full_name].strip,
    email: raw_data[:email].downcase
  }
end

# 对应的单元测试
test "format user data correctly" do
  raw = { full_name: "  John Doe  ", email: "JOHN@EXAMPLE.COM" }
  assert_equal format_user_data(raw), { name: "John Doe", email: "john@example.com" }
end

• 模拟浏览器交互层
  用mock/stub替代真实的Selenium驱动，验证你的代码是否正确调用了浏览器操作。比如Ruby里用RSpec的mock实现：

test "fill form with formatted data" do
  mock_driver = double("Selenium::Driver")
  allow(mock_driver).to receive(:find_element).with(id: "name").and_return(double.as_null_object)
  allow(mock_driver).to receive(:find_element).with(id: "email").and_return(double.as_null_object)

  YourAutomationService.new(mock_driver).fill_user_form(raw_data)

  expect(mock_driver).to have_received(:find_element).with(id: "name")
end

不用真打开浏览器，就能确认代码是否按预期触发了输入、点击等操作。

• 编写少量核心集成测试
  针对登录+表单提交这类关键完整流程，写少量真实浏览器的集成测试，覆盖核心路径就行，不用全量跑——这类测试慢且容易受环境影响，够支撑核心功能验证就好。可以用Capybara的selenium_chrome_headless无头驱动，速度更快，适合CI环境。

• 记录基准状态做对比
  执行自动化操作后，保存页面截图或DOM结构作为基准，后续测试时对比当前执行结果和基准是否一致。比如用Capybara的page.save_screenshot("form_filled.png")生成截图，再用简单的图片差异工具做对比，验证页面是否按预期渲染。

• 靠日志验证执行流程
  在自动化代码里加详细日志，比如每一步的元素定位、输入内容、操作结果。测试时通过检查日志来确认流程是否正确执行，示例代码：

def fill_input(id, value)
  logger.info "Filling input #{id} with value: #{value}"
  find(id: id).set(value)
end

调试复杂流程时，日志能帮你快速定位哪一步出了问题。

• 专项测试容错逻辑
  针对元素找不到、页面超时这类常见异常，手动模拟场景验证你的代码是否有正确的重试、降级逻辑。比如用Capybara执行JS移除某个元素：

page.execute_script("document.getElementById('email').remove()")

然后运行自动化代码，看是否会触发重试机制，或者抛出合理的错误提示。

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