Skip to content

Latest commit

 

History

History
51 lines (38 loc) · 2.49 KB

uiautomator-uiselector.md

File metadata and controls

51 lines (38 loc) · 2.49 KB
Raw

Guide on UiAutomator Locator Types

UIA2 driver enables elements lookup using UiSelector. UiScrollable is also supported. Both locator types are supported natively by Google's UiAutomator framework for Android. With these locators you could create flexible ways to reference complicated element paths, and their performance is very close to native.

Examples

Note that the index selector is unreliable so prefer instance instead. The following examples are written against the ApiDemos apk using Ruby.

Find the first textview.

# ruby
first_textview = find_element(:uiautomator, 'new UiSelector().className("android.widget.TextView").instance(0)');

Find the first element by text.

# ruby
first_text = find_element(:uiautomator, 'new UiSelector().text("Animation")')
first_text.text # "Animation"

Find the first scrollable element, then find a TextView with the text "Tabs". The "Tabs" element will be scrolled into view.

# ruby
element = find_element(:uiautomator, 'new UiScrollable(new UiSelector().scrollable(true).instance(0)).getChildByText(new UiSelector().className("android.widget.TextView"), "Tabs")')

As a special case, scrollIntoView returns the element that is scrolled into view. scrollIntoView allows scrolling to any UiSelector.

# ruby
element = find_element(:uiautomator, 'new UiScrollable(new UiSelector().scrollable(true).instance(0)).scrollIntoView(new UiSelector().text("WebView").instance(0));')
element.text # "WebView"

More Resources