使用Capybara 3.6在Devise邮件视图中查找指定文本失败

核心问题 #

你直接对ActionMailer::Base.deliveries.last这个邮件对象调用Capybara的have_css断言是错误的——have_css是Capybara用于页面/元素节点的断言方法，不能直接作用于ActionMailer的邮件实例。你已经引入了capybara-email，应该用它提供的API来处理邮件内容，这样才能复用Capybara的选择器和断言能力。

正确的实现步骤 #

1. 确保capybara-email配置正确
   在你的测试配置文件（比如spec/rails_helper.rb或spec/spec_helper.rb）中添加：

   require 'capybara/email/rspec'
   

2. 使用capybara-email的API操作邮件
   放弃直接操作ActionMailer::Base.deliveries，改用open_email和current_email，后者是Capybara能识别的邮件对象，可以直接调用have_css等断言：

   click_button "Sign up"
   open_email('test@example.com') # 这一步会把对应邮件设为current_email
   
   # 验证收件人
   expect(current_email.to).to eq ['test@example.com']
   
   # 方式1：简化选择器，匹配包含目标文本的<b>标签
   # 用正则实现部分匹配，不需要完全一致
   expect(current_email).to have_css('b', text: /example text/)
   
   # 方式2：使用完整CSS选择器，同时用exact: false实现部分匹配（Capybara 3.x支持）
   expect(current_email).to have_css(
     "body > table > tbody > tr > td > table > tbody > tr > td > table > tbody > tr:nth-child(3) > td > b",
     text: "example text",
     exact: false
   )
   
   # 方式3：如果不需要定位元素，直接验证邮件文本中包含目标内容
   expect(current_email).to have_content("example text")
   

关键细节说明 #

• 文本匹配规则：Capybara默认是精确匹配文本，要实现部分匹配有两种方式：
  • 用正则表达式：text: /example text/（大小写不敏感可以加i，比如/example text/i）
  • 用exact: false选项：告诉Capybara不要求完全匹配文本
• 简化选择器：你写的CSS选择器层级太长，容易因为HTML结构小改动失效。可以尝试简化，比如如果页面中只有一个包含目标文本的<b>标签，直接用have_css('b', text: /example text/)就足够；如果有多个，再考虑用更精准的选择器（比如结合父元素的特征，比如某个table的class）。

替代方案（如果不想用capybara-email） #

如果坚持用ActionMailer::Base.deliveries.last，可以把邮件的HTML内容转换成Capybara的文档对象：

last_email = ActionMailer::Base.deliveries.last
email_html = Capybara.string(last_email.html_part.body.to_s)

expect(email_html).to have_css('b', text: /example text/)

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