Send Keys
Send a sequence of key strokes to an element //向元素发送一系列按键
Example Usage
Java | MobileElement element = (MobileElement) driver.findElementByAccessibilityId("SomeAccessibilityID" );element.sendKeys( "Hello world!" ); |
Python | self.driver.find_element_by_accessibility_id('SomeAccessibilityID' ).send_keys('Hello world!' ) |
Javascript | // webdriver.io example $( "~SomeAccessibilityId" ).addValue("Enter" );// wd example let element = await driver.elementByAccessibilityId( "SomeAccessibilityID" );await element.type( "Hello world!" ) |
Ruby | # ruby_lib example find_element(:accessibility_id, "SomeAccessibilityID" ).send_keys("Hello World!" )# ruby_lib_core example @driver.find_element(:accessibility_id, "SomeAccessibilityID" ).send_keys("Hello World!" ) |
C# | MobileElement el = driver.FindElement(MobileByAccessibilityID("Some ID" );el.SendKeys( "Some Text" );//Example MobileElement el = driver.FindElement(MobileById( "Some ID" );el.SendKeys( "Hello World" ); |
PHP | $el =
t
h
i
s
−
>
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
′
‘
)
;
<
b
r
/
>
this->byAccessibilityId(`'SomeAccessibilityID'`);<br/>
this−>byAccessibilityId(‘′SomeAccessibilityID′‘);<br/>el->setText('Hello world!' ); |
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
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/:element_id/value
URL Parameters
name | description |
---|---|
session_id | ID of the session to route the command to |
element_id | ID of the element to send keys to |
JSON Parameters
name | type | description |
---|---|---|
value | array<string> | (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 |
text | string | (W3C) A single string to be typed |
Response
null