Class: Webrat::SeleniumSession

Inherits:
Object
  • Object
show all
Includes:
SaveAndOpenPage, Webrat::Selenium::SilenceStream
Defined in:
lib/webrat/selenium/selenium_session.rb

Instance Method Summary collapse

Methods included from Webrat::Selenium::SilenceStream

#silence_stream

Methods included from SaveAndOpenPage

#doc_root, #open_in_browser, #rewrite_css_and_image_references, #save_and_open_page, #saved_page_dir

Constructor Details

#initialize(*args) ⇒ SeleniumSession

:nodoc:



28
29
 
# File 'lib/webrat/selenium/selenium_session.rb', line 28

def initialize(*args) # :nodoc:
end

Instance Method Details

#automate ⇒ Object 



34
35
36
 
# File 'lib/webrat/selenium/selenium_session.rb', line 34

def automate
  yield
end

#check(label_text) ⇒ Object Also known as: uncheck 



119
120
121
122
123
 
# File 'lib/webrat/selenium/selenium_session.rb', line 119

def check(label_text)
  locator = "webrat=#{label_text}"
  selenium.wait_for_element locator, :timeout_in_seconds => Webrat.configuration.selenium_timeout
  selenium.click locator
end

#choose(label_text) ⇒ Object 



111
112
113
114
115
 
# File 'lib/webrat/selenium/selenium_session.rb', line 111

def choose(label_text)
  locator = "webrat=#{label_text}"
  selenium.wait_for_element locator, :timeout_in_seconds => Webrat.configuration.selenium_timeout
  selenium.click locator
end

#click_button(button_text_or_regexp = nil, options = {}) ⇒ Object 



64
65
66
67
68
69
70
71
72
73
74
75
 
# File 'lib/webrat/selenium/selenium_session.rb', line 64

def click_button(button_text_or_regexp = nil, options = {})
  if button_text_or_regexp.is_a?(Hash) && options == {}
    pattern, options = nil, button_text_or_regexp
  elsif button_text_or_regexp
    pattern = adjust_if_regexp(button_text_or_regexp)
  end
  pattern ||= '*'
  locator = "button=#{pattern}"

  selenium.wait_for_element locator, :timeout_in_seconds => Webrat.configuration.selenium_timeout
  selenium.click locator
end

#click_link(link_text_or_regexp, options = {}) ⇒ Object 



79
80
81
82
83
84
 
# File 'lib/webrat/selenium/selenium_session.rb', line 79

def click_link(link_text_or_regexp, options = {})
  pattern = adjust_if_regexp(link_text_or_regexp)
  locator = "webratlink=#{pattern}"
  selenium.wait_for_element locator, :timeout_in_seconds => Webrat.configuration.selenium_timeout
  selenium.click locator
end

#click_link_within(selector, link_text, options = {}) ⇒ Object 



88
89
90
91
92
 
# File 'lib/webrat/selenium/selenium_session.rb', line 88

def click_link_within(selector, link_text, options = {})
  locator = "webratlinkwithin=#{selector}|#{link_text}"
  selenium.wait_for_element locator, :timeout_in_seconds => Webrat.configuration.selenium_timeout
  selenium.click locator
end

#current_url ⇒ Object 



60
61
62
 
# File 'lib/webrat/selenium/selenium_session.rb', line 60

def current_url
  selenium.location
end

#fill_in(field_identifier, options) ⇒ Object 



44
45
46
47
48
 
# File 'lib/webrat/selenium/selenium_session.rb', line 44

def fill_in(field_identifier, options)
  locator = "webrat=#{field_identifier}"
  selenium.wait_for_element locator, :timeout_in_seconds => Webrat.configuration.selenium_timeout
  selenium.type(locator, "#{options[:with]}")
end

#fire_event(field_identifier, event) ⇒ Object 



128
129
130
131
 
# File 'lib/webrat/selenium/selenium_session.rb', line 128

def fire_event(field_identifier, event)
  locator = "webrat=#{Regexp.escape(field_identifier)}"
  selenium.fire_event(locator, "#{event}")
end

#key_down(field_identifier, key_code) ⇒ Object 



133
134
135
136
 
# File 'lib/webrat/selenium/selenium_session.rb', line 133

def key_down(field_identifier, key_code)
  locator = "webrat=#{Regexp.escape(field_identifier)}"
  selenium.key_down(locator, key_code)
end

#key_up(field_identifier, key_code) ⇒ Object 



138
139
140
141
 
# File 'lib/webrat/selenium/selenium_session.rb', line 138

def key_up(field_identifier, key_code)
  locator = "webrat=#{Regexp.escape(field_identifier)}"
  selenium.key_up(locator, key_code)
end

#response ⇒ Object 



52
53
54
 
# File 'lib/webrat/selenium/selenium_session.rb', line 52

def response
  SeleniumResponse.new(self, response_body)
end

#response_body ⇒ Object

:nodoc:



56
57
58
 
# File 'lib/webrat/selenium/selenium_session.rb', line 56

def response_body #:nodoc:
  selenium.get_html_source
end

#save_and_open_screengrab ⇒ Object 



178
179
180
181
182
183
184
185
186
187
188
189
190
 
# File 'lib/webrat/selenium/selenium_session.rb', line 178

def save_and_open_screengrab
  return unless File.exist?(saved_page_dir)

  filename = "#{saved_page_dir}/webrat-#{Time.now.to_i}.png"

  if $browser.chrome_backend?
    $browser.capture_entire_page_screenshot(filename, '')
  else
    $browser.capture_screenshot(filename)
  end
  open_in_browser(filename)

end

#select(option_text, options = {}) ⇒ Object 



96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/webrat/selenium/selenium_session.rb', line 96

def select(option_text, options = {})
  id_or_name_or_label = options[:from]

  if id_or_name_or_label
    select_locator = "webrat=#{id_or_name_or_label}"
  else
    select_locator = "webratselectwithoption=#{option_text}"
  end

  selenium.wait_for_element select_locator, :timeout_in_seconds => Webrat.configuration.selenium_timeout
  selenium.select(select_locator, option_text)
end

#selenium ⇒ Object 



169
170
171
172
173
 
# File 'lib/webrat/selenium/selenium_session.rb', line 169

def selenium
  return $browser if $browser
  setup
  $browser
end

#simulate ⇒ Object 



31
32
 
# File 'lib/webrat/selenium/selenium_session.rb', line 31

def simulate
end

#visit(url) ⇒ Object 



38
39
40
 
# File 'lib/webrat/selenium/selenium_session.rb', line 38

def visit(url)
  selenium.open(url)
end

#wait_for(params = {}) ⇒ Object

Raises:



143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
 
# File 'lib/webrat/selenium/selenium_session.rb', line 143

def wait_for(params={})
  timeout = params[:timeout] || Webrat.configuration.selenium_timeout
  message = params[:message] || "Timeout exceeded"

  begin_time = Time.now

  while (Time.now - begin_time) < timeout
    value = nil

    begin
      value = yield
    rescue Exception => e
      unless is_ignorable_wait_for_exception?(e)
        raise e
      end
    end

    return value if value

    sleep 0.25
  end

  raise Webrat::TimeoutError.new(message + " (after #{timeout} sec)")
  true
end