Appium-Find Element(查找元素)

红太狼 2022-11-18 13:50 137阅读 0赞

区别于Find Elements,返回查找到的第一个元素，如果没有查找到元素，返回NoSuchElementException的异常

### Find Element ###

*   *   *   *   *  Example Usage
                 *  Description
                 *  Support
                 *   *  Appium Server
                     *  Appium Clients
                 *  HTTP API Specifications
                 *   *  Endpoint
                     *  URL Parameters
                     *  JSON Parameters
                     *  Response

Search for an element on the page //页面上搜索元素

##### Example Usage #####

<table> 
 <thead> 
  <tr> 
   <th align="left"></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">Java</td> 
   <td align="left">MobileElement elementOne = (MobileElement)<br>driver.findElementByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>MobileElement elementTwo = (MobileElement) <br>driver.findElementByClassName(<code>"SomeClassName"</code>);</td> 
  </tr> 
  <tr> 
   <td align="left">Python</td> 
   <td align="left">el = self.driver.find_element_by_accessibility_id(<code>'SomeAccessibilityID'</code>)</td> 
  </tr> 
  <tr> 
   <td align="left">Javascript</td> 
   <td align="left">// webdriver.io example<br>$(<code>"~SomeAccessibilityId"</code>);<br><br>// wd example<br>let elementOne = await driver.elementByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>let elementTwo = await driver.element(<code>"id"</code>, <code>"SomeID"</code>);</td> 
  </tr> 
  <tr> 
   <td align="left">Ruby</td> 
   <td align="left"># ruby_lib example<br>find_element(:accessibility_id, <code>'SomeAccessibilityID'</code>)<br><br># ruby_lib_core example<br>@driver.find_element(:accessibility_id, <code>'SomeAccessibilityID'</code>)</td> 
  </tr> 
  <tr> 
   <td align="left">C#</td> 
   <td align="left">AndroidElement elementOne = driver.FindElementByAccessibilityID(<code>"Some ID"</code>);<br>AndroidElement elementTwo = driver.FindElementByClassName(<code>"Some class"</code>);</td> 
  </tr> 
  <tr> 
   <td align="left">PHP</td> 
   <td align="left">$el = $this-&gt;byAccessibilityId(<code>'SomeAccessibilityID'</code>);</td> 
  </tr> 
 </tbody> 
</table>

##### Description #####

Get the first element that matches a locator strategy //获取与定位器策略匹配的第一个元素

##### Support #####

###### Appium Server ######

<table> 
 <thead> 
  <tr> 
   <th align="left">Platform</th> 
   <th align="left">Driver</th> 
   <th align="left">Platform Versions</th> 
   <th align="left">Appium Version</th> 
   <th align="left">Driver Version</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">iOS</td> 
   <td align="left">XCUITest</td> 
   <td align="left">9.3+</td> 
   <td align="left">All</td> 
   <td align="left">All</td> 
  </tr> 
  <tr> 
   <td align="left"></td> 
   <td align="left">UIAutomation</td> 
   <td align="left">8.0 to 9.3</td> 
   <td align="left">All</td> 
   <td align="left">All</td> 
  </tr> 
  <tr> 
   <td align="left">Android</td> 
   <td align="left">Espresso</td> 
   <td align="left">?+</td> 
   <td align="left">1.9.0+</td> 
   <td align="left">All</td> 
  </tr> 
  <tr> 
   <td align="left"></td> 
   <td align="left">UiAutomator2</td> 
   <td align="left">?+</td> 
   <td align="left">1.6.0+</td> 
   <td align="left">All</td> 
  </tr> 
  <tr> 
   <td align="left"></td> 
   <td align="left">UiAutomator</td> 
   <td align="left">4.3+</td> 
   <td align="left">All</td> 
   <td align="left">All</td> 
  </tr> 
  <tr> 
   <td align="left">Mac</td> 
   <td align="left">Mac</td> 
   <td align="left">?+</td> 
   <td align="left">1.6.4+</td> 
   <td align="left">All</td> 
  </tr> 
  <tr> 
   <td align="left">Windows</td> 
   <td align="left">Windows</td> 
   <td align="left">10+</td> 
   <td align="left">1.6.0+</td> 
   <td align="left">All</td> 
  </tr> 
 </tbody> 
</table>

###### Appium Clients ######

<table> 
 <thead> 
  <tr> 
   <th align="left">Language</th> 
   <th align="left">Support</th> 
   <th align="left">Documentation</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">Java</td> 
   <td align="left">All</td> 
   <td align="left">appium.github.io</td> 
  </tr> 
  <tr> 
   <td align="left">Python</td> 
   <td align="left">All</td> 
   <td align="left">appium.github.io</td> 
  </tr> 
  <tr> 
   <td align="left">Javascript (WebdriverIO)</td> 
   <td align="left">All</td> 
   <td align="left"></td> 
  </tr> 
  <tr> 
   <td align="left">Javascript (WD)</td> 
   <td align="left">All</td> 
   <td align="left">github.com</td> 
  </tr> 
  <tr> 
   <td align="left">Ruby</td> 
   <td align="left">All</td> 
   <td align="left">www.rubydoc.info</td> 
  </tr> 
  <tr> 
   <td align="left">PHP</td> 
   <td align="left">All</td> 
   <td align="left">github.com</td> 
  </tr> 
  <tr> 
   <td align="left">C#</td> 
   <td align="left">All</td> 
   <td align="left">github.com</td> 
  </tr> 
 </tbody> 
</table>

##### HTTP API Specifications #####

###### Endpoint ######

`POST /session/:session_id/element`

###### URL Parameters ######

<table> 
 <thead> 
  <tr> 
   <th align="left">name</th> 
   <th align="left">description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">session_id</td> 
   <td align="left">ID of the session to route the command to</td> 
  </tr> 
 </tbody> 
</table>

###### JSON Parameters ######

<table> 
 <thead> 
  <tr> 
   <th align="left">name</th> 
   <th align="left">type</th> 
   <th align="left">description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">using</td> 
   <td align="left"><code>string</code></td> 
   <td align="left">The locator strategy to use</td> 
  </tr> 
  <tr> 
   <td align="left">value</td> 
   <td align="left"><code>string</code></td> 
   <td align="left">The search target</td> 
  </tr> 
 </tbody> 
</table>

###### Response ######

A JSON object for the located element (`object`) //定位元素（object）的JSON对象