Appium-Find Elements(查找元素)

今天药忘吃喽~ 2022-11-18 13:55 259阅读 0赞

区别于Find Element,返回一个包所有元素的列表，如果没有元素返回空表

### Find Elements ###

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

Search for multiple elements //搜索多个元素

##### 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">List elementsOne = (List) driver.findElementsByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>List elementsTwo = (List) driver.findElementsByClassName(<code>"SomeClassName"</code>);</td> 
  </tr> 
  <tr> 
   <td align="left">Python</td> 
   <td align="left">el = self.driver.find_elements_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 elementsOne = await driver.elementsByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>let elementsTwo = await driver.elements(<code>"id"</code>, <code>"SomeID"</code>);</td> 
  </tr> 
  <tr> 
   <td align="left">Ruby</td> 
   <td align="left"># ruby_lib example<br>find_elements(:accessibility_id, <code>"~SomeAccessibilityID"</code>)<br><br># ruby_lib_core example<br>@driver.find_elements(:accessibility_id, <code>"~SomeAccessibilityID"</code>)</td> 
  </tr> 
  <tr> 
   <td align="left">C#</td> 
   <td align="left">IEnumerable elementsOne = driver.FindElementsByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>IEnumerable elementsTwo = driver.FindElementsByClassName(<code>"SomeClassName"</code>);</td> 
  </tr> 
  <tr> 
   <td align="left">PHP</td> 
   <td align="left"><code>$</code>els = <code>$</code>this-&gt;elements($this-&gt;using(<code>'accessibility id'</code>)-&gt;value(<code>'SomeAccessibilityID'</code>));</td> 
  </tr> 
 </tbody> 
</table>

##### Selector Strategies #####

<table> 
 <thead> 
  <tr> 
   <th align="left">Strategy</th> 
   <th align="left">Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">Accessibility ID</td> 
   <td align="left">Read a unique identifier for a UI element. For XCUITest it is the element’s <code>accessibility-id</code> attribute. For Android it is the element’s <code>content-desc</code> attribute.</td> 
  </tr> 
  <tr> 
   <td align="left">Class name</td> 
   <td align="left">For IOS it is the full name of the XCUI element and begins with XCUIElementType. For Android it is the full name of the UIAutomator2 class (e.g.: android.widget.TextView)</td> 
  </tr> 
  <tr> 
   <td align="left">ID</td> 
   <td align="left">Native element identifier. <code>resource-id</code> for android; <code>name</code> for iOS.</td> 
  </tr> 
  <tr> 
   <td align="left">Name</td> 
   <td align="left">Name of element</td> 
  </tr> 
  <tr> 
   <td align="left">XPath</td> 
   <td align="left">Search the app XML source using xpath (not recommended, has performance issues)</td> 
  </tr> 
  <tr> 
   <td align="left">Image</td> 
   <td align="left">Locate an element by matching it with a base 64 encoded image file</td> 
  </tr> 
  <tr> 
   <td align="left">Android UiAutomator (UiAutomator2 only)</td> 
   <td align="left">Use the UI Automator API, in particular the UiSelector class to locate elements. In Appium you send the Java code, as a string, to the server, which executes it in the application’s environment, returning the element or elements.</td> 
  </tr> 
  <tr> 
   <td align="left">Android View Tag (Espresso only)</td> 
   <td align="left">Locate an element by its view tag</td> 
  </tr> 
  <tr> 
   <td align="left">Android Data Matcher (Espresso only)</td> 
   <td align="left">Locate an element using Espresso DataMatcher</td> 
  </tr> 
  <tr> 
   <td align="left">IOS UIAutomation</td> 
   <td align="left">When automating an iOS application, Apple’s Instruments framework can be used to find elements</td> 
  </tr> 
 </tbody> 
</table>

##### Description #####

Get a list of elements that match the locator selector.//获取与定位器选择器匹配的元素列表

##### 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/elements`

###### 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 list of of JSON objects for the located elements (`Array<String>`)