capybara-webkit在Minitest系统测试中无法执行JavaScript求助

我之前也踩过capybara-webkit JS执行失效的坑，结合你的场景和配置，给你几个实用的排查方向：

capybara-webkit 1.14.0版本依赖Qt 5.5+，而且不能用Qt6（新版brew默认装Qt6，和旧版webkit驱动不兼容）。你可以按系统类型检查：

• macOS：用brew list qt@5确认是否安装，没装的话执行brew install qt@5，之后记得重新运行bundle install让webkit驱动基于正确的Qt版本编译
• Linux（比如Ubuntu）：需要安装libqt5webkit5-dev、qtbase5-dev这两个核心依赖包

你手动设置Capybara.current_driver的操作其实多余，driven_by :webkit已经帮你配置好了驱动，手动覆盖可能打乱默认的等待机制。建议：

• 删掉额外配置里的setup do Capybara.current_driver = ...代码
• 把全局等待时间调长一点，给JS和AJAX足够的执行时间：

# 在ApplicationSystemTestCase里加上
Capybara.default_max_wait_time = 10 # 默认是2秒，改成10秒试试

• 断言时用Capybara自带的has_selector?、has_content?这类方法，它们会自动等待元素状态变化，而不是直接用assert page.find(...)（后者会立刻报错）：

# View1里等待隐藏字段显示
assert page.has_selector?('#target_field', visible: true)
# View2里等待AJAX加载的内容出现
assert page.has_content?('预期加载的文本')

QtWebKit的JS引擎和Chrome/Firefox差异很大，有些现代语法或者API可能不支持。你可以开启debug模式看JS报错：

# 在ApplicationSystemTestCase里添加webkit配置
Capybara::Webkit.configure do |config|
  config.debug = true # 输出JS控制台日志
  config.allow_url("your-app-domain.com") # 允许AJAX请求的域名，避免跨域被拦截
end

运行测试后，看看控制台有没有JS语法错误、未定义变量这类提示，这往往是问题根源。

如果上面的方法都没效果，你可以换成Selenium+Chrome驱动试试，验证是不是capybara-webkit本身的问题：

# 修改ApplicationSystemTestCase的驱动配置
driven_by :selenium, using: :chrome, screen_size: [1400, 1400]

如果换驱动后测试通过，那说明问题确实出在capybara-webkit的配置或兼容性上，可以继续针对性排查；如果还是失败，那就要检查你的测试代码或者前端JS逻辑了。

有时候测试里点击下拉框的方式不对，导致JS事件没触发。建议用Capybara原生的select方法，它会正确触发下拉框的change事件：

# 按文本选择下拉选项
select '选项名称', from: '下拉框的name属性或id'

如果必须手动点击，要先展开下拉框再点选项：

find('#dropdown_trigger').click
find('#dropdown_option').click

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