123456789_123456789_123456789_123456789_123456789_

Class: ActionDispatch::SystemTesting::Browser

Do not use. This class is for internal use only.
Relationships & Source Files
Inherits: Object
Defined in: actionpack/lib/action_dispatch/system_testing/browser.rb

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(name) ⇒ Browser

[ GitHub ] 

  


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



def initialize(name)
  @name = name
end


  







Instance Attribute Details



  

    #name   (readonly)
  

  [ GitHub ]


  

  


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



attr_reader :name


  







Instance Method Details



  

    #configure {|options| ... } 
  



  

    
  





  
Yields:





  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 35



def configure
  yield options if block_given?
end


  








  

    #default_chrome_options   (private)
  

  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 51



def default_chrome_options
  options = ::Selenium::WebDriver::Chrome::Options.new
  options.add_argument("--disable-search-engine-choice-screen")
  options.add_argument("--headless") if name == :headless_chrome
  options.add_argument("--disable-gpu") if Gem.win_platform?
  options
end


  








  

    #default_firefox_options   (private)
  

  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 59



def default_firefox_options
  options = ::Selenium::WebDriver::Firefox::Options.new
  options.add_argument("-headless") if name == :headless_firefox
  options
end


  








  

    #options  
  

  [ GitHub ]


  

  


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



def options
  @options ||=
    case type
    when :chrome
      default_chrome_options
    when :firefox
      default_firefox_options
    end
end


  








  

    #preload  
  



  

    

driver_path is lazily initialized by default. Eagerly set it to avoid race conditions when using parallel tests.


  



  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 41



def preload
  case type
  when :chrome
    resolve_driver_path(::Selenium::WebDriver::Chrome)
  when :firefox
    resolve_driver_path(::Selenium::WebDriver::Firefox)
  end
end


  








  

    #resolve_driver_path(namespace)   (private)
  

  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 65



def resolve_driver_path(namespace)
  # The path method has been deprecated in 4.20.0
  if Gem::Version.new(::Selenium::WebDriver::VERSION) >= Gem::Version.new("4.20.0")
    namespace::Service.driver_path = ::Selenium::WebDriver::DriverFinder.new(options, namespace::Service.new).driver_path
  else
    namespace::Service.driver_path = ::Selenium::WebDriver::DriverFinder.path(options, namespace::Service)
  end
end


  








  

    #type  
  

  [ GitHub ]


  

  


# File 'actionpack/lib/action_dispatch/system_testing/browser.rb', line 14



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