Class: Capybara::Selenium::Driver

Inherits:
Driver::Base show all
Includes:
Find
Defined in:
lib/capybara/selenium/driver.rb

Defined Under Namespace

Modules: ChromeDriver, EdgeDriver, FirefoxDriver, InternetExplorerDriver, SafariDriver, W3CFirefoxDriver

Constant Summary collapse

DEFAULT_OPTIONS = 
{
  browser: :firefox,
  clear_local_storage: nil,
  clear_session_storage: nil
}.freeze
SPECIAL_OPTIONS = 
%i[browser clear_local_storage clear_session_storage timeout native_displayed].freeze

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Find

#find_css, #find_xpath

Methods inherited from Driver::Base

#find_css, #find_xpath, #frame_title, #frame_url, #response_headers, #session_options, #status_code

Constructor Details

#initialize(app, **options) ⇒ Driver

Returns a new instance of Driver.


59
60
61
62
63
64
65
66
67
 
# File 'lib/capybara/selenium/driver.rb', line 59

def initialize(app, **options)
  self.class.load_selenium
  @app = app
  @browser = nil
  @exit_status = nil
  @frame_handles = Hash.new { |hash, handle| hash[handle] = [] }
  @options = DEFAULT_OPTIONS.merge(options)
  @node_class = ::Capybara::Selenium::Node
end

Class Attribute Details

.specializations ⇒ Object (readonly)

Returns the value of attribute specializations


32
33
34
 
# File 'lib/capybara/selenium/driver.rb', line 32

def specializations
  @specializations
end

Instance Attribute Details

#app ⇒ Object (readonly)

Returns the value of attribute app


15
16
17
 
# File 'lib/capybara/selenium/driver.rb', line 15

def app
  @app
end

#options ⇒ Object (readonly)

Returns the value of attribute options


15
16
17
 
# File 'lib/capybara/selenium/driver.rb', line 15

def options
  @options
end

Class Method Details

.load_selenium ⇒ Object 


18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/capybara/selenium/driver.rb', line 18

def load_selenium
  require 'selenium-webdriver'
  require 'capybara/selenium/logger_suppressor'
  require 'capybara/selenium/patches/atoms'
  require 'capybara/selenium/patches/is_displayed'
  if Gem.loaded_specs['selenium-webdriver'].version < Gem::Version.new('3.5.0')
    warn "Warning: You're using an unsupported version of selenium-webdriver, please upgrade."
  end
rescue LoadError => e
  raise e unless e.message.match?(/selenium-webdriver/)

  raise LoadError, "Capybara's selenium driver is unable to load `selenium-webdriver`, please install the gem and add `gem 'selenium-webdriver'` to your Gemfile if you are using bundler."
end

.register_specialization(browser_name, specialization) ⇒ Object 


34
35
36
37
 
# File 'lib/capybara/selenium/driver.rb', line 34

def register_specialization(browser_name, specialization)
  @specializations ||= {}
  @specializations[browser_name] = specialization
end

Instance Method Details

#accept_modal(_type, **options) ⇒ Object 


222
223
224
225
226
227
228
229
230
231
 
# File 'lib/capybara/selenium/driver.rb', line 222

def accept_modal(_type, **options)
  yield if block_given?
  modal = find_modal(options)

  modal.send_keys options[:with] if options[:with]

  message = modal.text
  modal.accept
  message
end

#browser ⇒ Object 


40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/capybara/selenium/driver.rb', line 40

def browser
  unless @browser
    options[:http_client] ||= begin
      require 'capybara/selenium/patches/persistent_client'
      if options[:timeout]
        ::Capybara::Selenium::PersistentClient.new(read_timeout: options[:timeout])
      else
        ::Capybara::Selenium::PersistentClient.new
      end
    end
    processed_options = options.reject { |key, _val| SPECIAL_OPTIONS.include?(key) }
    @browser = Selenium::WebDriver.for(options[:browser], processed_options)

    specialize_driver
    setup_exit_handler
  end
  @browser
end

#close_window(handle) ⇒ Object

Raises:

  • (ArgumentError) 

199
200
201
202
203
204
205
 
# File 'lib/capybara/selenium/driver.rb', line 199

def close_window(handle)
  raise ArgumentError, 'Not allowed to close the primary window' if handle == window_handles.first

  within_given_window(handle) do
    browser.close
  end
end

#current_url ⇒ Object 


93
94
95
 
# File 'lib/capybara/selenium/driver.rb', line 93

def current_url
  browser.current_url
end

#current_window_handle ⇒ Object 


169
170
171
 
# File 'lib/capybara/selenium/driver.rb', line 169

def current_window_handle
  browser.window_handle
end

#dismiss_modal(_type, **options) ⇒ Object 


233
234
235
236
237
238
239
 
# File 'lib/capybara/selenium/driver.rb', line 233

def dismiss_modal(_type, **options)
  yield if block_given?
  modal = find_modal(options)
  message = modal.text
  modal.dismiss
  message
end

#evaluate_async_script(script, *args) ⇒ Object 


109
110
111
112
113
 
# File 'lib/capybara/selenium/driver.rb', line 109

def evaluate_async_script(script, *args)
  browser.manage.timeouts.script_timeout = Capybara.default_max_wait_time
  result = browser.execute_async_script(script, *native_args(args))
  unwrap_script_result(result)
end

#evaluate_script(script, *args) ⇒ Object 


104
105
106
107
 
# File 'lib/capybara/selenium/driver.rb', line 104

def evaluate_script(script, *args)
  result = execute_script("return #{script}", *args)
  unwrap_script_result(result)
end

#execute_script(script, *args) ⇒ Object 


100
101
102
 
# File 'lib/capybara/selenium/driver.rb', line 100

def execute_script(script, *args)
  browser.execute_script(script, *native_args(args))
end

#frame_obscured_at?(x:, y:) ⇒ Boolean

Returns:

  • (Boolean) 

142
143
144
145
146
147
148
149
150
151
152
 
# File 'lib/capybara/selenium/driver.rb', line 142

def frame_obscured_at?(x:, y:)
  frame = @frame_handles[current_window_handle].last
  return false unless frame

  switch_to_frame(:parent)
  begin
    return frame.base.obscured?(x: x, y: y)
  ensure
    switch_to_frame(frame)
  end
end

#fullscreen_window(handle) ⇒ Object 


193
194
195
196
197
 
# File 'lib/capybara/selenium/driver.rb', line 193

def fullscreen_window(handle)
  within_given_window(handle) do
    browser.manage.window.full_screen
  end
end

#go_back ⇒ Object 


77
78
79
 
# File 'lib/capybara/selenium/driver.rb', line 77

def go_back
  browser.navigate.back
end

#go_forward ⇒ Object 


81
82
83
 
# File 'lib/capybara/selenium/driver.rb', line 81

def go_forward
  browser.navigate.forward
end

#html ⇒ Object 


85
86
87
 
# File 'lib/capybara/selenium/driver.rb', line 85

def html
  browser.page_source
end

#invalid_element_errors ⇒ Object 


254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
 
# File 'lib/capybara/selenium/driver.rb', line 254

def invalid_element_errors
  @invalid_element_errors ||= begin
    [
      ::Selenium::WebDriver::Error::StaleElementReferenceError,
      ::Selenium::WebDriver::Error::ElementNotInteractableError,
      ::Selenium::WebDriver::Error::InvalidSelectorError, # Work around chromedriver go_back/go_forward race condition
      ::Selenium::WebDriver::Error::ElementClickInterceptedError,
      ::Selenium::WebDriver::Error::NoSuchElementError, # IE
      ::Selenium::WebDriver::Error::InvalidArgumentError # IE
    ].tap do |errors|
      unless selenium_4?
        ::Selenium::WebDriver.logger.suppress_deprecations do
          errors.concat [
            ::Selenium::WebDriver::Error::UnhandledError,
            ::Selenium::WebDriver::Error::ElementNotVisibleError,
            ::Selenium::WebDriver::Error::InvalidElementStateError,
            ::Selenium::WebDriver::Error::ElementNotSelectableError
          ]
        end
      end
    end
  end
end

#maximize_window(handle) ⇒ Object 


186
187
188
189
190
191
 
# File 'lib/capybara/selenium/driver.rb', line 186

def maximize_window(handle)
  within_given_window(handle) do
    browser.manage.window.maximize
  end
  sleep 0.1 # work around for https://code.google.com/p/selenium/issues/detail?id=7405
end

#needs_server? ⇒ Boolean

Returns:

  • (Boolean) 

98
 
# File 'lib/capybara/selenium/driver.rb', line 98

def needs_server?; true; end

#no_such_window_error ⇒ Object 


278
279
280
 
# File 'lib/capybara/selenium/driver.rb', line 278

def no_such_window_error
  Selenium::WebDriver::Error::NoSuchWindowError
end

#open_new_window(kind = :tab) ⇒ Object 


211
212
213
214
215
216
 
# File 'lib/capybara/selenium/driver.rb', line 211

def open_new_window(kind = :tab)
  browser.manage.new_window(kind)
rescue NoMethodError, Selenium::WebDriver::Error::WebDriverError
  # If not supported by the driver or browser default to using JS
  browser.execute_script('window.open();')
end

#quit ⇒ Object 


241
242
243
244
245
246
247
248
249
250
251
252
 
# File 'lib/capybara/selenium/driver.rb', line 241

def quit
  @browser&.quit
rescue Selenium::WebDriver::Error::SessionNotCreatedError, Errno::ECONNREFUSED # rubocop:disable Lint/HandleExceptions
  # Browser must have already gone
rescue Selenium::WebDriver::Error::UnknownError => e
  unless silenced_unknown_error_message?(e.message) # Most likely already gone
    # probably already gone but not sure - so warn
    warn "Ignoring Selenium UnknownError during driver quit: #{e.message}"
  end
ensure
  @browser = nil
end

#refresh ⇒ Object 


73
74
75
 
# File 'lib/capybara/selenium/driver.rb', line 73

def refresh
  browser.navigate.refresh
end

#reset! ⇒ Object 


119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'lib/capybara/selenium/driver.rb', line 119

def reset!
  # Use instance variable directly so we avoid starting the browser just to reset the session
  return unless @browser

  navigated = false
  timer = Capybara::Helpers.timer(expire_in: 10)
  begin
    # Only trigger a navigation if we haven't done it already, otherwise it
    # can trigger an endless series of unload modals
    reset_browser_state unless navigated
    navigated = true
    # Ensure the page is empty and trigger an UnhandledAlertError for any modals that appear during unload
    wait_for_empty_page(timer)
  rescue *unhandled_alert_errors
    # This error is thrown if an unhandled alert is on the page
    # Firefox appears to automatically dismiss this alert, chrome does not
    # We'll try to accept it
    accept_unhandled_reset_alert
    # try cleaning up the browser again
    retry
  end
end

#resize_window_to(handle, width, height) ⇒ Object 


180
181
182
183
184
 
# File 'lib/capybara/selenium/driver.rb', line 180

def resize_window_to(handle, width, height)
  within_given_window(handle) do
    browser.manage.window.resize_to(width, height)
  end
end

#save_screenshot(path, **_options) ⇒ Object 


115
116
117
 
# File 'lib/capybara/selenium/driver.rb', line 115

def save_screenshot(path, **_options)
  browser.save_screenshot(path)
end

#switch_to_frame(frame) ⇒ Object 


154
155
156
157
158
159
160
161
162
163
164
165
166
167
 
# File 'lib/capybara/selenium/driver.rb', line 154

def switch_to_frame(frame)
  handles = @frame_handles[current_window_handle]
  case frame
  when :top
    handles.clear
    browser.switch_to.default_content
  when :parent
    handles.pop
    browser.switch_to.parent_frame
  else
    handles << frame
    browser.switch_to.frame(frame.native)
  end
end

#switch_to_window(handle) ⇒ Object 


218
219
220
 
# File 'lib/capybara/selenium/driver.rb', line 218

def switch_to_window(handle)
  browser.switch_to.window handle
end

#title ⇒ Object 


89
90
91
 
# File 'lib/capybara/selenium/driver.rb', line 89

def title
  browser.title
end

#visit(path) ⇒ Object 


69
70
71
 
# File 'lib/capybara/selenium/driver.rb', line 69

def visit(path)
  browser.navigate.to(path)
end

#wait? ⇒ Boolean

Returns:

  • (Boolean) 

97
 
# File 'lib/capybara/selenium/driver.rb', line 97

def wait?; true; end

#window_handles ⇒ Object 


207
208
209
 
# File 'lib/capybara/selenium/driver.rb', line 207

def window_handles
  browser.window_handles
end

#window_size(handle) ⇒ Object 


173
174
175
176
177
178
 
# File 'lib/capybara/selenium/driver.rb', line 173

def window_size(handle)
  within_given_window(handle) do
    size = browser.manage.window.size
    [size.width, size.height]
  end
end