Type command

Enters text into a field on the device screen. The device should be in text-entry-mode: either the virtual keyboard is open or the cursor is waiting for text. Most platforms support Unicode and allow text in any language.

On most devices, the text is sent directly to the operating system, disregarding the keyboard.

Tip: For best performance, it is recommended to use a minimal amount of keyboard languages.

Parameters

Name Type Possible values Description

Device ID*

Device

 

The device for this command. By default, this is the device under test (DUT).

Text*

String

 

The text or encoded text to be entered. The text can be in any language.

If the type is Secured string, then when you start entering a string into the Value field, a lock button appears to the right. To encrypt the string, click the lock button .

Secure Field

Boolean

Null | True | False

Specifies if text typed in a text field will be obscured in the report.

Scope

String

Sentence | Contact | Url | Number

Specifies the text scope. Required for devices that support simulated text entry.

Initial capitalization

String

Auto first | Upper case | Lower case

Specifies the current capitalization state of typing. Only relevant if the current position is not the first character. Required for devices that support simulated text entry.

Comment

String

 

Adds a comment to the script.

On-fail Result*

Condition

Ignore | Break | Continue | Abort | Catch

The behavior when the command fails.

* Mandatory parameter