Class: ActionDispatch::SystemTesting::Browser

Inherits:
Object
  • Object
show all
Defined in:
actionpack/lib/action_dispatch/system_testing/browser.rb

Overview

:nodoc:

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name) ⇒ Browser

Returns a new instance of Browser.


8
9
10
11
# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 8

def initialize(name)
  @name = name
  set_default_options
end

Instance Attribute Details

#nameObject (readonly)

Returns the value of attribute name.


6
7
8
# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 6

def name
  @name
end

#optionsObject (readonly)

Returns the value of attribute options.


6
7
8
# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 6

def options
  @options
end

Instance Method Details

#configure {|options| ... } ⇒ Object

Yields:


24
25
26
27
# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 24

def configure
  initialize_options
  yield options if block_given? && options
end

#preloadObject

driver_path can be configured as a proc. The webdrivers gem uses this proc to update web drivers. Running this proc early allows us to only update the webdriver once and avoid race conditions when using parallel tests.


33
34
35
36
37
38
39
40
# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 33

def preload
  case type
  when :chrome
    ::Selenium::WebDriver::Chrome::Service.driver_path&.call
  when :firefox
    ::Selenium::WebDriver::Firefox::Service.driver_path&.call
  end
end

#typeObject


13
14
15
16
17
18
19
20
21
22
# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 13

def type
  case name
  when :headless_chrome
    :chrome
  when :headless_firefox
    :firefox
  else
    name
  end
end