推荐使用Cuprite:无Selenium的Capybara头像浏览器驱动
cupriteHeadless Chrome/Chromium driver for Capybara项目地址:https://gitcode.com/gh_mirrors/cu/cuprite
Cuprite是一个全Ruby实现(无需依赖Selenium/WebDriver/ChromeDriver)的Capybara测试驱动器,让你可以在无头Chrome或Chromium上运行Capybara测试。其底层是基于CDP协议的高度API——Ferrum。设计风格与Poltergeist尽可能接近,但并不是追求完全一致的目标。
安装
将以下代码添加到你的Gemfile
中,并运行bundle install
:
group :test do
gem "cuprite"
end
然后在你的测试配置文件中加入:
require "capybara/cuprite"
Capybara.javascript_driver = :cuprite
Capybara.register_driver(:cuprite) do |app|
Capybara::Cuprite::Driver.new(app, window_size: [1200, 800])
end
如果你使用Docker,别忘了传递no-sandbox
选项:
Capybara::Cuprite::Driver.new(app, browser_options: { 'no-sandbox': nil })
由于Cuprite利用了Ferrum,因此你可以直接调用许多有用的方法,即使在使用这个驱动器时也是如此:
browser = page.driver.browser
browser.mouse.move(x: 123, y: 456).down.up
如果你已经拥有Poltergeist的测试,那么它应该可以直接工作;对于Selenium,你可能需要检查你的代码以处理manage
调用,因为它们在Cuprite中的工作方式不同。
自定义配置
查看Ferrum的完整定制选项列表。你可以在测试设置中通过以下代码传递这些选项:
Capybara.register_driver :cuprite do |app|
Capybara::Cuprite::Driver.new(app, options)
end
Cuprite特定的选项包括:
- options
Hash
:url_blacklist
(Array) - 匹配请求URL的字符串数组:url_whitelist
(Array) - 匹配请求URL的字符串数组
调试
如果传递inspector
选项,当测试在INSPECTOR=true
环境下运行时,远程调试功能将被启用。在测试中插入page.driver.debug
或page.driver.debug(binding)
可以暂停测试。这将打开一个浏览器窗口,允许你检查内容。
Capybara.register_driver :cuprite do |app|
Capybara::Cuprite::Driver.new(app, inspector: ENV['INSPECTOR'])
end
然后在测试中的某个地方:
it "does something useful" do
visit root_path
fill_in "field", with: "value"
page.driver.debug(binding)
expect(page).to have_content("value")
end
执行过程中,Chrome会打开一个新的标签页,你可以在其中检查内容,如果你传入binding
,还将启动一个irb
或pry
控制台,用于进一步实验测试。
点击和滚动
page.driver.click(x, y)
- 在屏幕的非常具体区域点击。page.driver.scroll_to(left, top)
- 滚动到指定位置。element.send_keys(*keys)
- 向给定节点发送按键。
请求头
像老板一样处理HTTP请求头:
page.driver.headers # => {}
page.driver.headers = { "User-Agent" => "Cuprite" }
page.driver.add_headers("Referer" => "https://example.com")
page.driver.headers # => { "User-Agent" => "Cuprite", "Referer" => "https://example.com" }
请注意,headers=
会覆盖已设置的头部。如果你想添加一些头,应使用add_headers
方法。这些头将应用于所有后续的HTTP请求(包括资产、AJAX等请求)。在测试结束后,它们会被自动清除。
网络流量监控
page.driver.network_traffic
- 查看当前页面的网络流量(加载资源)。返回一个请求对象数组。
page.driver.network_traffic # => [Request, ...]
request = page.driver.network_traffic.first
request.response
page.driver.wait_for_network_idle
- 原生等待网络空闲,如果没有活动连接则返回或抛出TimeoutError
错误。接受与wait_for_idle
相同的选项。
page.driver.wait_for_network_idle
page.driver.refresh
请注意,网络流量在访问新页面时不被清除。你可以通过调用page.driver.clear_network_traffic
或page.driver.reset
手动清除网络流量。
page.driver.wait_for_reload
- 不同于wait_for_network_idle
,它将在整个页面重新加载后等待,否则会引发超时错误。它适用于你知道例如在点击自动补全建议后期望页面被重新加载的情况。有几种选择——放一个sleep或者等待网络空闲,但两者都不理想。Sleep会让你等待更长或更短的时间,而网络空闲可能在页面开始重新加载之前就返回。这就是解决方案。
操纵cookies
以下方法用于检查和操纵cookies:
page.driver.cookies
- 当前页面可访问的cookies的哈希表。键是cookie名称。值是Cookie
对象,具有以下方法:name
、value
、domain
、path
、size
、secure?
、httponly?
、session?
、expires
。page.driver.set_cookie(name, value, options = {})
- 设置cookie。 选项哈希可以包含以下键::domain
、:path
、:secure
、:httponly
、:expires
。:expires
应为Time
对象。page.driver.remove_cookie(name)
- 删除cookiepage.driver.clear_cookies
- 清除所有cookies
截图
除了Capybara的截图方法外,你还可以获取Base64编码的图片:
page.driver.render_base64(format, options)
认证
page.driver.basic_authorize(user, password)
代理
page.driver.set_proxy(ip, port, type, user, password)
URL 黑名单与白名单
Cuprite支持URL黑名单,使您能够阻止脚本在指定域上运行:
page.driver.browser.url_blacklist = %r{http://www.example.com}
以及URL白名单,仅允许脚本在指定域上运行:
page.driver.browser.url_whitelist = %r{http://www.example.com}
如果你发现运行速度变慢,考虑创建一个只包含关键或非关键(如广告网络或分析)域的URL白名单,或者创建一个非关键域的URL黑名单,以优化你的测试环境。
许可证
该gem作为开源软件根据MIT许可证提供。
Cuprite以其简洁高效的特性,为Ruby开发者提供了替代传统测试驱动器的新选择。无论是新手还是经验丰富的开发人员,都可以快速上手并充分利用其强大的功能,提升测试效率。现在就开始试试Cuprite,体验更加顺畅的自动化测试流程吧!
cupriteHeadless Chrome/Chromium driver for Capybara项目地址:https://gitcode.com/gh_mirrors/cu/cuprite