Constants

Virtual Remote Control (VRC) button key codes

VRC buttons are used via suitest.VRC.*, * being a key code from below. For example suitest.VRC.FAST_FWD.

Smart TVs

Code Key name Unicode value IR-controlled Android TV Apple tvOS Roku
BACK Back \uE600 ✓ ✓ - ✓
BLUE Blue \uE500 ✓ ✓ - ✓ (B)
BUTTON_10 Gamepad button 10 \uE530 - ✓ - -
BUTTON_11 Gamepad button 11 \uE531 - ✓ - -
BUTTON_12 Gamepad button 12 \uE532 - ✓ - -
CH_DOWN Channel down \uE5F0 ✓ ✓ - -
CH_UP Channel up \uE5F1 ✓ ✓ - -
D_PAD_CENTER D-pad center \uE540 - ✓ - -
DOWN Down \uE5E0 ✓ ✓ ✓ ✓
ENTER Enter \uE601 ✓ ✓ - -
EXIT Exit \uE602 ✓ ✓ - ✓ (home)
FAST_FWD Fast forward \uE520 ✓ ✓ - ✓
GREEN Green \uE501 ✓ ✓ - ✓ (A)
GUIDE Guide \uE5B0 ✓ ✓ - -
HOME Home \uE603 - - ✓ ✓
LEFT Left \uE5E1 ✓ ✓ ✓ ✓
MENU Menu \uE5B1 ✓ ✓ ✓ -
MUTE Mute \uE521 ✓ ✓ - -
NEXT Next \uE52C ✓ - - -
NUM_0 Numpad 0 \uE610 ✓ ✓ - -
NUM_1 Numpad 1 \uE611 ✓ ✓ - -
NUM_2 Numpad 2 \uE612 ✓ ✓ - -
NUM_3 Numpad 3 \uE613 ✓ ✓ - -
NUM_4 Numpad 4 \uE614 ✓ ✓ - -
NUM_5 Numpad 5 \uE615 ✓ ✓ - -
NUM_6 Numpad 6 \uE616 ✓ ✓ - -
NUM_7 Numpad 7 \uE617 ✓ ✓ - -
NUM_8 Numpad 8 \uE618 ✓ ✓ - -
NUM_9 Numpad 9 \uE619 ✓ ✓ - -
OK Ok \uE5B2 ✓ ✓ - ✓
PAUSE Pause \uE522 ✓ ✓ - -
PLAY Play \uE523 ✓ ✓ - -
PLAY_PAUSE Play/pause one button \uE524 ✓ ✓ ✓ ✓
POWER Power \uE5B4 ✓ - - -
PREVIOUS Previous \uE52B ✓ - - -
RECORD Record \uE525 ✓ ✓ - -
RED Red \uE502 ✓ ✓ - -
REPLAY Replay \uE526 - - - ✓
REWIND Rewind \uE52A ✓ ✓ - ✓
RIGHT Right \uE5E2 ✓ ✓ ✓ ✓
SELECT Select \uE5B5 - - ✓ -
SETTINGS Settings \uE5B6 ✓ ✓ - ✓
SMART Smart \uE5B7 ✓ ✓ - -
SOURCE Source \uE5B8 ✓ ✓ - -
SPECIAL_NETFLIX Netflix \uE5D0 ✓ - - -
SPECIAL_YOUTUBE YouTube \uE5D1 ✓ - - -
STOP Stop \uE527 ✓ ✓ - -
TELETEXT Teletext \uE528 ✓ ✓ - -
TV TV (switch to live TV) \uE529 ✓ ✓ - -
UP Up \uE5E3 ✓ ✓ ✓ ✓
VOL_DOWN Volume down \uE5F2 ✓ ✓ - -
VOL_UP Volume up \uE5F3 ✓ ✓ - -
YELLOW Yellow \uE503 ✓ ✓ - -

Gaming consoles

Code Key name Unicode Xbox * PlayStation 4/5
A A button \uE620 ✓ (green) ✓
B B button \uE621 ✓ (red) ✓
BACK Back \uE600 ✓ ✓
CIRCLE Circle \uE510 - ✓
D_PAD_DOWN D-pad down \uE541 ✓ ✓
D_PAD_LEFT D-pad left \uE542 ✓ ✓
D_PAD_RIGHT D-pad right \uE543 ✓ ✓
D_PAD_UP D-pad up \uE544 ✓ ✓
DOWN Down \uE5E0 ✓ ✓
ENTER Enter \uE601 ✓ ✓
HOME Home \uE603 ✓ ✓
L1 L1 \uE580 ✓ ✓
L2 L2 \uE581 ✓ ✓
LEFT Left \uE5E1 ✓ ✓
LEFT_BUMPER Left bumper \uE550 ✓ ✓
LEFT_THUMBSTICK_BUTTON Left thumbstick button \uE570 ✓ ✓
LEFT_THUMBSTICK_DOWN Left thumbstick down \uE571 ✓ ✓
LEFT_THUMBSTICK_LEFT Left thumbstick left \uE572 ✓ ✓
LEFT_THUMBSTICK_RIGHT Left thumbstick right \uE573 ✓ ✓
LEFT_THUMBSTICK_UP Left thumbstick up \uE574 ✓ ✓
LEFT_TRIGGER Left trigger \uE560 ✓ ✓
MENU Menu \uE5B1 ✓ -
OK Ok \uE5B2 ✓ ✓
OPTIONS Options \uE5B3 - ✓
POWER Power \uE5B4 ✓ ✓
R1 R1 \uE590 ✓ ✓
R2 R2 \uE591 ✓ ✓
RIGHT Right \uE5E2 ✓ ✓
RIGHT_BUMPER Right bumper \uE551 ✓ ✓
RIGHT_THUMBSTICK_BUTTON Right thumbstick button \uE57A ✓ ✓
RIGHT_THUMBSTICK_DOWN Right thumbstick down \uE57B ✓ ✓
RIGHT_THUMBSTICK_LEFT Right thumbstick left \uE57C ✓ ✓
RIGHT_THUMBSTICK_RIGHT Right thumbstick right \uE57D ✓ ✓
RIGHT_THUMBSTICK_UP Right thumbstick up \uE57E ✓ ✓
RIGHT_TRIGGER Right trigger \uE561 ✓ ✓
SHARE Share \uE5A0 - ✓
SQUARE Square \uE511 ✓ ✓
TRIANGLE Triangle \uE512 ✓ ✓
UP Up \uE5E3 ✓ ✓
VIEW View \uE5A1 ✓ -
X X (Blue) button \uE637 ✓ ✓
Y Y (Yellow) button \uE638 ✓ ✓

* Xbox (One, Series X/S)

Mobile devices

Code Key name Unicode Android mobile Apple iOS
BACK Back \uE600 ✓ ✓
HOME Home \uE603 ✓ ✓
LOCK Lock \uE5C0 ✓ ✓
RECENT_APPS Recent applications \uE5C1 ✓ -
VOL_DOWN Volume down \uE5F2 ✓ ✓
VOL_UP Volume up \uE5F3 ✓ ✓

Browsers

The following key codes are meant to be used only with Appium integration.

Key Unicode
Add, Plus \uE025
Alt \uE00A
Back space \uE003
Cancel \uE001
Clear \uE005
Control \uE009
Decimal \uE028
Delete \uE05D
Divide \uE029
Down arrow \uE05B
End \uE010
Enter \uE007
Equals \uE019
Escape \uE00C
F1 \uE031
F2 \uE032
F3 \uE033
F4 \uE034
F5 \uE035
F6 \uE036
F7 \uE037
F8 \uE038
F9 \uE039
F10 \uE03A
F11 \uE03B
F12 \uE03C
Help \uE002
Home \uE057
Insert \uE05C
Left arrow \uE058
Meta \uE053
Multiply \uE024
NULL \uE029
Numpad 0 \uE01A
Numpad 1 \uE01B
Numpad 2 \uE01C
Numpad 3 \uE01D
Numpad 4 \uE01E
Numpad 5 \uE01F
Numpad 6 \uE020
Numpad 7 \uE021
Numpad 8 \uE022
Numpad 9 \uE023
Pagedown \uE00F
Pageup \uE00E
Pause \uE00B
Return \uE006
Right arrow \uE014
Semicolon \uE018
Comma \uE026
Shift \uE008
Space \uE00D
Subtract \uE027
Tab \uE004
Up arrow \uE013

Element properties

Element properties are used via suitest.PROP.*, * being a key code from below. For example suitest.PROP.CLASS.

Code Property description HTML-based Android Xbox Native * tvOS Roku
ACCESSIBILITY_IDENTIFIER unique identifier for element in scripts using UI Automation interface - - - ✓ -
ALPHA Transparency level from 0 to 1 - ✓ - ✓ -
AUTOMATION_ID Uniquely identifies the element in UI automation tools - - ✓ - -
AUTOMATION_NAME Name of an element used in UI automation tools - - ✓ - -
BAR_TINT_COLOR Color applied to the bar's background - - - ✓ -
BG_COLOR Color applied to the element background ✓ ✓ ✓ ✓ -
BORDER_COLOR Color applied to the border line of the element ✓ - ✓ - -
BORDER_STYLE Variant of the border line ✓ - - ✓ -
BORDER_WIDTH Width of the border line ✓ - ✓ - -
CLASS Class attribute ✓ - - - -
CONTENT_DESCRIPTION Value for accessibility services - ✓ - - -
CONTENT_MODE States how element's content layout changes when bounds change - - - ✓ -
FOCUS_MARGIN Only if UseSystemFocusVisuals is enabled - - ✓ - -
FOCUS_PRIMARY_COLOR Only if UseSystemFocusVisuals is enabled - - ✓ - -
FOCUS_PRIMARY_WIDTH Only if UseSystemFocusVisuals is enabled - - ✓ - -
FOCUS_SECONDARY_COLOR Only if UseSystemFocusVisuals is enabled - - ✓ - -
FOCUS_SECONDARY_WIDTH Only if UseSystemFocusVisuals is enabled - - ✓ - -
FONT_FAMILY Font of text - - ✓ ✓ -
FONT_NAME name of the font name - - - ✓ -
FONT_SIZE Size of text - - ✓ ✓ -
FONT_URI URI of font - - - - ✓
FONT_WEIGHT Font weight of text - - ✓ - -
HAS_FOCUS Does the element have focus - ✓ - - -
HAS_META_DATA Video property has metadata - - - ✓ -
HAS_NAV_MARKERS Video property has navigation markers groups - - - ✓ -
HEIGHT Height of an element ✓ ✓ ✓ ✓ ✓
HINT Default text for editable text fields - ✓ - - -
HREF If the element is a link the href attribute will hold the URL ✓ - - - -
ID Id attribute of the element ✓ - ✓ - ✓
IMAGE URL of an image ✓ - ✓ - ✓
IMAGE_HASH Base64 string of the image converted to MD5 hash - - ✓ ✓ -
IMAGE_LOAD_STATE Current status of the image state ✓ - - - -
IS_CHECKED If the element is in a checked state - ✓ ✓ - -
IS_CLICKABLE If the element is clickable (reacts to click events) - ✓ - - -
IS_COMPLETELY_DISPLAYED If the complete view width and height is visible - ✓ - - -
IS_ENABLED If the element is in an enabled state - ✓ ✓ ✓ -
IS_FOCUSABLE If the element is able to change to a focus state - ✓ - - -
IS_FOCUSED Is the element currently focused - - - ✓ -
IS_OPAQUE Is the element currently opaque - - - ✓ -
IS_SELECTED If the element is currently in the selected state - ✓ ✓ - -
IS_TOUCHABLE If the element has a touchable area - ✓ - - -
ITEMS_FOCUSED Element focused in list - - - - ✓
LEFT Relative horizontal position to the parent element (in pixels) ✓ ✓ ✓ ✓ ✓
LEFT_ABSOLUTE Element's left coordinate according to window origin - - ✓ ✓ -
MARGIN Value of the margin space around the element - - ✓ - -
NAME Name given to the element - - ✓ ✓ -
NUMBER_OF_SEGMENTS The number of segments in Segmented Control - - - ✓ -
OPACITY Opacity of the element ✓ - ✓ - ✓
PACKAGE_NAME Name-space of the view - ✓ - - -
PADDING Value of the element's padding in all directions - ✓ ✓ - -
PIVOT_X The X coordinate around which the element is rotated - ✓ - - -
PIVOT_Y The Y coordinate around which the element is rotated - ✓ - - -
PLACEHOLDER String that is displayed when no text is in the input field - - - ✓ -
PROPOSAL_URL Video element that is proposed to be played next - - - ✓ -
SCALE_X The X coordinate around which the element is scaled - ✓ - - -
SCALE_Y The Y coordinate around which the element is scaled - ✓ - - -
SELECTED_IMAGE_TINT_COLOR Color applied to selected tab bar item - - - ✓ -
STATE Constant describing the state of the element - - - ✓ -
TAG String representation of the elements tag - ✓ - - -
TAG_INT Non-unique identifier for view objects - - - ✓ -
TEXT_ALIGNMENT Alignment of text inside the element - - - ✓ -
TEXT_COLOR Color of the text ✓ ✓ ✓ - -
TEXT_CONTENT Plain text of an element ✓ ✓ ✓ - ✓
TEXT_SIZE Size of the elements text in pixels - ✓ - - -
TINT_COLOR Color tint of the element - - - ✓ -
TOP Relative vertical position to the parent element (in pixels) ✓ ✓ ✓ ✓ ✓
TOP_ABSOLUTE Element's top coordinate according to the window origin - - ✓ ✓ -
TRANSLATION_X The horizontal location of the element relative to its left position - ✓ - - -
TRANSLATION_Y The vertical location of the element relative to its top position - ✓ - - -
URL URL of WebView component - - ✓ - -
VIDEO_LENGTH Total length of a video ✓ ✓ ✓ ✓ ✓
VIDEO_POSITION Current position of a video ✓ ✓ ✓ ✓ ✓
VIDEO_STATE Current state of a video ✓ ✓ ✓ ✓ ✓
VIDEO_URL URL of a video ✓ ✓ ✓ ✓ ✓
VISIBILITY If the element is visible on screen - ✓ ✓ - ✓
WIDTH Width of the element ✓ ✓ ✓ ✓ ✓
Z_INDEX Value of the CSS z-index property ✓ - - - -

* Xbox (One, Series X/S)

Roku Lite element properties

Code Property description
CHILDREN Element child count
EXTENDS Extends element
HEIGHT Height of an element
ID Id attribute of the element
IMAGE URL of an image
IMAGE_LOAD_STATE Current status of the image state
INDEX Value of the index property
IS_FOCUSABLE If the element is able to change to a focus state
IS_FOCUSED Is the element currently focused
ITEMS_FOCUSED Element focused in list
LEFT Relative horizontal position to the parent element (in pixels)
OPACITY Opacity of the element
TEXT_COLOR Color of the text
TEXT_CONTENT Plain text of an element
TOP Relative vertical position to the parent element (in pixels)
UI_ELEMENT_ID Identifier for the element
VISIBILITY If the element is visible on screen
WIDTH Width of the element

Property comparators

Code Comparator description
APPROX Approximately
CONTAIN Contains
END Ends with
EQUAL =
EQUAL_GREATER >=
EQUAL_LESSER <=
GREATER >
LESSER <
NOT_CONTAIN Does not contain
NOT_END Does not end with
NOT_EQUAL !=
NOT_START Does not start with
START Starts with

Element special values

Code Special value description
REPO Value for element property is taken from Element repository

Video states

Video states can be found in suitest.VIDEO_STATE.

Code State description HTML-Based Android Xbox Native * Apple TV Roku Roku lite
BUFFERING Player is downloading video source over network to create a buffer ✓ ✓ - ✓ ✓ ✓
CONNECTING Player is trying to connect to video source ✓ - ✓ - - -
ERROR Error occurred during video initialization or playback ✓ ✓ ✓ ✓ ✓ ✓
FINISHED Playback has finished, video source was played till the end ✓ - ✓ ✓ ✓ ✓
IDLE Video is in pre-preparing phase - ✓ - - - -
NONE There is no state of the video - - - - ✓ ✓
PAUSED Paused ✓ ✓ ✓ ✓ ✓ ✓
PLAYBACK_COMPLETED Playback has finished, video source was played till the end - ✓ - - - -
PLAYING Playing ✓ ✓ ✓ ✓ ✓ ✓
PREPARED Video is prepared for playback - ✓ - - - -
PREPARING Video is being prepared for playback - ✓ - - - -
REVERSING Video is being played in reverse - - - ✓ - -
STOPPED Playback stopped ✓ - ✓ - ✓ -
UNKNOWN State cannot be obtained - ✓ - - - -

* Xbox (One, Series X/S)

Element visibility states

Element visibility states can be found in suitest.VISIBILITY_STATE.

Code State description Android Xbox Native *
COLLAPSED Element is not visible - ✓
GONE Element is not visible ✓ ✓
INVISIBLE Element is not visible ✓ ✓
VISIBLE Element is visible ✓ ✓

* Xbox (One, Series X/S)

Network properties

Network properties can be found in suitest.NETWORK_PROP.

Code
BODY
METHOD
STATUS

Network methods

Network methods can be found in suitest.NETWORK_METHOD.

Code
CONNECT
DELETE
GET
HEAD
OPTIONS
PATCH
POST
PUT
TRACE

Border style

Border style properties can be found in suitest.BORDER_STYLE.

Code HTML-Based Apple TV
BEZEL - ✓
DASHED ✓ -
DOTTED ✓ -
DOUBLE ✓ -
GROOVE ✓ -
HIDDEN ✓ -
INHERIT ✓ -
INITIAL ✓ -
INSET ✓ -
NONE ✓ ✓
OUTSET ✓ -
RECTANGLE - ✓
RIDGE ✓ -
ROUNDED - ✓
SOLID ✓ -

Launch modes (Android/LG webOS applications)

Launch modes can be found in suitest.LAUNCH_MODE.

Code
RESUME
RESTART

Screen orientations (Android mobile/iOS/iPadOS devices)

Screen orientations can be found in suitest.SCREEN_ORIENTATION.

Code Analogue in Test Editor
PORTRAIT Portrait
PORTRAIT_REVERSED Portrait (upside down / reversed)
LANDSCAPE Landscape (left)
LANDSCAPE_REVERSED Landscape (right / reversed)

Content Mode (Apple TV)

Content modes can be found in suitest.CONTENT_MODE.

Code
BOTTOM
BOTTOM_LEFT
BOTTOM_RIGHT
CENTER
LEFT
REDRAW
RIGHT
SCALE_ASPECT_FILL
SCALE_ASPECT_FIT
SCALE_TO_FILL
TOP
TOP_LEFT
TOP_RIGHT

State (Apple TV)

States can be found in suitest.ELEMENT_STATE. Check the Apple Developer guide for Focus and Selection for some visual examples.

Code
APPLICATION
DISABLED
FOCUSED
HIGHLIGHTED
NORMAL
RESERVED
SELECTED

Text Alignment (Apple TV)

Text alignment states can be found in suitest.TEXT_ALIGNMENT.

Code
CENTER
JUSTIFIED
LEFT
NATURAL
RIGHT