ohammersmith-webrat 0.4.4.98

Sign up to get free protection for your applications and to get access to all the features.
Files changed (76) hide show
  1. data/History.txt +333 -0
  2. data/MIT-LICENSE.txt +19 -0
  3. data/README.rdoc +85 -0
  4. data/Rakefile +156 -0
  5. data/install.rb +1 -0
  6. data/lib/webrat/core/configuration.rb +98 -0
  7. data/lib/webrat/core/elements/area.rb +31 -0
  8. data/lib/webrat/core/elements/element.rb +33 -0
  9. data/lib/webrat/core/elements/field.rb +403 -0
  10. data/lib/webrat/core/elements/form.rb +103 -0
  11. data/lib/webrat/core/elements/label.rb +31 -0
  12. data/lib/webrat/core/elements/link.rb +92 -0
  13. data/lib/webrat/core/elements/select_option.rb +35 -0
  14. data/lib/webrat/core/locators/area_locator.rb +38 -0
  15. data/lib/webrat/core/locators/button_locator.rb +54 -0
  16. data/lib/webrat/core/locators/field_by_id_locator.rb +37 -0
  17. data/lib/webrat/core/locators/field_labeled_locator.rb +56 -0
  18. data/lib/webrat/core/locators/field_locator.rb +25 -0
  19. data/lib/webrat/core/locators/field_named_locator.rb +41 -0
  20. data/lib/webrat/core/locators/form_locator.rb +19 -0
  21. data/lib/webrat/core/locators/label_locator.rb +34 -0
  22. data/lib/webrat/core/locators/link_locator.rb +66 -0
  23. data/lib/webrat/core/locators/locator.rb +20 -0
  24. data/lib/webrat/core/locators/select_option_locator.rb +59 -0
  25. data/lib/webrat/core/locators.rb +20 -0
  26. data/lib/webrat/core/logging.rb +21 -0
  27. data/lib/webrat/core/matchers/have_content.rb +73 -0
  28. data/lib/webrat/core/matchers/have_selector.rb +74 -0
  29. data/lib/webrat/core/matchers/have_tag.rb +21 -0
  30. data/lib/webrat/core/matchers/have_xpath.rb +147 -0
  31. data/lib/webrat/core/matchers.rb +4 -0
  32. data/lib/webrat/core/methods.rb +61 -0
  33. data/lib/webrat/core/mime.rb +29 -0
  34. data/lib/webrat/core/save_and_open_page.rb +50 -0
  35. data/lib/webrat/core/scope.rb +350 -0
  36. data/lib/webrat/core/session.rb +281 -0
  37. data/lib/webrat/core/xml/hpricot.rb +19 -0
  38. data/lib/webrat/core/xml/nokogiri.rb +76 -0
  39. data/lib/webrat/core/xml/rexml.rb +24 -0
  40. data/lib/webrat/core/xml.rb +115 -0
  41. data/lib/webrat/core.rb +14 -0
  42. data/lib/webrat/core_extensions/blank.rb +58 -0
  43. data/lib/webrat/core_extensions/deprecate.rb +8 -0
  44. data/lib/webrat/core_extensions/detect_mapped.rb +12 -0
  45. data/lib/webrat/core_extensions/meta_class.rb +6 -0
  46. data/lib/webrat/core_extensions/nil_to_param.rb +5 -0
  47. data/lib/webrat/core_extensions/tcp_socket.rb +27 -0
  48. data/lib/webrat/mechanize.rb +74 -0
  49. data/lib/webrat/merb.rb +9 -0
  50. data/lib/webrat/merb_session.rb +65 -0
  51. data/lib/webrat/rack.rb +24 -0
  52. data/lib/webrat/rails.rb +105 -0
  53. data/lib/webrat/rspec-rails.rb +13 -0
  54. data/lib/webrat/selenium/application_server.rb +71 -0
  55. data/lib/webrat/selenium/location_strategy_javascript/button.js +12 -0
  56. data/lib/webrat/selenium/location_strategy_javascript/label.js +16 -0
  57. data/lib/webrat/selenium/location_strategy_javascript/webrat.js +5 -0
  58. data/lib/webrat/selenium/location_strategy_javascript/webratlink.js +9 -0
  59. data/lib/webrat/selenium/location_strategy_javascript/webratlinkwithin.js +15 -0
  60. data/lib/webrat/selenium/location_strategy_javascript/webratselectwithoption.js +5 -0
  61. data/lib/webrat/selenium/matchers/have_content.rb +66 -0
  62. data/lib/webrat/selenium/matchers/have_selector.rb +49 -0
  63. data/lib/webrat/selenium/matchers/have_tag.rb +72 -0
  64. data/lib/webrat/selenium/matchers/have_xpath.rb +45 -0
  65. data/lib/webrat/selenium/matchers.rb +4 -0
  66. data/lib/webrat/selenium/merb_application_server.rb +48 -0
  67. data/lib/webrat/selenium/rails_application_server.rb +42 -0
  68. data/lib/webrat/selenium/selenium_extensions.js +6 -0
  69. data/lib/webrat/selenium/selenium_rc_server.rb +80 -0
  70. data/lib/webrat/selenium/selenium_session.rb +241 -0
  71. data/lib/webrat/selenium/sinatra_application_server.rb +35 -0
  72. data/lib/webrat/selenium.rb +80 -0
  73. data/lib/webrat/sinatra.rb +44 -0
  74. data/lib/webrat.rb +34 -0
  75. data/vendor/selenium-server.jar +0 -0
  76. metadata +147 -0
@@ -0,0 +1,21 @@
1
+ require "webrat/core/matchers/have_selector"
2
+
3
+ module Webrat
4
+ module HaveTagMatcher
5
+
6
+ def have_tag(*args, &block)
7
+ have_selector(*args, &block)
8
+ end
9
+
10
+ alias_method :match_tag, :have_tag
11
+
12
+ def assert_have_tag(*args, &block)
13
+ assert_have_selector(*args, &block)
14
+ end
15
+
16
+ def assert_have_no_tag(*args, &block)
17
+ assert_have_no_selector(*args, &block)
18
+ end
19
+
20
+ end
21
+ end
@@ -0,0 +1,147 @@
1
+ require "webrat/core/xml/nokogiri"
2
+ require "webrat/core/xml/rexml"
3
+
4
+ module Webrat
5
+ module Matchers
6
+
7
+ class HaveXpath #:nodoc:
8
+ def initialize(expected, options = {}, &block)
9
+ @expected = expected
10
+ @options = options
11
+ @block = block
12
+ end
13
+
14
+ def matches?(stringlike, &block)
15
+ @block ||= block
16
+ matched = matches(stringlike)
17
+
18
+ if @options[:count]
19
+ matched.size == @options[:count] && (!@block || @block.call(matched))
20
+ else
21
+ matched.any? && (!@block || @block.call(matched))
22
+ end
23
+ end
24
+
25
+ def matches(stringlike)
26
+ if Webrat.configuration.parse_with_nokogiri?
27
+ nokogiri_matches(stringlike)
28
+ else
29
+ rexml_matches(stringlike)
30
+ end
31
+ end
32
+
33
+ def rexml_matches(stringlike)
34
+ if REXML::Node === stringlike || Array === stringlike
35
+ @query = query.map { |q| q.gsub(%r'//', './') }
36
+ else
37
+ @query = query
38
+ end
39
+
40
+ add_options_conditions_to(@query)
41
+
42
+ @document = Webrat.rexml_document(stringlike)
43
+
44
+ @query.map do |q|
45
+ if @document.is_a?(Array)
46
+ @document.map { |d| REXML::XPath.match(d, q) }
47
+ else
48
+ REXML::XPath.match(@document, q)
49
+ end
50
+ end.flatten.compact
51
+ end
52
+
53
+ def nokogiri_matches(stringlike)
54
+ if Nokogiri::XML::NodeSet === stringlike
55
+ @query = query.gsub(%r'//', './')
56
+ else
57
+ @query = query
58
+ end
59
+
60
+ add_options_conditions_to(@query)
61
+
62
+ @document = Webrat::XML.document(stringlike)
63
+ @document.xpath(*@query)
64
+ end
65
+
66
+ def add_options_conditions_to(query)
67
+ add_attributes_conditions_to(query)
68
+ add_content_condition_to(query)
69
+ end
70
+
71
+ def add_attributes_conditions_to(query)
72
+ attribute_conditions = []
73
+
74
+ @options.each do |key, value|
75
+ next if [:content, :count].include?(key)
76
+ attribute_conditions << "@#{key} = #{xpath_escape(value)}"
77
+ end
78
+
79
+ if attribute_conditions.any?
80
+ query << "[#{attribute_conditions.join(' and ')}]"
81
+ end
82
+ end
83
+
84
+ def add_content_condition_to(query)
85
+ if @options[:content]
86
+ query << "[contains(., #{xpath_escape(@options[:content])})]"
87
+ end
88
+ end
89
+
90
+ def query
91
+ @expected
92
+ end
93
+
94
+ # ==== Returns
95
+ # String:: The failure message.
96
+ def failure_message
97
+ "expected following text to match xpath #{@expected}:\n#{@document}"
98
+ end
99
+
100
+ # ==== Returns
101
+ # String:: The failure message to be displayed in negative matches.
102
+ def negative_failure_message
103
+ "expected following text to not match xpath #{@expected}:\n#{@document}"
104
+ end
105
+
106
+ protected
107
+
108
+ def xpath_escape(string)
109
+ if string.include?("'") && string.include?('"')
110
+ parts = string.split("'").map do |part|
111
+ "'#{part}'"
112
+ end
113
+
114
+ "concat(" + parts.join(", \"'\", ") + ")"
115
+ elsif string.include?("'")
116
+ "\"#{string}\""
117
+ else
118
+ "'#{string}'"
119
+ end
120
+ end
121
+
122
+ end
123
+
124
+ # Matches HTML content against an XPath query
125
+ #
126
+ # ==== Parameters
127
+ # expected<String>:: The XPath query to look for.
128
+ #
129
+ # ==== Returns
130
+ # HaveXpath:: A new have xpath matcher.
131
+ def have_xpath(expected, options = {}, &block)
132
+ HaveXpath.new(expected, options, &block)
133
+ end
134
+ alias_method :match_xpath, :have_xpath
135
+
136
+ def assert_have_xpath(expected, options = {}, &block)
137
+ hs = HaveXpath.new(expected, options, &block)
138
+ assert hs.matches?(response_body), hs.failure_message
139
+ end
140
+
141
+ def assert_have_no_xpath(expected, options = {}, &block)
142
+ hs = HaveXpath.new(expected, options, &block)
143
+ assert !hs.matches?(response_body), hs.negative_failure_message
144
+ end
145
+
146
+ end
147
+ end
@@ -0,0 +1,4 @@
1
+ require "webrat/core/matchers/have_xpath"
2
+ require "webrat/core/matchers/have_selector"
3
+ require "webrat/core/matchers/have_tag"
4
+ require "webrat/core/matchers/have_content"
@@ -0,0 +1,61 @@
1
+ module Webrat
2
+ module Methods #:nodoc:
3
+
4
+ def self.delegate_to_session(*meths)
5
+ meths.each do |meth|
6
+ self.class_eval <<-RUBY
7
+ def #{meth}(*args, &blk)
8
+ webrat_session.#{meth}(*args, &blk)
9
+ end
10
+ RUBY
11
+ end
12
+ end
13
+
14
+ def webrat
15
+ webrat_session
16
+ end
17
+
18
+ def webrat_session
19
+ @_webrat_session ||= ::Webrat.session_class.new(self)
20
+ end
21
+
22
+ # all of these methods delegate to the @session, which should
23
+ # be created transparently.
24
+ #
25
+ # Note that when using Webrat, #request also uses @session, so
26
+ # that #request and webrat native functions behave interchangably
27
+
28
+ delegate_to_session \
29
+ :visits, :visit,
30
+ :within,
31
+ :header, :http_accept, :basic_auth,
32
+ :save_and_open_page,
33
+ :fills_in, :fill_in,
34
+ :checks, :check,
35
+ :unchecks, :uncheck,
36
+ :chooses, :choose,
37
+ :selects, :select,
38
+ :attaches_file, :attach_file,
39
+ :current_page,
40
+ :current_url,
41
+ :clicks_link, :click_link,
42
+ :clicks_area, :click_area,
43
+ :clicks_button, :click_button,
44
+ :reload, :reloads,
45
+ :clicks_link_within, :click_link_within,
46
+ :field_labeled,
47
+ :select_option,
48
+ :set_hidden_field, :submit_form,
49
+ :request_page, :current_dom,
50
+ :response_body,
51
+ :selects_date, :selects_time, :selects_datetime,
52
+ :select_date, :select_time, :select_datetime,
53
+ :field_by_xpath,
54
+ :field_with_id,
55
+ :selenium,
56
+ :simulate, :automate
57
+
58
+
59
+
60
+ end
61
+ end
@@ -0,0 +1,29 @@
1
+ module Webrat #:nodoc:
2
+ module MIME #:nodoc:
3
+
4
+ def self.mime_type(string_or_symbol) #:nodoc:
5
+ if string_or_symbol.is_a?(String)
6
+ string_or_symbol
7
+ else
8
+ case string_or_symbol
9
+ when :text then "text/plain"
10
+ when :html then "text/html"
11
+ when :js then "text/javascript"
12
+ when :css then "text/css"
13
+ when :ics then "text/calendar"
14
+ when :csv then "text/csv"
15
+ when :xml then "application/xml"
16
+ when :rss then "application/rss+xml"
17
+ when :atom then "application/atom+xml"
18
+ when :yaml then "application/x-yaml"
19
+ when :multipart_form then "multipart/form-data"
20
+ when :url_encoded_form then "application/x-www-form-urlencoded"
21
+ when :json then "application/json"
22
+ else
23
+ raise ArgumentError.new("Invalid Mime type: #{string_or_symbol.inspect}")
24
+ end
25
+ end
26
+ end
27
+
28
+ end
29
+ end
@@ -0,0 +1,50 @@
1
+ module Webrat
2
+ module SaveAndOpenPage
3
+ # Saves the page out to RAILS_ROOT/tmp/ and opens it in the default
4
+ # web browser if on OS X. Useful for debugging.
5
+ #
6
+ # Example:
7
+ # save_and_open_page
8
+ def save_and_open_page
9
+ return unless File.exist?(saved_page_dir)
10
+
11
+ filename = "#{saved_page_dir}/webrat-#{Time.now.to_i}.html"
12
+
13
+ File.open(filename, "w") do |f|
14
+ f.write rewrite_css_and_image_references(response_body)
15
+ end
16
+
17
+ open_in_browser(filename)
18
+ end
19
+
20
+ def open_in_browser(path) # :nodoc
21
+ platform = ruby_platform
22
+ if platform =~ /cygwin/ || platform =~ /win32/
23
+ `rundll32 url.dll,FileProtocolHandler #{path.gsub("/", "\\\\")}`
24
+ elsif platform =~ /darwin/
25
+ `open #{path}`
26
+ end
27
+ end
28
+
29
+ def rewrite_css_and_image_references(response_html) # :nodoc:
30
+ return response_html unless doc_root
31
+ response_html.gsub(/"\/(stylesheets|images)/, doc_root + '/\1')
32
+ end
33
+
34
+ def saved_page_dir #:nodoc:
35
+ File.expand_path(".")
36
+ end
37
+
38
+ def doc_root #:nodoc:
39
+ nil
40
+ end
41
+
42
+ private
43
+
44
+ # accessor for testing
45
+ def ruby_platform
46
+ RUBY_PLATFORM
47
+ end
48
+
49
+ end
50
+ end
@@ -0,0 +1,350 @@
1
+ require "webrat/core/elements/form"
2
+ require "webrat/core/locators"
3
+ require "webrat/core_extensions/deprecate"
4
+
5
+ module Webrat
6
+ # An HTML element (link, button, field, etc.) that Webrat expected was not found on the page
7
+ class NotFoundError < WebratError
8
+ end
9
+
10
+ class Scope
11
+ include Logging
12
+ include Locators
13
+
14
+ def self.from_page(session, response, response_body) #:nodoc:
15
+ new(session) do
16
+ @response = response
17
+ @response_body = response_body
18
+ end
19
+ end
20
+
21
+ def self.from_scope(session, scope, selector) #:nodoc:
22
+ new(session) do
23
+ @scope = scope
24
+ @selector = selector
25
+ end
26
+ end
27
+
28
+ attr_reader :session
29
+
30
+ def initialize(session, &block) #:nodoc:
31
+ @session = session
32
+ instance_eval(&block) if block_given?
33
+
34
+ if @selector && scoped_dom.nil?
35
+ raise Webrat::NotFoundError.new("The scope was not found on the page: #{@selector.inspect}")
36
+ end
37
+ end
38
+
39
+ # Verifies an input field or textarea exists on the current page, and stores a value for
40
+ # it which will be sent when the form is submitted.
41
+ #
42
+ # Examples:
43
+ # fill_in "Email", :with => "user@example.com"
44
+ # fill_in "user[email]", :with => "user@example.com"
45
+ #
46
+ # The field value is required, and must be specified in <tt>options[:with]</tt>.
47
+ # <tt>field</tt> can be either the value of a name attribute (i.e. <tt>user[email]</tt>)
48
+ # or the text inside a <tt><label></tt> element that points at the <tt><input></tt> field.
49
+ def fill_in(field_locator, options = {})
50
+ field = locate_field(field_locator, TextField, TextareaField, PasswordField)
51
+ field.raise_error_if_disabled
52
+ field.set(options[:with])
53
+ end
54
+
55
+ webrat_deprecate :fills_in, :fill_in
56
+
57
+ # Verifies that a hidden field exists on the current page and sets
58
+ # the value to that given by the <tt>:to</tt> option.
59
+ #
60
+ # Example:
61
+ # set_hidden_field 'user_id', :to => 1
62
+ def set_hidden_field(field_locator, options = {})
63
+ field = locate_field(field_locator, HiddenField)
64
+ field.set(options[:to])
65
+ end
66
+
67
+ # Verifies that an input checkbox exists on the current page and marks it
68
+ # as checked, so that the value will be submitted with the form.
69
+ #
70
+ # Example:
71
+ # check 'Remember Me'
72
+ def check(field_locator)
73
+ locate_field(field_locator, CheckboxField).check
74
+ end
75
+
76
+ webrat_deprecate :checks, :check
77
+
78
+ # Verifies that an input checkbox exists on the current page and marks it
79
+ # as unchecked, so that the value will not be submitted with the form.
80
+ #
81
+ # Example:
82
+ # uncheck 'Remember Me'
83
+ def uncheck(field_locator)
84
+ locate_field(field_locator, CheckboxField).uncheck
85
+ end
86
+
87
+ webrat_deprecate :unchecks, :uncheck
88
+
89
+ # Verifies that an input radio button exists on the current page and marks it
90
+ # as checked, so that the value will be submitted with the form.
91
+ #
92
+ # Example:
93
+ # choose 'First Option'
94
+ def choose(field_locator)
95
+ locate_field(field_locator, RadioField).choose
96
+ end
97
+
98
+ webrat_deprecate :chooses, :choose
99
+
100
+ # Verifies that a an option element exists on the current page with the specified
101
+ # text. You can optionally restrict the search to a specific select list by
102
+ # assigning <tt>options[:from]</tt> the value of the select list's name or
103
+ # a label. Stores the option's value to be sent when the form is submitted.
104
+ #
105
+ # Examples:
106
+ # select "January"
107
+ # select "February", :from => "event_month"
108
+ # select "February", :from => "Event Month"
109
+ def select(option_text, options = {})
110
+ select_option(option_text, options[:from]).choose
111
+ end
112
+
113
+ webrat_deprecate :selects, :select
114
+
115
+ DATE_TIME_SUFFIXES = {
116
+ :year => '1i',
117
+ :month => '2i',
118
+ :day => '3i',
119
+ :hour => '4i',
120
+ :minute => '5i'
121
+ }
122
+
123
+ # Verifies that date elements (year, month, day) exist on the current page
124
+ # with the specified values. You can optionally restrict the search to a specific
125
+ # date's elements by assigning <tt>options[:from]</tt> the value of the date's
126
+ # label. Selects all the date elements with date provided. The date provided may
127
+ # be a string or a Date/Time object.
128
+ #
129
+ # Rail's convention is used for detecting the date elements. All elements
130
+ # are assumed to have a shared prefix. You may also specify the prefix
131
+ # by assigning <tt>options[:id_prefix]</tt>.
132
+ #
133
+ # Examples:
134
+ # select_date "January 23, 2004"
135
+ # select_date "April 26, 1982", :from => "Birthday"
136
+ # select_date Date.parse("December 25, 2000"), :from => "Event"
137
+ # select_date "April 26, 1982", :id_prefix => 'birthday'
138
+ def select_date(date_to_select, options ={})
139
+ date = date_to_select.is_a?(Date) || date_to_select.is_a?(Time) ?
140
+ date_to_select : Date.parse(date_to_select)
141
+
142
+ id_prefix = locate_id_prefix(options) do
143
+ year_field = FieldByIdLocator.new(@session, dom, /(.*?)_#{DATE_TIME_SUFFIXES[:year]}$/).locate
144
+ raise NotFoundError.new("No date fields were found") unless year_field && year_field.id =~ /(.*?)_1i/
145
+ $1
146
+ end
147
+
148
+ select date.year, :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:year]}"
149
+ select date.strftime('%B'), :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:month]}"
150
+ select date.day, :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:day]}"
151
+ end
152
+
153
+ webrat_deprecate :selects_date, :select_date
154
+
155
+ # Verifies that time elements (hour, minute) exist on the current page
156
+ # with the specified values. You can optionally restrict the search to a specific
157
+ # time's elements by assigning <tt>options[:from]</tt> the value of the time's
158
+ # label. Selects all the time elements with date provided. The time provided may
159
+ # be a string or a Time object.
160
+ #
161
+ # Rail's convention is used for detecting the time elements. All elements are
162
+ # assumed to have a shared prefix. You may specify the prefix by assigning
163
+ # <tt>options[:id_prefix]</tt>.
164
+ #
165
+ # Note: Just like Rails' time_select helper this assumes the form is using
166
+ # 24 hour select boxes, and not 12 hours with AM/PM.
167
+ #
168
+ # Examples:
169
+ # select_time "9:30"
170
+ # select_date "3:30PM", :from => "Party Time"
171
+ # select_date Time.parse("10:00PM"), :from => "Event"
172
+ # select_date "10:30AM", :id_prefix => 'meeting'
173
+ def select_time(time_to_select, options ={})
174
+ time = time_to_select.is_a?(Time) ? time_to_select : Time.parse(time_to_select)
175
+
176
+ id_prefix = locate_id_prefix(options) do
177
+ hour_field = FieldByIdLocator.new(@session, dom, /(.*?)_#{DATE_TIME_SUFFIXES[:hour]}$/).locate
178
+ raise NotFoundError.new("No time fields were found") unless hour_field && hour_field.id =~ /(.*?)_4i/
179
+ $1
180
+ end
181
+
182
+ select time.hour.to_s.rjust(2,'0'), :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:hour]}"
183
+ select time.min.to_s.rjust(2,'0'), :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:minute]}"
184
+ end
185
+
186
+ webrat_deprecate :selects_time, :select_time
187
+
188
+ # Verifies and selects all the date and time elements on the current page.
189
+ # See #select_time and #select_date for more details and available options.
190
+ #
191
+ # Examples:
192
+ # select_datetime "January 23, 2004 10:30AM"
193
+ # select_datetime "April 26, 1982 7:00PM", :from => "Birthday"
194
+ # select_datetime Time.parse("December 25, 2000 15:30"), :from => "Event"
195
+ # select_datetime "April 26, 1982 5:50PM", :id_prefix => 'birthday'
196
+ def select_datetime(time_to_select, options ={})
197
+ time = time_to_select.is_a?(Time) ? time_to_select : Time.parse(time_to_select)
198
+
199
+ options[:id_prefix] ||= (options[:from] ? FieldByIdLocator.new(@session, dom, options[:from]).locate : nil)
200
+
201
+ select_date time, options
202
+ select_time time, options
203
+ end
204
+
205
+ webrat_deprecate :selects_datetime, :select_datetime
206
+
207
+ # Verifies that an input file field exists on the current page and sets
208
+ # its value to the given +file+, so that the file will be uploaded
209
+ # along with the form. An optional <tt>content_type</tt> may be given.
210
+ #
211
+ # Example:
212
+ # attaches_file "Resume", "/path/to/the/resume.txt"
213
+ # attaches_file "Photo", "/path/to/the/image.png", "image/png"
214
+ def attach_file(field_locator, path, content_type = nil)
215
+ locate_field(field_locator, FileField).set(path, content_type)
216
+ end
217
+
218
+ webrat_deprecate :attaches_file, :attach_file
219
+
220
+ # Issues a request for the URL pointed to by an <tt>area</tt> tag
221
+ # on the current page, follows any redirects, and verifies the
222
+ # final page load was successful.
223
+ #
224
+ # The area used is the first area whose title or id contains the
225
+ # given +area_name+ (case is ignored).
226
+ #
227
+ # Example:
228
+ # click_area 'Australia'
229
+ def click_area(area_name)
230
+ find_area(area_name).click
231
+ end
232
+
233
+ webrat_deprecate :clicks_area, :click_area
234
+
235
+ # Issues a request for the URL pointed to by a link on the current page,
236
+ # follows any redirects, and verifies the final page load was successful.
237
+ #
238
+ # click_link has very basic support for detecting Rails-generated
239
+ # JavaScript onclick handlers for PUT, POST and DELETE links, as well as
240
+ # CSRF authenticity tokens if they are present.
241
+ #
242
+ # Javascript imitation can be disabled by passing the option :javascript => false
243
+ #
244
+ # Passing a :method in the options hash overrides the HTTP method used
245
+ # for making the link request
246
+ #
247
+ # It will try to find links by (in order of precedence):
248
+ # innerHTML, with simple &nbsp; handling
249
+ # title
250
+ # id
251
+ #
252
+ # innerHTML and title are matchable by text subtring or Regexp
253
+ # id is matchable by full text equality or Regexp
254
+ #
255
+ # Example:
256
+ # click_link "Sign up"
257
+ # click_link "Sign up", :javascript => false
258
+ # click_link "Sign up", :method => :put
259
+ def click_link(text_or_title_or_id, options = {})
260
+ find_link(text_or_title_or_id).click(options)
261
+ end
262
+
263
+ webrat_deprecate :clicks_link, :click_link
264
+
265
+ # Verifies that a submit button exists for the form, then submits the form, follows
266
+ # any redirects, and verifies the final page was successful.
267
+ #
268
+ # Example:
269
+ # click_button "Login"
270
+ # click_button
271
+ #
272
+ # The URL and HTTP method for the form submission are automatically read from the
273
+ # <tt>action</tt> and <tt>method</tt> attributes of the <tt><form></tt> element.
274
+ def click_button(value = nil)
275
+ find_button(value).click
276
+ end
277
+
278
+ webrat_deprecate :clicks_button, :click_button
279
+
280
+ # Submit the form with the given id.
281
+ #
282
+ # Note that +click_button+ is usually preferrable for simulating
283
+ # form submissions, as you may specify part of the button text
284
+ # rather than the form id.
285
+ #
286
+ # Example:
287
+ # submit_form 'login'
288
+ def submit_form(id)
289
+ FormLocator.new(@session, dom, id).locate.submit
290
+ end
291
+
292
+ def dom # :nodoc:
293
+ return @dom if @dom
294
+
295
+ if @selector
296
+ @dom = scoped_dom
297
+ else
298
+ @dom = page_dom
299
+ end
300
+
301
+ return @dom
302
+ end
303
+
304
+ protected
305
+
306
+ def page_dom #:nodoc:
307
+ return @response.dom if @response.respond_to?(:dom)
308
+
309
+ if @session.xml_content_type?
310
+ dom = Webrat::XML.xml_document(@response_body)
311
+ else
312
+ dom = Webrat::XML.html_document(@response_body)
313
+ end
314
+
315
+ Webrat.define_dom_method(@response, dom)
316
+ return dom
317
+ end
318
+
319
+ def scoped_dom
320
+ Webrat::XML.css_at(@scope.dom, @selector)
321
+ end
322
+
323
+ def locate_field(field_locator, *field_types) #:nodoc:
324
+ if field_locator.is_a?(Field)
325
+ field_locator
326
+ else
327
+ field(field_locator, *field_types)
328
+ end
329
+ end
330
+
331
+ def locate_id_prefix(options, &location_strategy) #:nodoc:
332
+ return options[:id_prefix] if options[:id_prefix]
333
+
334
+ if options[:from]
335
+ if (label = LabelLocator.new(@session, dom, options[:from]).locate)
336
+ label.for_id
337
+ else
338
+ raise NotFoundError.new("Could not find the label with text #{options[:from]}")
339
+ end
340
+ else
341
+ yield
342
+ end
343
+ end
344
+
345
+ def forms #:nodoc:
346
+ @forms ||= Form.load_all(@session, dom)
347
+ end
348
+
349
+ end
350
+ end