Class: Selenium::WebDriver::Driver

Inherits:
Object
  • Object
show all
Includes:
SearchContext
Defined in:
lib/selenium/webdriver/common/driver.rb

Overview

The main class through which you control the browser.

Constant Summary

Constants included from SearchContext

SearchContext::FINDERS

Class Method Summary collapse

Instance Method Summary collapse

Methods included from SearchContext

#find_element, #find_elements

Constructor Details

#initialize(bridge) ⇒ Driver

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

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



65
66
67
68
69
70
71
72
# File 'lib/selenium/webdriver/common/driver.rb', line 65

def initialize(bridge)
  @bridge = bridge

  # TODO: refactor this away
  unless bridge.driver_extensions.empty?
    extend(*bridge.driver_extensions)
  end
end

Class Method Details

.for(browser, opts = {}) ⇒ Driver

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:

See Also:



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# File 'lib/selenium/webdriver/common/driver.rb', line 26

def for(browser, opts = {})
  listener = opts.delete(:listener)

  bridge = case browser
           when :firefox, :ff
             Firefox::Bridge.new(opts)
           when :remote
             Remote::Bridge.new(opts)
           when :ie, :internet_explorer
             IE::Bridge.new(opts)
           when :chrome
             Chrome::Bridge.new(opts)
           when :android
             Android::Bridge.new(opts)
           when :iphone
             IPhone::Bridge.new(opts)
           when :opera
             Opera::Bridge.new(opts)
           when :phantomjs
             PhantomJS::Bridge.new(opts)
           when :safari
             Safari::Bridge.new(opts)
           else
             raise ArgumentError, "unknown driver: #{browser.inspect}"
           end

  bridge = Support::EventFiringBridge.new(bridge, listener) if listener

  new(bridge)
end

Instance Method Details

#[](sel) ⇒ WebDriver::Element

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

Examples:

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

Parameters:

  • id (String, Hash)

    or selector

Returns:



268
269
270
271
272
273
274
# File 'lib/selenium/webdriver/common/driver.rb', line 268

def [](sel)
  if sel.kind_of?(String) || sel.kind_of?(Symbol)
    sel = { :id => sel }
  end

  find_element sel
end

#browserObject



276
277
278
# File 'lib/selenium/webdriver/common/driver.rb', line 276

def browser
  bridge.browser
end

#capabilitiesObject



280
281
282
# File 'lib/selenium/webdriver/common/driver.rb', line 280

def capabilities
  bridge.capabilities
end

#closeObject

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



175
176
177
# File 'lib/selenium/webdriver/common/driver.rb', line 175

def close
  bridge.close
end

#current_urlString

Get the URL of the current page

Returns:



119
120
121
# File 'lib/selenium/webdriver/common/driver.rb', line 119

def current_url
  bridge.getCurrentUrl
end

#execute_async_script(script, *args) ⇒ WebDriver::Element, ...

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.

Parameters:

  • script (String)

    JavaSCript source to execute

  • *args (WebDriver::Element, Integer, Float, Boolean, NilClass, String, Array)

    Arguments to the script. May be empty.

Returns:



231
232
233
# File 'lib/selenium/webdriver/common/driver.rb', line 231

def execute_async_script(script, *args)
  bridge.executeAsyncScript(script, *args)
end

#execute_script(script, *args) ⇒ WebDriver::Element, ... Also known as: script

Execute the given JavaScript

Parameters:

  • script (String)

    JavaScript source to execute

  • *args (WebDriver::Element, Integer, Float, Boolean, NilClass, String, Array)

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

Returns:



212
213
214
# File 'lib/selenium/webdriver/common/driver.rb', line 212

def execute_script(script, *args)
  bridge.executeScript(script, *args)
end

#get(url) ⇒ Object

Opens the specified URL in the browser.



109
110
111
# File 'lib/selenium/webdriver/common/driver.rb', line 109

def get(url)
  navigate.to(url)
end

#inspectObject



74
75
76
# File 'lib/selenium/webdriver/common/driver.rb', line 74

def inspect
  '#<%s:0x%x browser=%s>' % [self.class, hash*2, bridge.browser.inspect]
end

#manageOptions

Returns:

See Also:



101
102
103
# File 'lib/selenium/webdriver/common/driver.rb', line 101

def manage
  @manage ||= WebDriver::Options.new(bridge)
end

Returns:

See Also:



83
84
85
# File 'lib/selenium/webdriver/common/driver.rb', line 83

def navigate
  @navigate ||= WebDriver::Navigation.new(bridge)
end

#page_sourceString

Get the source of the current page

Returns:



139
140
141
# File 'lib/selenium/webdriver/common/driver.rb', line 139

def page_source
  bridge.getPageSource
end

#quitObject

Quit the browser



167
168
169
# File 'lib/selenium/webdriver/common/driver.rb', line 167

def quit
  bridge.quit
end

#refObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

See Also:



289
290
291
# File 'lib/selenium/webdriver/common/driver.rb', line 289

def ref
  nil
end

#switch_toTargetLocator

Returns:

See Also:



92
93
94
# File 'lib/selenium/webdriver/common/driver.rb', line 92

def switch_to
  @switch_to ||= WebDriver::TargetLocator.new(bridge)
end

#titleString

Get the title of the current page

Returns:



129
130
131
# File 'lib/selenium/webdriver/common/driver.rb', line 129

def title
  bridge.getTitle
end

#visible=(bool) ⇒ Object

Set the visibility of the browser. Not applicable for all browsers.

Parameters:

  • (Boolean)


159
160
161
# File 'lib/selenium/webdriver/common/driver.rb', line 159

def visible=(bool)
  bridge.setBrowserVisible bool
end

#visible?Boolean

Get the visibility of the browser. Not applicable for all browsers.

Returns:

  • (Boolean)


149
150
151
# File 'lib/selenium/webdriver/common/driver.rb', line 149

def visible?
  bridge.getBrowserVisible
end

#window_handleString

Get the current window handle

Returns:



196
197
198
# File 'lib/selenium/webdriver/common/driver.rb', line 196

def window_handle
  bridge.getCurrentWindowHandle
end

#window_handlesArray

Get the window handles of open browser windows.

Returns:

  • (Array)

See Also:



186
187
188
# File 'lib/selenium/webdriver/common/driver.rb', line 186

def window_handles
  bridge.getWindowHandles
end