Watir Cheat Sheet
Getting Started
Load the Watir library
require 'watir'
Open a browser (default: Internet Explorer)
browser = Watir::Browser.new
Open Browser at the specified URL
browser = Watir::Browser.start("http://google.com")
Go to a specified URL
browser.goto("http://amazon.com")
Close the browser
browser.close
Browser options (IE only)
Speed up execution(or use the "-b" command line switch)
browser.speed = :fast
Maximize browser window
browser.maximize
Pop browser window to front
browser.bring_to_front
Access an Element
Text box or text area
t = browser.text_field(:name, "username")
Button
b = browser.button(:value, "Click Here")
Drop down list
d = browser.select_list(:name, "month")
Check box
c = browser.checkbox(:name, "enabled")
Radio button
r = browser.radio(:name, "payment type")
Form
f = browser.form(:name, "address") f = browser.form(:action, "submit")
Link
l = browser.link(:url, "http://google.com") l = browser.link(:href, "http://google.com")
Table cell in a table (2nd row, 1st column)
td = browser.table(:name, 'recent_records')[2][1]
Manipulate the Element
Click a button or link
b.click l.click
Enter text in a text box
t.set("mickey mouse")
Enter multiple lines in a multi-line text box
t.set("line 1\nline2")
Set radio button or check box
c.set r.set
Clear an element
t.clear c.clear r.clear
Select an option in a drop down list
d.select "cash" d.set "cash"
Clear a drop down list
d.clearSelection
Submit a form
f.submit
Flash any element (useful from the watir-console)
e.flash
Check the Contents
Return the html of the page or any element
browser.html e.html
Return the text of the page or any element
browser.text e.text
Return the title of the document
browser.title
Get text from status bar.
browser.status => "Done"
Return true if the specified text appears on the page
browser.text.include? 'llama'
Return the contents of a table as an array
browser.table(:id, 'recent_records').to_a
