Running your Selenium tests on a different browser tends to require additional setup, and SafariDriver is no exception.
Since Selenium 2.45.0, in order to use SafariDriver, you need to manually install the SafariDriver browser extension.
Let's step through how to do it and make sure it's working.
The prebuilt SafariDriver extension can be downloaded from here (the link is listed in the Getting Started section of the SafariDriver Selenium Wiki). Download it, double-click it, and click
Trust when prompted.
After that, make sure it's enabled. To do that:
- go to
- click on the
- Make sure
Enable WebDriveris checked
Now if we open up an interactive Ruby terminal (e.g.,
irb) and launch a Selenium instance, here's what we'd see.
> irb irb(main):001:0> require 'selenium-webdriver' irb(main):002:0> driver = Selenium::WebDriver.for :safari
A successful communication between Safari and the Selenium Driver extension has occurred.
Now let's wire up a simple test so we can see that everything works as expect.
# filename: safari.rb require 'selenium-webdriver' require 'rspec/expectations' include RSpec::Matchers def setup @driver = Selenium::WebDriver.for :safari end def teardown @driver.quit end def run setup yield teardown end run do @driver.get 'http://the-internet.herokuapp.com' expect(@driver.title).to eql 'The Internet' end
When you save the file and run it (e.g.,
ruby safari.rb from the command-line), here is what will happen:
- Safari opens
- The home page of the-internet loads
- The title of the page is checked to make sure it's what we expect
- Safari closes
Keep in mind that Safari can load without you realizing it (since it doesn't obtain focus when launching with Selenium). When that happens you'll need to switch to Safari in order to see what the test is doing.
And if you're running Safari on a remote node (or set of nodes), you'll need to install and enable the SafariDriver browser extension on each of them.