如何使用Ruby检查页面中是否存在指定data-testid元素

你原本的实现思路是对的，但存在语法错误：混用了RSpec的两套断言体系，expect(...).should是非法写法，且Ruby代码行尾不需要额外加英文分号。

正确写法分类 #

1. 通用CSS属性选择器写法（无版本依赖，所有Capybara版本通用） #

不需要额外配置，直接用CSS属性选择器匹配即可：

• 校验元素存在：

# RSpec 新版推荐语法
expect(page).to have_selector("[data-testid='prepay-enroll-now-button']")

# 旧版RSpec语法（不推荐新项目使用）
page.should have_selector("[data-testid='prepay-enroll-now-button']")

• 校验元素不存在：

# 新版推荐语法
expect(page).to have_no_selector("[data-testid='prepay-enroll-now-button']")

# 旧版语法
page.should have_no_selector("[data-testid='prepay-enroll-now-button']")

2. Capybara原生testid选择器写法（推荐，代码更简洁） #

Capybara 3.29及以上版本原生支持testid定位，只需要提前在测试配置文件（spec_helper.rb/rails_helper.rb/env.rb）里加一行配置指定testid属性名：

Capybara.test_id = 'data-testid'

配置完成后不需要手写长CSS选择器，直接传testid值即可：

# 校验元素存在
expect(page).to have_selector(:test_id, 'prepay-enroll-now-button')

# 校验元素不存在
expect(page).to have_no_selector(:test_id, 'prepay-enroll-now-button')

注意事项 #

• 禁止混用expect()和.should语法，二者属于RSpec不同版本的断言写法，搭配使用会触发语法错误
• 优先使用原生testid选择器，比手写CSS选择器可读性更高，后续如果要统一更换testid属性名（比如改成data-qa-id）只需要改一处配置即可
• Capybara的have_selector断言默认会带等待时间，会自动等待元素出现/消失，比自己写first/all取元素再判空的方式更稳定，适合异步渲染的页面场景

内容的提问来源于stack exchange，提问作者Bruno Eduardo Rosselli