This document summarizes Webrat, a tool for testing web applications in Ruby. Webrat allows automating navigation, filling forms, and making assertions on pages. It supports actions like clicking links, selecting options, attaching files, and checking for elements on pages. Webrat configurations can set the parsing library and redirect limits. When used for test-driven development, Webrat helps design, develop, and build automated regression tests for web applications.

1. Acceptance Testing
with Webrat
Luismi Cavallé
http://twitter.com/cavalle
http://lmcavalle.com
http://spainrb.org/luismi-cavalle

2. Demo

3. Internals

5. Webrat
#get #post #head #delete ...
#put #request #follow_redirect!
ActionController:: Nokogiri
Integration::
Session

6. Rails Integration Test
test "Hotel creation" do
get "/hotels"
assert_select "body", :text => /Ritz/, :count => 0
get "/hotels/new"
post_via_redirect "/hotels",
:hotel => { :name => "Ritz" }
assert_response :success
assert_select "body", /Hotel was successfully created/
assert_select "body", /Ritz/
end

7. Webrat
#get #post #head #delete ...
#put #request #follow_redirect!
Hpricot + REXML
Rack::Test

8. click_link
def click_link(text_or_title_or_id, options = {})
find_link(text_or_title_or_id).click(options)
end

9. click_link
def find_link(text_or_title_or_id) #:nodoc:
LinkLocator.new(@session, dom, text_or_title_or_id).locate!
end

10. click_link
def locate
Link.load(@session, link_element)
end

11. click_link
def link_element
matching_links.min { |a, b|
Webrat::XML.all_inner_text(a).length <=>
Webrat::XML.all_inner_text(b).length }
end

12. click_link
def matching_links
@matching_links ||= link_elements.select do |link_element|
matches_text?(link_element) ||
matches_id?(link_element)
end
end

13. click_link
def link_elements
Webrat::XML.xpath_search(@dom, *Link.xpath_search)
end

14. click_link
def self.xpath_search
".//a[@href]"
end

15. click_link
def self.xpath_search(element, *searches)
searches.flatten.map do |search|
if Webrat.configuration.parse_with_nokogiri?
element.xpath(search)
else
REXML::XPath.match(element, search)
end
end.flatten.compact
end

16. click_link
def matching_links
@matching_links ||= link_elements.select do |link_element|
matches_text?(link_element) ||
matches_id?(link_element)
end
end

17. click_link
def matches_text?(link)
if @value.is_a?(Regexp)
matcher = @value
else
matcher = /#{Regexp.escape(@value.to_s)}/i
end
replace_nbsp(Webrat::XML.all_inner_text(link)) =~ matcher ||
replace_nbsp_ref(Webrat::XML.inner_html(link)) =~ matcher ||
Webrat::XML.attribute(link, "title")=~ matcher
end

18. click_link
def matches_id?(link)
if @value.is_a?(Regexp)
(Webrat::XML.attribute(link, "id") =~ @value) ? true : false
else
(Webrat::XML.attribute(link, "id") == @value) ? true : false
end
end

19. click_link
def link_element
matching_links.min { |a, b|
Webrat::XML.all_inner_text(a).length <=>
Webrat::XML.all_inner_text(b).length }
end

20. click_link
def locate
Link.load(@session, link_element)
end

21. click_link
def click_link(text_or_title_or_id, options = {})
find_link(text_or_title_or_id).click(options)
end

22. click_link
def click(options = {})
method = options[:method] || http_method
return if href =~ /^#/ && method == :get
options[:javascript] = true if options[:javascript].nil?
if options[:javascript]
@session.request_page(absolute_href, method, data)
else
@session.request_page(absolute_href, :get, {})
end
end

24. API

25. Navigation
visit "/hotels/new"
visit hotels_path

26. Navigation
click_link "Create a new hotel"

27. Navigation
click_area 'Madrid'

28. Forms
select "Canada", :from => "Country"
select "Canada"

29. Forms

30. Forms
select_date "April 26, 1982", :from => "Birthday"
select_date Date.today
select_datetime 2.days.ago
select_datetime "April 26, 1982 7:00PM", :from => "Event"
select_time "22:30"
select_time "1:30AM", :from => "Arrival time"

31. Forms
select_date "April 26, 1982", :from => "Birthday"
select_date Date.today
select_datetime 2.days.ago
select_datetime "April 26, 1982 7:00PM", :from => "Event"
select_time "22:30"
select_time "1:30AM", :from => "Arrival time"

32. Forms
select_date "April 26, 1982", :from => "Birthday"
select_date Date.today
select_datetime 2.days.ago
select_datetime "April 26, 1982 7:00PM", :from => "Event"
select_time "22:30"
select_time "1:30AM", :from => "Arrival time"

33. Forms
select_date "April 26, 1982", :from => "Birthday"
select_date Date.today
select_datetime 2.days.ago
select_datetime "April 26, 1982 7:00PM", :from => "Event"
select_time "22:30"
select_time "1:30AM", :from => "Arrival time"

34. Forms
select_date "April 26, 1982", :from => "Birthday"
select_date Date.today
select_datetime 2.days.ago
select_datetime "April 26, 1982 7:00PM", :from => "Event"
select_time "22:30"
select_time "1:30AM", :from => "Arrival time"

35. Forms
select_date "April 26, 1982", :from => "Birthday"
select_date Date.today
select_datetime 2.days.ago
select_datetime "April 26, 1982 7:00PM", :from => "Event"
select_time "22:30"
select_time "1:30AM", :from => "Arrival time"

36. Forms
select_date "April 26, 1982", :from => "Birthday"
select_date Date.today
select_datetime 2.days.ago
select_datetime "April 26, 1982 7:00PM", :from => "Event"
select_time "22:30"
select_time "1:30AM", :from => "Arrival time"

37. Forms
select_date "April 26, 1982", :from => "Birthday"
select_date Date.today
select_datetime 2.days.ago
select_datetime "April 26, 1982 7:00PM", :from => "Event"
select_time "22:30"
select_time "1:30AM", :from => "Arrival time"

38. Forms
attach_file "Brochure", "/path/nh_cornella.pdf"
attach_file "Photo", "/path/front.jpg", "image/jpg"

39. Forms
check 'Remember me'
uncheck 'You can send me spam'

40. Forms
fill_in "Email", :with => "user@example.com"
fill_in "user[email]", :with => "user@example.com"

41. Forms
click_button "Login"
click_button

42. And more...
basic_auth "admin", "password"
save_and_open_page

43. And more...
within "#project_1" do
click_link "Destroy"
end

44. Matchers
assert_contain "Hotel was successfully created"
assert_not_contain(/You have booked for d+ nights/)

45. Matchers
assert_have_selector "div#hotel_1",
:content => "Sol Meliá Berlín"
assert_have_selector ".bookings", :count => 5
assert_have_no_selector "a:enabled",
:href => "http://google.com"

46. Matchers
assert_have_xpath "//div[@id = 'hotel_1']",
:content => "Sol Meliá Berlín"
assert_have_xpath "//*[@class = 'bookings']",
:count => 5
assert_have_no_xpath "//a[enabled(.)]",
:href => "http://google.com"

47. Matchers
response.should contain(/You have booked for d+ nights/)
response.should_not have_selector(".bookings", :count => 5)

48. Matchers
response.should have_selector(".hotels") do |hotels|
hotels.should have_selector("h2", :content => "Hotels")
hotels.should have_xpath("//div[@id = 'hotel_1']",
:content => "Ritz")
end

49. Configuration

50. Webrat.configure do |config|
config.parse_with_nokogiri = true
config.infinite_redirect_limit = 10
config.open_error_files = true
end

51. Webrat.configure do |config|
config.mode = :rails | :merb | :sinatra |
:rack_test |
:mechanize | :selenium
end

53. TDD Benefits
★ Driving the design and
development
★ Building a suite of automated
regression tests

54. http://www.flickr.com/photos/icopythat/4375608/

55. Gracias!
http://wiki.github.com/brynary/webrat
http://gitrdoc.com/brynary/webrat/tree/master/
http://twitter.com/cavalle
http://lmcavalle.com
http://spainrb.org/luismi-cavalle