Introduction to Web Application Introduction to Web Application Testing in Ruby (WATiR)Testing in Ruby (WATiR)

Presented by Justin LongPresented by Justin Long

My IntroductionMy IntroductionFor those of you that may not know meFor those of you that may not know me• I’m currently a software architect for I’m currently a software architect for

Teleperformance USATeleperformance USA• I was recently a developer for 1-800 Contacts I was recently a developer for 1-800 Contacts

that focuses primarily on their web sitethat focuses primarily on their web site• I’m part of the leadership of the Utah .Net I’m part of the leadership of the Utah .Net

Users Group.Users Group.• I was born on Mac OS, raised by open source I was born on Mac OS, raised by open source

and adopted by Microsoft. and adopted by Microsoft.

Slides and Demo codeSlides and Demo code

• My slides and demo code will be available My slides and demo code will be available online at: online at: http://www.dukk.org/downloads.aspx http://www.dukk.org/downloads.aspx so don’t worry if you miss any linksso don’t worry if you miss any links

What is WATiR?What is WATiR?

• WWeb eb AApplication pplication TTesting esting IIn n RRubyuby

• It is library for the Ruby scripting language It is library for the Ruby scripting language used to automate Internet Explorerused to automate Internet Explorer

• It can be used to test all types of web It can be used to test all types of web applications (ASP.Net, JSP, PHP, Rails, etc…)applications (ASP.Net, JSP, PHP, Rails, etc…)

Setting up WATiRSetting up WATiR• Download the Ruby and WATiR one-click Download the Ruby and WATiR one-click

installers from: http://wtr.rubyforge.org/installers from: http://wtr.rubyforge.org/

• Steps:Steps:1.1. Install Ruby (I’ll be using version: 1.8.6-25)Install Ruby (I’ll be using version: 1.8.6-25)2.2. Install WATiR (I’ll be using version: 1.4.1)Install WATiR (I’ll be using version: 1.4.1)

You can alternatively install WATiR though GEM by You can alternatively install WATiR though GEM by typing “typing “gem install watirgem install watir”” at a command at a command line after Ruby has been installedline after Ruby has been installed

Learning WATiRLearning WATiR

I will only be chipping away at the surface in this I will only be chipping away at the surface in this presentation. I would highly recommend presentation. I would highly recommend checking out the documentation section checking out the documentation section online at http://wtr.rubyforge.org/online at http://wtr.rubyforge.org/

And for those of you that are new to Ruby the And for those of you that are new to Ruby the best place to learn is probably at best place to learn is probably at http://www.ruby-doc.org/http://www.ruby-doc.org/

Development Environments (IDE’s) Development Environments (IDE’s) for Rubyfor Ruby

• I would recommend using one of the many Ruby IDE’s I would recommend using one of the many Ruby IDE’s for your WATiR scripts. Here’s a list of some of your for your WATiR scripts. Here’s a list of some of your selection:selection:

– ScITEScITE (Free) (Free)• In the Ruby Windows installerIn the Ruby Windows installer

– Komodo IDE Komodo IDE ($295) / ($295) / Komodo Edit Komodo Edit (Free)(Free)• http://www.activestate.com/http://www.activestate.com/

– Ruby In Steel Ruby In Steel (Free - $199) (Add-on to VS.Net 2k5)(Free - $199) (Add-on to VS.Net 2k5)• http://www.sapphiresteel.com/http://www.sapphiresteel.com/

Using WATiRUsing WATiR• Using the WATiR API is very easy. Just reference the Using the WATiR API is very easy. Just reference the

WATiR API using the “require” keyword and start WATiR API using the “require” keyword and start codingcoding

require ‘watir’require ‘watir’include Watirinclude Watir

ie = ie = IE.start(“http://www.dukk.org/”)IE.start(“http://www.dukk.org/”)

……

The Watir::IE ClassThe Watir::IE Class

• This is the heart and sole of WATiR (from the This is the heart and sole of WATiR (from the users point of view)users point of view)

• Contains all the methods needed to create, Contains all the methods needed to create, navigate and “probe” the IE browser windownavigate and “probe” the IE browser window

Demo: Quick lap around my siteDemo: Quick lap around my site

Using Ruby’s Interactive Command Using Ruby’s Interactive Command Interpreter (IRB)Interpreter (IRB)

Use it to:Use it to:• Attach to IE windows and quickly identify browser Attach to IE windows and quickly identify browser

objectsobjects• Run quick experiments to see if things will work in your Run quick experiments to see if things will work in your

teststests

• irb(main):001:0> require ‘watir’irb(main):001:0> require ‘watir’• irb(main):002:0> ie = irb(main):002:0> ie = Watir::IE.attach(:title, “My Page")Watir::IE.attach(:title, “My Page")

• irb(main):003:0> ie.show_all_objectsirb(main):003:0> ie.show_all_objects

Demo: Using IRBDemo: Using IRB

• Run IRB from a command line by typing “Run IRB from a command line by typing “irbirb””

Using The Ruby Unit Testing APIUsing The Ruby Unit Testing API• Create a class that extends Test::Unit::TestCaseCreate a class that extends Test::Unit::TestCase• Defined test methods by prefixing them with Defined test methods by prefixing them with

“test”“test”• Setup your assertionsSetup your assertionsclass MyTest < Test::Unit::TestCase

def test_MyPageTest_01assert(true, “Always Passes”)

enddef test_MyPageTest_02

assert(false, “Always Fails”)end

end

TestCase Startup & TeardownTestCase Startup & Teardown• Use the startup method to get you to the page you want to test Use the startup method to get you to the page you want to test

when state matterswhen state matters• Use the teardown method to clean up, close IE, etc…Use the teardown method to clean up, close IE, etc…

def setup()def setup()@ie = Watir::IE.start(“http://myapp.com/”)@ie = Watir::IE.start(“http://myapp.com/”)@ie.link(:text, “Login”).click()@ie.link(:text, “Login”).click()

endenddef teardown()def teardown()

@ie.close()@ie.close()endend

Application DataApplication Data

• I do not recommend trying to manage the I do not recommend trying to manage the state of your applications data using the state of your applications data using the startup and teardown methods if it can be startup and teardown methods if it can be avoided!avoided!

• Use a test data source when ever possible that Use a test data source when ever possible that will allow you to simply rollback all the data at will allow you to simply rollback all the data at onceonce

Demo: Testing my site using the Demo: Testing my site using the Unit Test APIUnit Test API

Introducing FireWATiRIntroducing FireWATiR• FireWATiR is a spin off of the WATiR project that uses FireWATiR is a spin off of the WATiR project that uses

Firefox instead of IEFirefox instead of IE

• Should Should eventuallyeventually work with minimal code changes work with minimal code changes from normal WATiR scriptsfrom normal WATiR scripts

Should Should eventuallyeventually be platform independent as long be platform independent as long as Firefox works in that platform (Though it may not as Firefox works in that platform (Though it may not be supported or documented)be supported or documented)

Current limitations of FireWATiRCurrent limitations of FireWATiR• Object collections are missingObject collections are missing– No links, buttons, text_fields, etc…No links, buttons, text_fields, etc…

• It currently uses the windows registry to know It currently uses the windows registry to know how to launch Firefox so running it on other how to launch Firefox so running it on other platforms will be difficultplatforms will be difficult

Hopefully this stuff will be fixed in the near Hopefully this stuff will be fixed in the near future.future.

Setting up FireWATiRSetting up FireWATiR• Download the gem and JSSh XPI from: Download the gem and JSSh XPI from:

http://code.google.com/p/firewatir/http://code.google.com/p/firewatir/

• Install JSSh XPI (add-in) for Firefox Install JSSh XPI (add-in) for Firefox – This is how FireWATiR talks to FirefoxThis is how FireWATiR talks to Firefox

• Install the FireWATiR gemInstall the FireWATiR gem– This gem isn’t on rubyforge.org so run the gem This gem isn’t on rubyforge.org so run the gem

command from the same directory as the .gem file command from the same directory as the .gem file you downloadedyou downloaded

Using FireWATiRUsing FireWATiR

• Basically the same as WATiR only IE becomes Basically the same as WATiR only IE becomes FirefoxFirefox

require ‘firewatir’require ‘firewatir’

include FireWatirinclude FireWatir

ff = ff = Firefox.start(“http://www.dukk.org/”)Firefox.start(“http://www.dukk.org/”)

……

Demo: Quick Demo of FireWATiRDemo: Quick Demo of FireWATiR

Questions / Comments?Questions / Comments?

Contact InformationContact Information

• Feel free to contact me if you have questions, Feel free to contact me if you have questions, comments or suggestionscomments or suggestions

– Web: Web: http://www.dukk.org/http://www.dukk.org/

– Email: dukk@dukk.orgEmail: dukk@dukk.org

Thanks to our SponsorsThanks to our Sponsors