How to Work with Hovers
If you need to work with mouse hovers in your tests, it might not be obvious how to do this with Selenium. A quick search through the official Selenium documentation can also be confusing, and might leave you scouring online forums and search engines for the solution.
The most popular use case for a hover action is to display additional menu options(submenu.)
By leveraging Selenium's Actions we can handle more complex user interactions like hovers. This is done by telling Selenium which element we want to move the mouse to, and then performing what we need to after.
Our example application is available here on the-internet. It has a few avatars displayed in a grid layout. When you hover over each of them, they display additional user information and a link to view a full profile.
We're going to write a test that will hover over the first avatar and make sure that this additional information appears.
First, we'll want to include our requisite libraries (e.g.,
selenium-webdriver to control the browser, and
RSpec::Matchers for our assertion) and wire up some
# filename: hover.rb
@driver = Selenium::WebDriver.for :firefox
Now let's write our test.
an_avatar = @driver.find_element(class: 'figure')
expect(@driver.find_element(class: 'figcaption').displayed?).to eql true
After loading the page we find the first avatar and store it in a variable (
an_avatar). We then use Selenium's
action.move_to method and feed the avatar variable to it (which triggers the hover).
We then check to see if the additional user information is displayed with
.displayed? and wrap that in an assertion.
If we save this file and run it (e.g.,
ruby hover.rb from the command-line) here is what will happen:
- Open the browser
- Visit the page
- Hover over the first avatar
- Assert that the caption appeared on the page
- Close the browser
Hopefully this will help you handle more complex user interactions like hovers.
About The Author
Dave Haeffner is the original writer of Elemental Selenium -- a free, once weekly Selenium tip newsletter that's read by thousands of testing professionals. He also created and maintains the-internet (an open-source web app that's perfect for writing automated tests against).
Dave has helped numerous companies successfully implement automated acceptance testing; including The Motley Fool, ManTech International, Sittercity, and Animoto. He is also an active member of the Selenium project and has spoken at numerous conferences and meetups around the world about automated acceptance testing.