区别于Find Elements,返回查找到的第一个元素,如果没有查找到元素,返回NoSuchElementException的异常
Find Element
Search for an element on the page //页面上搜索元素
Example Usage
Java | MobileElement elementOne = (MobileElement) driver.findElementByAccessibilityId( "SomeAccessibilityID" );MobileElement elementTwo = (MobileElement) driver.findElementByClassName( "SomeClassName" ); |
Python | el = self.driver.find_element_by_accessibility_id('SomeAccessibilityID' ) |
Javascript | // webdriver.io example $( "~SomeAccessibilityId" );// wd example let elementOne = await driver.elementByAccessibilityId( "SomeAccessibilityID" );let elementTwo = await driver.element( "id" , "SomeID" ); |
Ruby | # ruby_lib example find_element(:accessibility_id, 'SomeAccessibilityID' )# ruby_lib_core example @driver.find_element(:accessibility_id, 'SomeAccessibilityID' ) |
C# | AndroidElement elementOne = driver.FindElementByAccessibilityID("Some ID" );AndroidElement elementTwo = driver.FindElementByClassName( "Some class" ); |
PHP | $el = $this->byAccessibilityId('SomeAccessibilityID' ); |
Description
Get the first element that matches a locator strategy //获取与定位器策略匹配的第一个元素
Support
Appium Server
Platform | Driver | Platform Versions | Appium Version | Driver Version |
---|---|---|---|---|
iOS | XCUITest | 9.3+ | All | All |
UIAutomation | 8.0 to 9.3 | All | All | |
Android | Espresso | ?+ | 1.9.0+ | All |
UiAutomator2 | ?+ | 1.6.0+ | All | |
UiAutomator | 4.3+ | All | All | |
Mac | Mac | ?+ | 1.6.4+ | All |
Windows | Windows | 10+ | 1.6.0+ | All |
Appium Clients
Language | Support | Documentation |
---|---|---|
Java | All | appium.github.io |
Python | All | appium.github.io |
Javascript (WebdriverIO) | All | |
Javascript (WD) | All | github.com |
Ruby | All | www.rubydoc.info |
PHP | All | github.com |
C# | All | github.com |
HTTP API Specifications
Endpoint
POST /session/:session_id/element
URL Parameters
name | description |
---|---|
session_id | ID of the session to route the command to |
JSON Parameters
name | type | description |
---|---|---|
using | string | The locator strategy to use |
value | string | The search target |
Response
A JSON object for the located element (object
) //定位元素(object)的JSON对象