class Selenium::WebDriver::Driver

The main class through which you control the browser.

Source

# File lib/selenium/webdriver/common/driver.rb, line 44
def for(browser, opts = {})
  case browser
  when :chrome, :chrome_headless_shell
    Chrome::Driver.new(**opts)
  when :internet_explorer, :ie
    IE::Driver.new(**opts)
  when :safari
    Safari::Driver.new(**opts)
  when :firefox, :ff
    Firefox::Driver.new(**opts)
  when :edge, :microsoftedge, :msedge
    Edge::Driver.new(**opts)
  when :remote
    Remote::Driver.new(**opts)
  else
    raise ArgumentError, "unknown driver: #{browser.inspect}"
  end
end

@api private

@see Selenium::WebDriver.for

@return [Driver]

new (bridge: nil, listener: nil, **)

Source

# File lib/selenium/webdriver/common/driver.rb, line 71
def initialize(bridge: nil, listener: nil, **)
  @devtools = nil
  bridge ||= create_bridge(**)
  @bridge = listener ? Support::EventFiringBridge.new(bridge, listener) : bridge
  add_extensions(@bridge.browser)
end

A new Driver instance with the given bridge. End users should use Selenium::WebDriver.for instead of using this directly.

@api private

Public Instance Methods

[] (sel)

Source

# File lib/selenium/webdriver/common/driver.rb, line 295
def [](sel)
  sel = {id: sel} if sel.is_a?(String) || sel.is_a?(Symbol)

  find_element sel
end

Get the first element matching the given selector. If given a String or Symbol, it will be used as the id of the element.

@param [String,Hash] sel id or selector @return [WebDriver::Element]

Examples:

driver['someElementId']    #=> #<WebDriver::Element:0x1011c3b88>
driver[:tag_name => 'div'] #=> #<WebDriver::Element:0x1011c3b88>

action (**)

Source

# File lib/selenium/webdriver/common/driver.rb, line 134
def action(**)
  bridge.action(**)
end

@return [ActionBuilder] @see ActionBuilder

add_virtual_authenticator (options)

Source

# File lib/selenium/webdriver/common/driver.rb, line 256
def add_virtual_authenticator(options)
  bridge.add_virtual_authenticator(options)
end

@return [VirtualAuthenticator] @see VirtualAuthenticator

browser ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 301
def browser
  bridge.browser
end

capabilities ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 305
def capabilities
  bridge.capabilities
end

close ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 191
def close
  bridge&.close
end

Close the current window, or the browser if no windows are left.

current_url ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 152
def current_url
  bridge.url
end

Get the URL of the current page

@return [String]

execute_async_script (script, *)

Source

# File lib/selenium/webdriver/common/driver.rb, line 247
def execute_async_script(script, *)
  bridge.execute_async_script(script, *)
end

Execute an asynchronous piece of JavaScript in the context of the currently selected frame or window. Unlike executing execute_script (synchronous JavaScript), scripts executed with this method must explicitly signal they are finished by invoking the provided callback. This callback is always injected into the executed function as the last argument.

@param [String] script

JavaScript source to execute

@param [WebDriver::Element,Integer, Float, Boolean, NilClass, String, Array] args

Arguments to the script. May be empty.

@return [WebDriver::Element,Integer,Float,Boolean,NilClass,String,Array]

execute_script (script, *)

Source

# File lib/selenium/webdriver/common/driver.rb, line 228
def execute_script(script, *)
  bridge.execute_script(script, *)
end

Execute the given JavaScript

@param [String] script

JavaScript source to execute

@param [WebDriver::Element, Integer, Float, Boolean, NilClass, String, Array] args

Arguments will be available in the given script in the 'arguments' pseudo-array.

@return [WebDriver::Element,Integer,Float,Boolean,NilClass,String,Array]

The value returned from the script.

get (url)

Source

# File lib/selenium/webdriver/common/driver.rb, line 142
def get(url)
  navigate.to(url)
end

Opens the specified URL in the browser.

inspect ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 78
def inspect
  format '#<%<class>s:0x%<hash>x browser=%<browser>s>', class: self.class, hash: hash * 2,
                                                        browser: bridge.browser.inspect
end

manage ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 125
def manage
  bridge.manage
end

@return [Manager] @see Manager

navigate ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 98
def navigate
  @navigate ||= WebDriver::Navigation.new(bridge)
end

@return [Navigation] @see Navigation

network ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 265
def network
  @network ||= WebDriver::Network.new(bridge)
end

@return [Network] @see Network

page_source ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 172
def page_source
  bridge.page_source
end

Get the source of the current page

@return [String]

quit ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 180
def quit
  bridge.quit
ensure
  @service_manager&.stop
  @devtools&.each_value(&:close)
end

Quit the browser

ref ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 314
def ref
  [:driver, nil]
end

@api private @see SearchContext

script ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 107
def script
  @script ||= WebDriver::Script.new(bridge)
end

@return [Script] @see Script

status ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 89
def status
  @bridge.status
end

information about whether a remote end is in a state in which it can create new sessions, and may include additional meta information.

@return [Hash]

switch_to ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 116
def switch_to
  @switch_to ||= WebDriver::TargetLocator.new(bridge)
end

@return [TargetLocator] @see TargetLocator

title ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 162
def title
  bridge.title
end

Get the title of the current page

@return [String]

window_handle ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 212
def window_handle
  bridge.window_handle
end

Get the current window handle

@return [String]

window_handles ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 202
def window_handles
  bridge.window_handles
end

Get the window handles of open browser windows.

@return [Array] @see TargetLocator#window

Private Instance Methods

add_extensions (browser)

Source

# File lib/selenium/webdriver/common/driver.rb, line 338
def add_extensions(browser)
  extensions = case browser
               when :chrome, :chrome_headless_shell, :msedge, :microsoftedge
                 Chromium::Driver::EXTENSIONS
               when :firefox
                 Firefox::Driver::EXTENSIONS
               when :safari, :safari_technology_preview
                 Safari::Driver::EXTENSIONS
               when :ie, :internet_explorer
                 IE::Driver::EXTENSIONS
               else
                 []
               end
  extensions.each { |extension| extend extension }
end

create_bridge (caps:, url:, http_client: nil)

Source

# File lib/selenium/webdriver/common/driver.rb, line 322
def create_bridge(caps:, url:, http_client: nil)
  klass = caps['webSocketUrl'] ? Remote::BiDiBridge : Remote::Bridge
  klass.new(http_client: http_client, url: url).tap do |bridge|
    bridge.create_session(caps)
  end
end

screenshot ()

Source

# File lib/selenium/webdriver/common/driver.rb, line 334
def screenshot
  bridge.screenshot
end

service_url (service)

Source

# File lib/selenium/webdriver/common/driver.rb, line 329
def service_url(service)
  @service_manager = service.launch
  @service_manager.uri
end

class Selenium::WebDriver::Driver

Attributes

Public Class Methods

Public Instance Methods

Private Instance Methods