Class: Webrat::SeleniumSession

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

Instance Method Summary collapse

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:



24
25
 
# File 'lib/webrat/selenium/selenium_session.rb', line 24

def initialize(*args) # :nodoc:
end

Instance Method Details

#automate ⇒ Object 



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

def automate
  yield
end

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



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

def check(label_text)
  locator = "webrat=#{label_text}"
  selenium.wait_for_element locator, 5
  selenium.click locator
end

#choose(label_text) ⇒ Object 



103
104
105
106
107
 
# File 'lib/webrat/selenium/selenium_session.rb', line 103

def choose(label_text)
  locator = "webrat=#{label_text}"
  selenium.wait_for_element locator, 5
  selenium.click locator
end

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



56
57
58
59
60
61
62
63
64
65
66
67
 
# File 'lib/webrat/selenium/selenium_session.rb', line 56

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, 5
  selenium.click locator
end

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



71
72
73
74
75
76
 
# File 'lib/webrat/selenium/selenium_session.rb', line 71

def click_link(link_text_or_regexp, options = {})
  pattern = adjust_if_regexp(link_text_or_regexp)
  locator = "webratlink=#{pattern}"
  selenium.wait_for_element locator, 5
  selenium.click locator
end

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



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

def click_link_within(selector, link_text, options = {})
  locator = "webratlinkwithin=#{selector}|#{link_text}"
  selenium.wait_for_element locator, 5
  selenium.click locator
end

#fill_in(field_identifier, options) ⇒ Object 



40
41
42
43
44
 
# File 'lib/webrat/selenium/selenium_session.rb', line 40

def fill_in(field_identifier, options)
  locator = "webrat=#{Regexp.escape(field_identifier)}"
  selenium.wait_for_element locator, 5
  selenium.type(locator, "#{options[:with]}")
end

#fire_event(field_identifier, event) ⇒ Object 



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

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 



125
126
127
128
 
# File 'lib/webrat/selenium/selenium_session.rb', line 125

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 



130
131
132
133
 
# File 'lib/webrat/selenium/selenium_session.rb', line 130

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

#response ⇒ Object 



48
49
50
 
# File 'lib/webrat/selenium/selenium_session.rb', line 48

def response
  SeleniumResponse.new(self, response_body)
end

#response_body ⇒ Object

:nodoc:



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

def response_body #:nodoc:
  selenium.get_html_source
end

#save_and_open_screengrab ⇒ Object 



168
169
170
171
172
173
174
175
176
177
178
179
 
# File 'lib/webrat/selenium/selenium_session.rb', line 168

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 



88
89
90
91
92
93
94
95
96
97
98
99
 
# File 'lib/webrat/selenium/selenium_session.rb', line 88

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, 5
  selenium.select(select_locator, option_text)
end

#selenium ⇒ Object 



159
160
161
162
163
 
# File 'lib/webrat/selenium/selenium_session.rb', line 159

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

#simulate ⇒ Object 



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

def simulate
end

#visit(url) ⇒ Object 



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

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

#wait_for(params = {}) ⇒ Object

Raises:



135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
 
# File 'lib/webrat/selenium/selenium_session.rb', line 135

def wait_for(params={})
  timeout = params[:timeout] || 5
  message = params[:message] || "Timeout exceeded"

  begin_time = Time.now

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

    begin
      value = yield
    rescue ::Spec::Expectations::ExpectationNotMetError, ::Selenium::CommandError, Webrat::WebratError
      value = nil
    end

    return value if value

    sleep 0.25
  end

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