watir-webdriver

Watir implementation built on WebDriver's Ruby bindings. See introduction mail.

Example

require 'watir-webdriver'

browser = Watir::Browser.new :firefox
browser.goto "http://google.com"
browser.text_field(name: 'q').set("WebDriver rocks!")
browser.button(name: 'btnG').click
puts browser.url
browser.close

Description

The majority of element methods Watir provides with is autogenerated from specifications. This is done by extracting the IDL parts from the spec and processing them with the WebIDL gem (link below). Currently supported specifications are:

HTML (lib/watir-webdriver/elements/html_generated.rb)
SVG (lib/watir-webdriver/elements/svg_generated.rb)

Specs

watir-webdriver uses watirspec for testing. After cloning, you should fetch the submodule:

git submodule init && git submodule update

Specs specific to watir-webdriver are found in spec/*_spec.rb, with watirspec in spec/watirspec/.

Doctests

watir-webdriver uses yard-doctest for testing documentation examples.

rake yard:doctest

API docs

http://rdoc.info/gems/watir-webdriver/ (updated on every release)

Dependencies

selenium-webdriver

Note on Patches/Pull Requests

Fork the project.
Make your feature addition or bug fix.
Add tests for it. This is important so I don't break it in a future version unintentionally.
Commit, do not mess with Rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
Send me a pull request. Bonus points for topic branches.