Class: Appium::Driver

Inherits:
Object
  • Object
show all
Defined in:
lib/appium_lib/driver.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(opts = {}, global_driver = false) ⇒ Driver

Creates a new driver. The driver is defined as global scope by default. We can avoid defining global driver.

Examples:


require 'rubygems'
require 'appium_lib'

# platformName takes a string or a symbol.
# Start iOS driver with global scope
opts = {
         caps: {
           platformName: :ios,
           app: '/path/to/MyiOS.app'
         },
         appium_lib: {
           wait_timeout: 30
         }
       }
appium_driver = Appium::Driver.new(opts, true)
appium_driver.start_driver

# Start Android driver with global scope
opts = {
         caps: {
           platformName: :android,
           app: '/path/to/my.apk'
         },
         appium_lib: {
           wait_timeout: 30,
           wait_interval: 1
         }
       }
appium_driver = Appium::Driver.new(opts, true)
appium_driver.start_driver

# Start iOS driver without global scope
opts = {
         caps: {
           platformName: :ios,
           app: '/path/to/MyiOS.app'
         },
         appium_lib: {
           wait_timeout: 30
         }
       }
appium_driver = Appium::Driver.new(opts, false)
appium_driver.start_driver

# Start iOS driver without global scope
opts = {
         caps: {
           platformName: :ios,
           app: '/path/to/MyiOS.app'
         },
         appium_lib: {
           wait_timeout: 30
         },
         global_driver: false
       }
appium_driver = Appium::Driver.new(opts)
appium_driver.start_driver

Parameters:

  • opts (Object) (defaults to: {})

    A hash containing various options.

  • global_driver (Bool) (defaults to: false)

    A bool require global driver before initialize.


154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
# File 'lib/appium_lib/driver.rb', line 154

def initialize(opts = {}, global_driver = false)
  # Capybara can't put `global_driver` as the 2nd argument.
  global_driver = opts.delete :global_driver if global_driver.nil?

  $driver&.driver_quit if global_driver

  raise 'opts must be a hash' unless opts.is_a? Hash

  @core = ::Appium::Core.for(opts)
  extend ::Appium::Core::Device

  opts = Appium.symbolize_keys opts
  appium_lib_opts = opts[:appium_lib] || {}

  @caps = @core.caps
  @custom_url = @core.custom_url
  @export_session = @core.export_session
  @export_session_path = @core.export_session_path
  @default_wait = @core.default_wait
  @appium_port = @core.port
  @appium_wait_timeout = @core.wait_timeout
  @appium_wait_interval = @core.wait_interval
  @listener = @core.listener
  @appium_device = @core.device
  @automation_name = @core.automation_name

  # Arrange the app capability. This must be after @core = ::Appium::Core.for(opts)
  set_app_path(opts)

  # enable debug patch
  @appium_debug = appium_lib_opts.fetch :debug, !!defined?(Pry) # rubocop:disable Style/DoubleNegation
  set_sauce_related_values(appium_lib_opts)

  # Extend Common methods
  extend Appium::Common
  extend Appium::Device

  # Extend each driver's methods
  extend_for(device: @core.device, automation_name: @core.automation_name)

  # for command

  if @appium_debug
    Appium::Logger.debug opts unless opts.empty?
    Appium::Logger.debug "Debug is: #{@appium_debug}"
    Appium::Logger.debug "Device is: #{@core.device}"
  end

  # Save global reference to last created Appium driver for top level methods.
  $driver = self if global_driver

  self # rubocop:disable Lint/Void # return newly created driver
end

Instance Attribute Details

#appium_debugObject (readonly)

Boolean debug mode for the Appium Ruby bindings


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

def appium_debug
  @appium_debug
end

#appium_deviceObject (readonly)

Returns the value of attribute appium_device.


71
72
73
# File 'lib/appium_lib/driver.rb', line 71

def appium_device
  @appium_device
end

#appium_portObject (readonly)

Returns the value of attribute appium_port.


70
71
72
# File 'lib/appium_lib/driver.rb', line 70

def appium_port
  @appium_port
end

#appium_server_statusObject (readonly)

Appium's server version


79
80
81
# File 'lib/appium_lib/driver.rb', line 79

def appium_server_status
  @appium_server_status
end

#appium_wait_intervalObject (readonly)

Returns the value of attribute appium_wait_interval.


76
77
78
# File 'lib/appium_lib/driver.rb', line 76

def appium_wait_interval
  @appium_wait_interval
end

#appium_wait_timeoutObject (readonly)

Returns the value of attribute appium_wait_timeout.


75
76
77
# File 'lib/appium_lib/driver.rb', line 75

def appium_wait_timeout
  @appium_wait_timeout
end

#automation_nameObject (readonly)

Returns the value of attribute automation_name.


72
73
74
# File 'lib/appium_lib/driver.rb', line 72

def automation_name
  @automation_name
end

#capsObject (readonly)


65
66
67
# File 'lib/appium_lib/driver.rb', line 65

def caps
  @caps
end

#coreObject (readonly)

Instance of Appium::Core::Driver


86
87
88
# File 'lib/appium_lib/driver.rb', line 86

def core
  @core
end

#custom_urlObject (readonly)

Returns the value of attribute custom_url.


66
67
68
# File 'lib/appium_lib/driver.rb', line 66

def custom_url
  @custom_url
end

#default_waitObject (readonly)

Returns the value of attribute default_wait.


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

def default_wait
  @default_wait
end

#driverDriver (readonly)

Returns the driver

Returns:


84
85
86
# File 'lib/appium_lib/driver.rb', line 84

def driver
  @driver
end

#export_sessionObject (readonly)

Returns the value of attribute export_session.


67
68
69
# File 'lib/appium_lib/driver.rb', line 67

def export_session
  @export_session
end

#export_session_pathObject (readonly)

Returns the value of attribute export_session_path.


68
69
70
# File 'lib/appium_lib/driver.rb', line 68

def export_session_path
  @export_session_path
end

#global_webdriver_http_sleepObject

The amount to sleep in seconds before every webdriver http call.


49
50
51
# File 'lib/appium_lib/driver.rb', line 49

def global_webdriver_http_sleep
  @global_webdriver_http_sleep
end

#http_clientObject (readonly)

Returns the value of attribute http_client.


74
75
76
# File 'lib/appium_lib/driver.rb', line 74

def http_client
  @http_client
end

#listenerObject (readonly)

Returns the value of attribute listener.


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

def listener
  @listener
end

#sauceObject (readonly)

SauceLab's settings


52
53
54
# File 'lib/appium_lib/driver.rb', line 52

def sauce
  @sauce
end

#sauce_access_keyObject (readonly)

Access Key for use on Sauce Labs. Set `false` to disable Sauce, even when SAUCE_ACCESS_KEY is in ENV. same as @sauce.access_key


58
59
60
# File 'lib/appium_lib/driver.rb', line 58

def sauce_access_key
  @sauce_access_key
end

#sauce_endpointObject (readonly)

Override the Sauce Appium endpoint to allow e.g. TestObject tests same as @sauce.endpoint


61
62
63
# File 'lib/appium_lib/driver.rb', line 61

def sauce_endpoint
  @sauce_endpoint
end

#sauce_usernameObject (readonly)

Username for use on Sauce Labs. Set `false` to disable Sauce, even when SAUCE_USERNAME is in ENV. same as @sauce.username


55
56
57
# File 'lib/appium_lib/driver.rb', line 55

def sauce_username
  @sauce_username
end

Class Method Details

.absolute_app_path(opts) ⇒ String

Converts app_path to an absolute path.

opts is the full options hash (caps and appium_lib). If server_url is set then the app path is used as is.

if app isn't set then an error is raised.

Returns:

  • (String)

    APP_PATH as an absolute path


382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
# File 'lib/appium_lib/driver.rb', line 382

def self.absolute_app_path(opts)
  raise 'opts must be a hash' unless opts.is_a? Hash

  caps            = opts[:caps] || {}
  app_path        = caps[:app]
  raise 'absolute_app_path invoked and app is not set!' if app_path.nil? || app_path.empty?
  # Sauce storage API. http://saucelabs.com/docs/rest#storage
  return app_path if app_path.start_with? 'sauce-storage:'
  return app_path if app_path =~ URI::DEFAULT_PARSER.make_regexp # public URL for Sauce

  absolute_app_path = File.expand_path app_path
  if File.exist? absolute_app_path
    absolute_app_path
  else
    ::Appium::Logger.info("Use #{app_path}")
    app_path
  end
end

Instance Method Details

#actionTouchAction|Selenium::WebDriver::PointerActions

Examples:


element = find_element(:id, "some id")
action.click(element).perform # The `click` is a part of `PointerActions`

Returns:


330
331
332
# File 'lib/appium_lib/driver.rb', line 330

def action
  @driver.action
end

#appium_client_versionHash

Returns the client's version info

Examples:


{
    "version" => "9.1.1"
}

Returns:

  • (Hash)

370
371
372
# File 'lib/appium_lib/driver.rb', line 370

def appium_client_version
  { version: ::Appium::VERSION }
end

#appium_server_versionHash Also known as: remote_status

Returns the server's version info

Examples:

{
  "build" => {
      "version" => "0.18.1",
      "revision" => "d242ebcfd92046a974347ccc3a28f0e898595198"
  }
}

Returns:

  • (Hash)

345
346
347
348
349
350
351
352
# File 'lib/appium_lib/driver.rb', line 345

def appium_server_version
  @core.appium_server_version
rescue Selenium::WebDriver::Error::WebDriverError => ex
  raise ::Appium::Core::Error::ServerError unless ex.message.include?('content-type=""')

  # server (TestObject for instance) does not respond to status call
  {}
end

#automation_name_is_espresso?Boolean

Return true if automationName is 'Espresso'

Returns:

  • (Boolean)

310
311
312
# File 'lib/appium_lib/driver.rb', line 310

def automation_name_is_espresso?
  !@core.automation_name.nil? && @core.automation_name == :espresso
end

#automation_name_is_uiautomator2?Boolean

Return true if automationName is 'uiautomator2'

Returns:

  • (Boolean)

304
305
306
# File 'lib/appium_lib/driver.rb', line 304

def automation_name_is_uiautomator2?
  !@core.automation_name.nil? && @core.automation_name == :uiautomator2
end

#automation_name_is_xcuitest?Boolean

Return true if automationName is 'XCUITest'

Returns:

  • (Boolean)

316
317
318
# File 'lib/appium_lib/driver.rb', line 316

def automation_name_is_xcuitest?
  !@core.automation_name.nil? && @core.automation_name == :xcuitest
end

#current_urlObject


660
661
662
# File 'lib/appium_lib/driver.rb', line 660

def current_url
  @driver.current_url
end

#device_is_android?Boolean

Returns:

  • (Boolean)

290
291
292
# File 'lib/appium_lib/driver.rb', line 290

def device_is_android?
  @core.device == :android
end

#device_is_ios?Boolean

Returns:

  • (Boolean)

294
295
296
# File 'lib/appium_lib/driver.rb', line 294

def device_is_ios?
  @core.device == :ios
end

#device_is_windows?Boolean

Returns:

  • (Boolean)

298
299
300
# File 'lib/appium_lib/driver.rb', line 298

def device_is_windows?
  @core.device == :windows
end

#driver_attributesObject

Returns a hash of the driver attributes


270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
# File 'lib/appium_lib/driver.rb', line 270

def driver_attributes
  {
    caps:                @core.caps,
    automation_name:     @core.automation_name,
    custom_url:          @core.custom_url,
    export_session:      @core.export_session,
    export_session_path: @core.export_session_path,
    default_wait:        @core.default_wait,
    sauce_username:      @sauce.username,
    sauce_access_key:    @sauce.access_key,
    sauce_endpoint:      @sauce.endpoint,
    port:                @core.port,
    device:              @core.device,
    debug:               @appium_debug,
    listener:            @listener,
    wait_timeout:        @core.wait_timeout,
    wait_interval:       @core.wait_interval
  }
end

#driver_quitvoid Also known as: quit_driver

This method returns an undefined value.

Quits the driver


446
447
448
# File 'lib/appium_lib/driver.rb', line 446

def driver_quit
  @core.quit_driver
end

#element_screenshot(element, png_save_path) ⇒ File

Takes a png screenshot of particular element's area

Examples:


el = find_element :accessibility_id, zzz
element_screenshot el, '/tmp/hi.png'

Parameters:

  • element (String)

    Element take a screenshot

  • png_save_path (String)

    the full path to save the png

Returns:

  • (File)

439
440
441
442
# File 'lib/appium_lib/driver.rb', line 439

def element_screenshot(element, png_save_path)
  @driver.take_element_screenshot element, png_save_path
  nil
end

#execute_async_script(script, *args) ⇒ Object

Wrap calling selenium webdrier APIs via ruby_core

Get the window handles of open browser windows


603
604
605
# File 'lib/appium_lib/driver.rb', line 603

def execute_async_script(script, *args)
  @driver.execute_async_script script, *args
end

#execute_driver(script: '', type: 'webdriverio', timeout_ms: nil) ⇒ Appium::Core::Base::Device::ExecuteDriver::Result

Run a set of script against the current session, allowing execution of many commands in one Appium request. Supports WebdriverIO API so far. Please read command API for more details about acceptable scripts and the output.

Examples:

script = <<~SCRIPT
  const status = await driver.status();
  console.warn('warning message');
  return [status];
SCRIPT
r = @@driver.execute_driver(script: script, type: 'webdriverio', timeout: 10_000)
r        #=> An instance of Appium::Core::Base::Device::ExecuteDriver::Result
r.result #=> The `result` key part as the result of the script
r.logs   #=> The `logs` key part as `{'log' => [], 'warn' => [], 'error' => []}`

Parameters:

  • script (String) (defaults to: '')

    The string consisting of the script itself

  • type (String) (defaults to: 'webdriverio')

    The name of the script type. Defaults to 'webdriverio'. Depends on server implementation which type is supported.

  • timeout_ms (Integer) (defaults to: nil)

    The number of `ms` Appium should wait for the script to finish before killing it due to timeout.

Returns:

  • (Appium::Core::Base::Device::ExecuteDriver::Result)

    The script result parsed by Appium::Core::Base::Device::ExecuteDriver::Result.

Raises:

  • (::Selenium::WebDriver::Error::UnknownError)

    If something error happens in the script. It has the original message.


635
636
637
# File 'lib/appium_lib/driver.rb', line 635

def execute_driver(script: '', type: 'webdriverio', timeout_ms: nil)
  @driver.execute_driver(script: script, type: type, timeout_ms: timeout_ms)
end

#execute_script(script, *args) ⇒ Object

The same as @driver.execute_script

Parameters:

  • script (String)

    The script to execute

  • args (*args)

    The args to pass to the script

Returns:

  • (Object)

595
596
597
# File 'lib/appium_lib/driver.rb', line 595

def execute_script(script, *args)
  @driver.execute_script script, *args
end

#exists(pre_check = 0, post_check = @core.default_wait) { ... } ⇒ Boolean

Returns existence of element.

Example:

exists { button('sign in') } ? puts('true') : puts('false')

Parameters:

  • pre_check (Integer) (defaults to: 0)

    The amount in seconds to set the wait to before checking existence

  • post_check (Integer) (defaults to: @core.default_wait)

    The amount in seconds to set the wait to after checking existence

Yields:

  • The block to call

Returns:

  • (Boolean)

571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
# File 'lib/appium_lib/driver.rb', line 571

def exists(pre_check = 0, post_check = @core.default_wait)
  # do not uset set_wait here.
  # it will cause problems with other methods reading the default_wait of 0
  # which then gets converted to a 1 second wait.
  @driver.manage.timeouts.implicit_wait = pre_check
  # the element exists unless an error is raised.
  exists                                = true

  begin
    yield # search for element
  rescue StandardError
    exists = false # error means it's not there
  end

  # restore wait
  @driver.manage.timeouts.implicit_wait = post_check if post_check != pre_check

  exists
end

#find_element(*args) ⇒ Element

Calls @driver.find_element

If you call `Appium.promote_appium_methods`, you can call `find_element` directly.

Examples:


@driver = Appium::Driver.new(opts, false)
@driver.start_driver
@driver.find_element :accessibility_id, zzz

Parameters:

  • args (*args)

    The args to use

Returns:

  • (Element)

713
714
715
# File 'lib/appium_lib/driver.rb', line 713

def find_element(*args)
  @driver.find_element(*args)
end

#find_element_by_image(png_img_path) ⇒ ::Appium::Core::ImageElement

Return ImageElement if current view has a partial image

Examples:


@driver.find_element_by_image './test/functional/data/test_element_image.png'

Parameters:

  • png_img_path (String)

    A path to a partial image you'd like to find

Returns:

  • (::Appium::Core::ImageElement)

Raises:

  • (::Appium::Core::Error::NoSuchElementError|::Appium::Core::Error::CoreError)

    No such element


728
729
730
# File 'lib/appium_lib/driver.rb', line 728

def find_element_by_image(png_img_path)
  @driver.find_element_by_image(png_img_path)
end

#find_elements(*args) ⇒ Array<Element>

Calls @driver.find_elements_with_appium

If you call `Appium.promote_appium_methods`, you can call `find_elements` directly.

If you call `Appium.promote_appium_methods`, you can call `find_elements` directly.

Examples:


@driver = Appium::Driver.new(opts, false)
@driver.start_driver
@driver.find_elements :predicate, yyy

@driver = Appium::Driver.new(opts, false)
@driver.start_driver
@driver.find_elements :predicate, yyy

Parameters:

  • args (*args)

    The args to use

Returns:

  • (Array<Element>)

    Array is empty when no elements are found.


697
698
699
# File 'lib/appium_lib/driver.rb', line 697

def find_elements(*args)
  @driver.find_elements(*args)
end

#find_elements_by_image(png_img_paths) ⇒ [::Appium::Core::ImageElement], ::Appium::Core::Error::CoreError

Return ImageElement if current view has partial images

Examples:


@driver.find_elements_by_image ['./test/functional/data/test_element_image.png']

Parameters:

  • png_img_paths ([String])

    Paths to a partial image you'd like to find

Returns:

  • ([::Appium::Core::ImageElement])
  • (::Appium::Core::Error::CoreError)

743
744
745
# File 'lib/appium_lib/driver.rb', line 743

def find_elements_by_image(png_img_paths)
  @driver.find_elements_by_image(png_img_paths)
end

#get(url) ⇒ Object


656
657
658
# File 'lib/appium_lib/driver.rb', line 656

def get(url)
  @driver.get(url)
end

#log_event(vendor:, event:) ⇒ nil

Logs a custom event. The event is available via Core::Events#get or driver.session_capabilities['events'] with eventTimings capabilities.

Examples:


log_event vendor: 'appium', event: 'funEvent'

log_event = { vendor: 'appium', event: 'anotherEvent' }
log_events #=> {...., 'appium:funEvent' => [1572957315, 1572960305],
           #          'appium:anotherEvent' => 1572959315}

Parameters:

  • vendor (String)

    The vendor prefix for the event

  • event (String)

    The name of event

Returns:

  • (nil)

Since:

  • Appium 1.16.0


780
781
782
# File 'lib/appium_lib/driver.rb', line 780

def log_event(vendor:, event:)
  @driver.logs.event vendor: vendor, event: event
end

#log_event=(log_event) ⇒ Object


784
785
786
787
788
789
790
# File 'lib/appium_lib/driver.rb', line 784

def log_event=(log_event)
  unless log_event.is_a?(Hash)
    raise ::Appium::Core::Error::ArgumentError('log_event should be Hash like { vendor: "appium", event: "funEvent"}')
  end

  @driver.logs.event vendor: log_event[:vendor], event: log_event[:event]
end

#log_events(type = nil) ⇒ Hash

Returns events with filtering with 'type'. Defaults to all available events.

Examples:


log_events #=> {}
log_events #=> {'commands' => [{'cmd' => 123455, ....}], 'startTime' => 1572954894127, }

Parameters:

  • type (String) (defaults to: nil)

    The type of events to get

Returns:

  • (Hash)

Since:

  • Appium 1.16.0


803
804
805
# File 'lib/appium_lib/driver.rb', line 803

def log_events(type = nil)
  @driver.logs.events(type)
end

#manageObject


652
653
654
# File 'lib/appium_lib/driver.rb', line 652

def manage
  @driver.manage
end

648
649
650
# File 'lib/appium_lib/driver.rb', line 648

def navigate
  @driver.navigate
end

#no_waitObject

Set implicit wait to zero.


540
541
542
# File 'lib/appium_lib/driver.rb', line 540

def no_wait
  @driver.manage.timeouts.implicit_wait = 0
end

#platform_versionArray<Integer>

Return the platform version as an array of integers

Returns:

  • (Array<Integer>)

357
358
359
# File 'lib/appium_lib/driver.rb', line 357

def platform_version
  @core.platform_version
end

#restartDriver

Restarts the driver

Returns:


412
413
414
415
# File 'lib/appium_lib/driver.rb', line 412

def restart
  driver_quit
  start_driver
end

#screenshot(png_save_path) ⇒ File

Takes a png screenshot and saves to the target path.

Examples:


screenshot '/tmp/hi.png'

Parameters:

  • png_save_path (String)

    the full path to save the png

Returns:

  • (File)

425
426
427
# File 'lib/appium_lib/driver.rb', line 425

def screenshot(png_save_path)
  @driver.save_screenshot png_save_path
end

#server_urlString

Get the server url

Returns:

  • (String)

    the server url


403
404
405
406
407
408
# File 'lib/appium_lib/driver.rb', line 403

def server_url
  return @core.custom_url if @core.custom_url
  return @sauce.server_url if @sauce.sauce_server_url?

  "http://127.0.0.1:#{@core.port}/wd/hub"
end

#set_implicit_wait(wait) ⇒ Object

To ignore error for Espresso Driver


529
530
531
532
533
534
535
536
537
# File 'lib/appium_lib/driver.rb', line 529

def set_implicit_wait(wait)
  @driver.manage.timeouts.implicit_wait = wait
rescue Selenium::WebDriver::Error::UnknownError => e
  unless e.message.include?('The operation requested is not yet implemented by Espresso driver')
    raise ::Appium::Core::Error::ServerError
  end

  {}
end

#set_location(opts = {}) ⇒ Selenium::WebDriver::Location

Note:

This method does not work on real devices.

Calls @driver.set_location

Parameters:

  • opts (Hash) (defaults to: {})

    consisting of:

Options Hash (opts):

  • :latitude (Float)

    the latitude in degrees (required)

  • :longitude (Float)

    the longitude in degees (required)

  • :altitude (Float)

    the altitude, defaulting to 75

Returns:

  • (Selenium::WebDriver::Location)

    the location constructed by the selenium webdriver


756
757
758
759
760
761
# File 'lib/appium_lib/driver.rb', line 756

def set_location(opts = {})
  latitude = opts.fetch(:latitude)
  longitude = opts.fetch(:longitude)
  altitude = opts.fetch(:altitude, 75)
  @driver.set_location(latitude, longitude, altitude)
end

#set_wait(timeout = nil) ⇒ void

This method returns an undefined value.

Set implicit wait. Default to @core.default_wait.

Examples:


set_wait 2
set_wait # @core.default_wait

Parameters:

  • timeout (Integer) (defaults to: nil)

    the timeout in seconds


554
555
556
557
# File 'lib/appium_lib/driver.rb', line 554

def set_wait(timeout = nil)
  timeout = @core.default_wait if timeout.nil?
  @driver.manage.timeouts.implicit_wait = timeout
end

#start_driver(http_client_ops = { http_client: ::Appium::Http::Default.new, open_timeout: 999_999, read_timeout: 999_999 }) ⇒ Selenium::WebDriver

Creates a new global driver and quits the old one if it exists. You can customise http_client as the following

Read www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device to understand more what the driver can call instance methods.

Examples:


require 'rubygems'
require 'appium_lib'

# platformName takes a string or a symbol.
# Start iOS driver
opts = {
         caps: {
           platformName: :ios,
           app: '/path/to/MyiOS.app'
         },
         appium_lib: {
           wait_timeout: 30
         }
       }
appium_driver = Appium::Driver.new(opts) #=> return an Appium::Driver instance
appium_driver.start_driver #=> return an Appium::Core::Base::Driver

Parameters:

  • http_client_ops (Hash) (defaults to: { http_client: ::Appium::Http::Default.new, open_timeout: 999_999, read_timeout: 999_999 })

    a customizable set of options

Options Hash (http_client_ops):

  • :http_client (Hash)

    Custom HTTP Client

  • :open_timeout (Hash)

    Custom open timeout for http client.

  • :read_timeout (Hash)

    Custom read timeout for http client.

Returns:

  • (Selenium::WebDriver)

    the new global driver


508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
# File 'lib/appium_lib/driver.rb', line 508

def start_driver(http_client_ops =
                     { http_client: ::Appium::Http::Default.new, open_timeout: 999_999, read_timeout: 999_999 })
  @core.quit_driver

  # If automationName is set only in server side, then the following automation_name should be nil before
  # starting driver.
  automation_name = @core.automation_name

  @driver = @core.start_driver(server_url: server_url, http_client_ops: http_client_ops)
  @http_client = @core.http_client

  # if automation_name was nil before start_driver, then re-extend driver specific methods
  # to be able to extend correctly.
  extend_for(device: @core.device, automation_name: @core.automation_name) if automation_name.nil?

  @appium_server_status = appium_server_version

  @driver
end

#switch_toTargetLocator

Returns:

  • (TargetLocator)

See Also:

  • TargetLocator

670
671
672
# File 'lib/appium_lib/driver.rb', line 670

def switch_to
  @driver.switch_to
end

#titleObject


664
665
666
# File 'lib/appium_lib/driver.rb', line 664

def title
  @driver.title
end

#window_handleObject

Get the current window handle


644
645
646
# File 'lib/appium_lib/driver.rb', line 644

def window_handle
  @driver.window_handle
end

#window_handlesObject


639
640
641
# File 'lib/appium_lib/driver.rb', line 639

def window_handles
  @driver.window_handles
end

#window_rectSelenium::WebDriver::Rectangle

Get the device window's rect.

Examples:


size = @driver.window_size
size.width #=> Integer
size.height #=> Integer
size.x #=> Integer
size.y #=> Integer

Returns:

  • (Selenium::WebDriver::Rectangle)

475
476
477
# File 'lib/appium_lib/driver.rb', line 475

def window_rect
  @driver.window_rect
end

#window_sizeSelenium::WebDriver::Dimension

Get the device window's size.

Examples:


size = @driver.window_size
size.width #=> Integer
size.height #=> Integer

Returns:

  • (Selenium::WebDriver::Dimension)

460
461
462
# File 'lib/appium_lib/driver.rb', line 460

def window_size
  @driver.window_size
end

#xvoid

This method returns an undefined value.

Quit the driver and Pry. quit and exit are reserved by Pry.


810
811
812
813
# File 'lib/appium_lib/driver.rb', line 810

def x
  driver_quit
  exit # exit pry
end