SeleniumHQ / seleniumhq.github.io

Official Selenium website and documentation
https://selenium.dev
Apache License 2.0
1.1k stars 1.29k forks source link

[🐛 Bug]: Documentation for Remote WebDriver is at odds with deprecation warning. #1366

Open v-kumar opened 1 year ago

v-kumar commented 1 year ago

What happened?

Using ruby, for remote driver, the following example gives deprecation warning.

URL: https://www.selenium.dev/documentation/webdriver/drivers/remote_webdriver/

image

image

However, it is not clear how to use Options only instead.

What browsers and operating systems are you seeing the problem on?

ruby selenium web-driver, v 4.8.x

github-actions[bot] commented 1 year ago

@v-kumar, thank you for creating this issue. We will troubleshoot it as soon as we can.


Info for maintainers

Triage this issue by using labels.

If information is missing, add a helpful comment and then I-issue-template label.

If the issue is a question, add the I-question label.

If the issue is valid but there is no time to troubleshoot it, consider adding the help wanted label.

After troubleshooting the issue, please add the R-awaiting answer label.

Thank you!

titusfortner commented 1 year ago

Yes, that code example is very much out of date.

As to the deprecation warning, instead of working with:

options = Remote::WebDriver::Capabilities.chrome

work with:

options = Options.chrome

The object has attribute accessors for each of the things you can change (#browser_version= & #platform_name=), so it should be more straightforward

v-kumar commented 1 year ago

It's not still clear how to configure the remote browser based on the above information. Is just passing browser: :remote, good enough?

  Capybara::Selenium::Driver.new app, browser: :remote, options: options,
titusfortner commented 1 year ago

I'm not a capybara expert, but this is the example code I have that works: https://github.com/saucelabs-training/demo-ruby/blob/main/selenium-examples/capybara-rspec/spec/spec_helper.rb#L16-L41

ghost commented 1 year ago

Ah yes chromus depricatus