• This repository has been archived on 06/Jun/2018
  • Stars
    star
    408
  • Rank 105,946 (Top 3 %)
  • Language
    Ruby
  • License
    Other
  • Created over 12 years ago
  • Updated over 8 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Former watir.gem that referenced both watir-webdriver and watir-classic

Status

This code is no longer being used, and this repository exists only as an archive.

Watir

Watir, pronounced water, is an open-source (BSD) family of Ruby libraries for automating web browsers. It supports your app no matter what technology it is developed in. They support Internet Explorer on Windows, Firefox and Chrome on Windows, Mac and Linux.

About

This is the meta-gem for installing all necessary dependencies and having a convenient way to switch between different Watir drivers.

Currently supported drivers are:

Visit Watir website or refer to each gem's own README and documentation for better understanding of how to use these libraries.

Watir Related Libraries

Integration

Frameworks

Other

Usage

Add it into your Gemfile:

gem "watir", "~>4.0"

Or install it manually with the following command:

gem install watir

Then in your test file:

require "watir"
browser = Watir::Browser.new

The command above will use watir-classic with Internet Explorer on Windows and watir-webdriver with Firefox on Linux/OS X by default.

Switching Between Drivers

There are multiple ways to specify a different driver.

By specifying different browser via #initialize:

require "watir"
# will use watir-webdriver with Chrome
browser = Watir::Browser.new :chrome

By specifying driver manually via Watir.driver#=:

require "watir"
# will use watir-webdriver with Internet Explorer
Watir.driver = :webdriver
browser = Watir::Browser.new :ie

Or by using an environment variable WATIR_DRIVER:

require "watir"
# will use watir-classic
ENV["WATIR_DRIVER"] = "classic"
browser = Watir::Browser.new

Limitations

Currently it is possible to use only one driver per Ruby process. All the methods to switch between drivers won't have any effect after you've opened your first browser window.

License

See LICENSE for details.