Module: AdbDriver::Finder

Includes:
Wait
Included in:
Driver
Defined in:
lib/adb_driver/finder.rb

Constant Summary collapse

FIND_ELEMENT_TIMEOUT = 
1
PAGE_SOURCE_TIMEOUT = 
15
MIN_TIME_BETWEEN_FIND_ATTEMPTS = 
0.250

Constants included from Wait

Wait::Error

Instance Method Summary collapse

Methods included from Wait

included, #wait

Instance Method Details

#find_element(locator) ⇒ Object 



9
10
11
12
13
14
15
 
# File 'lib/adb_driver/finder.rb', line 9

def find_element(locator)
  wait(FIND_ELEMENT_TIMEOUT) { find_elements(locator).first }
rescue Wait::Error
  logger.info "Element with locator '#{locator}' has not been found"
  logger.debug "Current hierarchy: #{@last_view_hierarchy}"
  raise Error::NoSuchElementError
end

#find_elements(locator) ⇒ Object 



17
18
19
20
21
22
23
24
25
26
27
28
29
 
# File 'lib/adb_driver/finder.rb', line 17

def find_elements(locator)
  logger.info "Searching for element by: #{locator}"

  locator_type = locator.first.first
  locator_value = locator.first.last

  case locator_type
  when :xpath        then find_elements_by_xpath(locator_value)
  when :id           then find_elements_by_xpath("//*[contains(@resource-id,'#{locator_value}')]")
  when :class_name   then find_elements_by_xpath("//*[@class='#{locator_value}']")
  when :content_desc then find_elements_by_xpath("//*[@content-desc='#{locator_value}']")
  end
end

#find_elements_by_xpath(xpath) ⇒ Object 



31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/adb_driver/finder.rb', line 31

def find_elements_by_xpath(xpath)
  sleep 0.05 until Time.now >= (@last_find_attempt_time ||= Time.now) + MIN_TIME_BETWEEN_FIND_ATTEMPTS

  view_hierarchy = REXML::Document.new(page_source)
  @last_view_hierarchy = view_hierarchy

  result = view_hierarchy.get_elements(xpath).map { |element| Element.new(element) }
  @last_find_attempt_time = Time.now
  logger.debug "Returning element(s): #{result}"
  result
end

#page_source ⇒ Object 



43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
 
# File 'lib/adb_driver/finder.rb', line 43

def page_source
  adb_command = Adb.android_7? ? 'exec-out uiautomator dump /dev/tty' : 'shell uiautomator dump /dev/tty'
  logger.info "Getting view hierarchy"
  result = Adb.execute_command(adb_command, PAGE_SOURCE_TIMEOUT)

  if result.empty? || result.strip == 'Killed'
    logger.info "Result is empty or 'Killed'. Restarting adb..."
    Adb.restart_adb
    logger.info "Adb restarted. Getting result..."
    result = Adb.execute_command(adb_command, PAGE_SOURCE_TIMEOUT)
  end

  logger.debug "Result received: #{result}"
  result
rescue Wait::Error
  raise TimeOutError, "Couldn't get page_source in reasonable time (#{PAGE_SOURCE_TIMEOUT} seconds)"
end