Appium-Location(位置)

浅浅的花香味﹌ 2022-11-19 04:08 181阅读 0赞

这里指元素的位置/定位

### Get Element Location ###

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

Determine an element’s location on the page or screen //确定元素在页面或屏幕上的位置

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

<table> 
 <thead> 
  <tr> 
   <th></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td align="left">MobileElement element = (MobileElement) driver.findElementByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>Point location = element.getLocation();</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td align="left">location = self.driver.find_element_by_accessibility_id(<code>'SomeAccessibilityID'</code>).location</td> 
  </tr> 
  <tr> 
   <td>Javascript</td> 
   <td align="left">// webdriver.io example<br>let location = $(<code>"~SomeAccessibilityId"</code>).getLocation();<br><br>// wd example<br>let element = await driver.elementByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>let location = await element.getLocation();</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td align="left"># ruby_lib example<br>find_element(:accessibility_id, <code>'SomeAccessibilityID'</code>).location<br><br># ruby_lib_core example<br>@driver.find_element(:accessibility_id, <code>'SomeAccessibilityID'</code>).location</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td align="left">var element = driver.FindElementByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>Point location = element.Location;</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td align="left"><code>$</code>el = <code>$</code>this-&gt;byAccessibilityId(<code>'SomeAccessibilityID'</code>);<br><code>$</code>location= $el-&gt;location();</td> 
  </tr> 
 </tbody> 
</table>

##### Description #####

The point (0, 0) refers to the upper-left corner of the page. The element’s coordinates are returned as a JSON object with x and y properties //点（0，0）指的是页面的左上角。元素的坐标作为具有x和y属性的JSON对象返回

##### Support #####

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

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

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

<table> 
 <thead> 
  <tr> 
   <th>Language</th> 
   <th>Support</th> 
   <th>Documentation</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td>All</td> 
   <td>seleniumhq.github.io</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td>All</td> 
   <td>selenium-python.readthedocs.io</td> 
  </tr> 
  <tr> 
   <td>Javascript (WebdriverIO)</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Javascript (WD)</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td>All</td> 
   <td>www.rubydoc.info</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
 </tbody> 
</table>

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

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

`GET /session/:session_id/elements/:element_id/location`

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

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>session_id</td> 
   <td>ID of the session to route the command to</td> 
  </tr> 
  <tr> 
   <td>element_id</td> 
   <td>ID of the element to get the location of</td> 
  </tr> 
 </tbody> 
</table>

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

None

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

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>type</th> 
   <th>description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>x</td> 
   <td><code>number</code></td> 
   <td>X coordinate</td> 
  </tr> 
  <tr> 
   <td>y</td> 
   <td><code>number</code></td> 
   <td>Y coordinate</td> 
  </tr> 
 </tbody> 
</table>