Appium-Send Keys(发送密钥)

我不是女神ヾ 2022-11-19 01:26 116阅读 0赞

### Send Keys ###

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

Send a sequence of key strokes to an element //向元素发送一系列按键

##### 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 element = (MobileElement) driver.findElementByAccessibilityId(<code>"SomeAccessibilityID"</code>); element.sendKeys(<code>"Hello world!"</code>);</td> 
 </tr> 
 <tr> 
 <td align="left">Python</td> 
 <td align="left">self.driver.find_element_by_accessibility_id(<code>'SomeAccessibilityID'</code>).send_keys(<code>'Hello world!'</code>)</td> 
 </tr> 
 <tr> 
 <td align="left">Javascript</td> 
 <td align="left">// webdriver.io example $(<code>"~SomeAccessibilityId"</code>).addValue(<code>"Enter"</code>); // wd example let element = await driver.elementByAccessibilityId(<code>"SomeAccessibilityID"</code>); await element.type(<code>"Hello world!"</code>)</td> 
 </tr> 
 <tr> 
 <td align="left">Ruby</td> 
 <td align="left"># ruby_lib example find_element(:accessibility_id, <code>"SomeAccessibilityID"</code>).send_keys(<code>"Hello World!"</code>) # ruby_lib_core example @driver.find_element(:accessibility_id, <code>"SomeAccessibilityID"</code>).send_keys(<code>"Hello World!"</code>)</td> 
 </tr> 
 <tr> 
 <td align="left">C#</td> 
 <td align="left">MobileElement el = driver.FindElement(MobileByAccessibilityID(<code>"Some ID"</code>); el.SendKeys(<code>"Some Text"</code>); //Example MobileElement el = driver.FindElement(MobileById(<code>"Some ID"</code>); el.SendKeys(<code>"Hello World"</code>);</td> 
 </tr> 
 <tr> 
 <td align="left">PHP</td> 
 <td align="left">$el = t h i s − &gt; b y A c c e s s i b i l i t y I d ( ‘ ′ S o m e A c c e s s i b i l i t y I D ′ ‘ ) ; &lt; b r / &gt; this-&gt;byAccessibilityId(`'SomeAccessibilityID'`);&lt;br/&gt; this−&gt;byAccessibilityId(‘′SomeAccessibilityID′‘);&lt;br/&gt;el-&gt;setText(<code>'Hello world!'</code>);</td> 
 </tr> 
 </tbody> 
</table>

##### Description #####

Any UTF-8 character may be specified, however, if the server does not support native key events, it should simulate key strokes for a standard US keyboard layout. The Unicode Private Use Area code points, 0xE000-0xF8FF, are used to represent pressable, non-text keys (see table below). (See Unicode document for information on Unicode characters) //可以指定任何UTF-8字符，但是，如果服务器不支持本机键事件，它应该模拟标准美国键盘布局的按键。Unicode专用区号点0xE000-0xF8FF用于表示可按的非文本键（见下表）。（有关Unicode字符的信息，请参阅Unicode文档）

##### 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/:element_id/value`

###### 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> 
 <tr> 
 <td align="left">element_id</td> 
 <td align="left">ID of the element to send keys 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">value</td> 
 <td align="left"><code>array&lt;string&gt;</code></td> 
 <td align="left">(MJSONWP) The sequence of keys to type. An array must be provided. The server should flatten the array items to a single string to be typed</td> 
 </tr> 
 <tr> 
 <td align="left">text</td> 
 <td align="left"><code>string</code></td> 
 <td align="left">(W3C) A single string to be typed</td> 
 </tr> 
 </tbody> 
</table>

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

null