capybara + seleniumの設定でdesired_capabilities/options属性がDEPRECATIONになった

遭遇したWARNING

ruby3.0 対応のため selenium-webdriver を 4.0.0.beta3 にアップデートしたところ、次のような DEPRECATION WARNING が発生しました。

[DEPRECATION] [:desired_capabilities] :desired_capabilities as a parameter for driver initialization is deprecated. Use :capabilities with an Array value of capabilities/options if necessary instead.

関連するPRはこちらのようです。

要約すると、 :desired_capabilities 属性と :options 属性をどう使いわければよいか判断に迷うので、 :capabilities 属性に統一するとのことです。

Capybaraの設定

以下は、Capybaraの設定の修正例です。

Capybara.register_driver :remote_chrome do |app|
  url = 'http://chrome:4444/wd/hub'
  capabilities = Selenium::WebDriver::Remote::Capabilities.chrome(
    'goog:chromeOptions' => {
      'args' => ['headless', 'disable-gpu', 'window-size=1920,1080'],
    },
  )
-  Capybara::Selenium::Driver.new(app, browser: :remote, url: url, desired_capabilities: capabilities)
+  Capybara::Selenium::Driver.new(app, browser: :remote, url: url, capabilities: capabilities)
end

これで、WARNINGが発生しなくなりました。