Cheat Sheet

Use this section as a quick reference to common Watir tasks.

Getting Started

Load the Watir library

   require 'watir'

Open a browser

   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

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]

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

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

##Browser options

These can only be used with the watir-classic gem (watir version < 4.0) on Internet Explorer.

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