mirror of
https://github.com/appium/appium.git
synced 2026-02-08 19:00:16 -06:00
50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
# Finding and interacting with elements
|
|
|
|
Appium supports a subset of the WebDriver locator strategies:
|
|
|
|
* find by "class" (i.e., ui component type)
|
|
* find by "xpath" (i.e., an abstract representation of a path to an element,
|
|
with certain constraints)
|
|
|
|
Appium additionally supports some of the [Mobile JSON Wire Protocol](https://code.google.com/p/selenium/source/browse/spec-draft.md?repo=mobile) locator strategies
|
|
|
|
* `-ios uiautomation`: a string corresponding to a recursive element search
|
|
using the UIAutomation library (iOS-only)
|
|
* `-android uiautomator`: a string corresponding to a recursive element
|
|
search using the UiAutomator Api (Android-only)
|
|
* `accessibility id`: a string corresponding to a recursive element search
|
|
using the Id/Name that the native Accessibility options utilize.
|
|
|
|
## Issues
|
|
|
|
There's a known issue with table cell elements becoming invalidated before
|
|
there's time to interact with them. We're working on a fix
|
|
|
|
## Using The Appium Inspector To Locate Elements
|
|
|
|
Appium provides you with a neat tool that allows you to find the the elements
|
|
you're looking for without leaving the Appium app. With the Appium Inspector
|
|
(the i symbol next to the start test button) you can find any element and
|
|
it's name by either clicking the element on the preview page provided,
|
|
or locating it in the UI navigator.
|
|
|
|
### Overview
|
|
|
|
The Appium inspector has a simple layout, complete with a UI navigator,
|
|
a preview, and record and refresh buttons, and interaction tools.
|
|
|
|
|
|
|
|
### Example
|
|
|
|
After launching the Appium Inspector (you can do this by clicking the small
|
|
"i" button in the top right of the app) you can locate any element in the
|
|
preview. In this test, I'm looking for the id of the "show alert" button.
|
|
|
|
|
|
|
|
To find the id of this button, I click the "show alert" button in the
|
|
inspector preview. The Appium inspector then highlights the element in the UI
|
|
navigator, showing me both the id and element type of the button I clicked.
|
|
|
|
 |