This post is based on a Learning Hour I ran at FutureLearn

Repository with instructions, exercises and tutorials


Watir WebDriver can be used to give instructions to your browser in Ruby.

Watir WebDriver is popular for testing. In this post and the exercises we focus on using Watir for interacting with websites to browse through them and read data. Watir WebDriver uses Selenium-WebDriver under the hood.

The Watir syntax is very idiomatic. Once you create an instance of a Watir browser by calling you can send it commands, such as browser.goto ''. If not run headless, which is the default, you can see a browser window and follow the executed instructions.

You can combine manual browsing with commands in Ruby. Verify how the current page, even after manual browsing is tracked by Watir. You can verify this by manually browsing to a different page from your Watir Browser window and calling browser.url.

The hardest part is often finding how to uniquely identify and access elements of interest on a site. Elements can be found by their HTML attributes, such as class, id, name, e.g. browser.button(:name => 'submit'), or by using xPath. Often there is more than one way to find information. Note that you can also ask Watir to return all types of an element on a page, e.g. browser.h1s will return all h1 headers on the present page. You can iterate over the returned results with Ruby’s built in methods, such as Array#each or String#include?.

A caveat when working with Watir WebDriver are compatibility issues with Firefox or Chrome. Firefox updates constantly and new versions might no longer work with your version of Watir WebDriver. This is usually to the underlying version of Selenium WebDriver. Constant updates from Selenium are usually quick to remedy the compatibility issues. When in doubt use an older version of Firefox with the latest version of WebDriver.

New WebDriver browser instances will open new Firefox windows as separately running programs in your dock. They have the process name firefox-bin and they can all be closed with the command $ killall firefox-bin` to avoid closing them manually.

Get started with Watir WebDriver

  • install the gem watir-webdriver. I created a repository with exercises and instructions for how to get started.
  • include the library: require 'watir-webdriver'
  • create an instance of a new browser: browser =
  • direct the browser to a url: browser.goto ''
  • Fill out a simple form:
  require 'watir-webdriver'
  browser =
  browser.goto ''
  browser.text_field(:id => 'entry_1000000').set 'your name'
  browser.select_list(:id => 'entry_1000001').select 'Ruby'
  browser.select_list(:id => 'entry_1000001').selected? 'Ruby'
  browser.button(:name => 'submit').click
  browser.text.include? 'Thank you'

  # An example from
  • Get the names of Coursera’s partners and write them to a file:
require 'watir-webdriver'
browser =
browser.goto ''

# Coursera lists they have 145 partners. 
browser.divs(class: 'partner-box-wrapper card-one-clicker flex-1').count
# => 145 indeed

# Get all partners names
scraped_list = browser.divs(class: 'partner-box-wrapper card-one-clicker flex-1').map(&:text)

class FileMaker
  require 'csv'
  attr_reader :scraped_list

  def initialize(scraped_list)
    @scraped_list = scraped_list

  def save_file"scraped_list.txt", "w+") do |file|
      file.puts scraped_list

Setup instructions

  • Download this git repository $ git clone [email protected]:neudabei/watir_learning_hour.git
  • $ cd watir_learning_hour and run $ bundle install
  • Install Firefox: (alternatively see these instructions for using Watir WebDriver with Chrome: . It requires the download of a binary which has to be put in your path.)
  • Watir documentation: and
  • Watir source code:

Further reading

  • A tutorial for interacting with Watir:
  • A freemium ebook on Watir:
  • An ebook on Watir: