Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Dec 06, 2017 15:23

The Perfecto Lab provides support for extended RemoteWebDriver commands, which can be used as an extension to the existing API. For details on the commands, see the Function Reference section.

* Click here for a description and code sample of how to execute the Perfecto extensions.

Network

CommandDescription
mobile:network.settings:get

Retrieves the network settings specified by the Property parameter, and can insert its value into a defined variable.

mobile:network.settings:set

Sets the network settings.

Services

Command

Description

mobile:gateway:call

Generates an external voice call recording to the selected destination.

mobile:gateway:email

Sends an email message to the selected destination.

mobile:gateway:sms

Sends an SMS message to the selected destination.

Visual Analysis

Command

Description

mobile:button-image:clickIdentifies a button, based on an image, and clicks on it.
mobile:button-text:click

Identifies a button, based on a text label, and clicks on it.

mobile:edit-image:getRetrieve the value of an edit field into a variable.
mobile:edit-image:setSet a text value into a form input field.
mobile:edit-text:get

Identifies an edit field, based on a text label, and retrieves its value.

mobile:edit-text:set

Identifies an edit field, based on a text label, and inserts the specified text in the value parameter into the field.

mobile:checkpoint:imageValidate image appearance on the device.
mobile:checkpoint:textValidate appearance of expected text on the device.
mobile:image:findFinds image on the device screen.
mobile:image:selectFind an image on the device screen and click on it.
mobile:text:find

Finds text (needle) on the device screen (haystack), and stores the coordinates for future commands.

mobile:text:select

Finds text (needle) on the device screen (haystack), and clicks it to select the item.

mobile:screen:text

Returns the text that appears on the screen of the device without selecting it.

User Actions

Command

Description

mobile:touch:drag

Perform drag action on a touch screen

mobile:touch:gesture

Performs the selected multi-touch operation, pinch and zoom.

mobile:touch:swipe

Perform a swipe operation on the device.

mobile:touch:tap

Perform a touch operation on the device.

mobile:trackball:roll

Performs a trackball roll (in BB devices).

Applications

Command

Description

mobile:application:close

Close an application on the device.

mobile:application:back

Moves the application to the background for a specified duration.

mobile:application:clean

Brings the application to its initial installation state.

mobile:application:install

Install an application from the repository on the device.

mobile:application:open

Start an application on the device.

mobile:application:reset

Uninstall all applications from the device.

mobile:application:uninstall

Uninstall an application from the device.

mobile:activity:startStart an activity (application component) on the device.
mobile:activity:syncVerifies the Android package or activity (application component) has started on the device.
mobile:notifications:open

Opens the notifications shade.

Browser

CommandDescription
mobile:browser:clean

Clears the browser content.

mobile:browser:execute

Executes a JavaScript script on the device browser application.

mobile:browser:open

Opens the browser.

mobile:browser:sync

Verifies the browser application is running and page is loaded.

Device

Command

Description

mobile:handset:log

Retrieve a log file from the device

mobile:handset:rotate

Set the rotation position of the device

mobile:keyboard:display

Control the virtual keyboard display

mobile:device:info Retrieves the specified device property value into a defined variable.
mobile:handset:readyBrings the device to its idle / home screen
mobile:device:reboot 

Reboots the device, and returns it unlocked.

mobile:device:recover

Recovers an unresponsive connected device, such as, with an interrupted video, black screen, or touch failure.

mobile:screen:lock

Locks the device screen for a specified duration (in seconds).

mobile:audio.recording:startStarts recording the audio output from the device
mobile:audio.recording:stopCompletes the recording and saves the audio file to the media storage server
mobile:handset:voiceCommandSends text String to the device's Voice Assistant (for example, Siri) and allows the assistant to complete the action.

Events

CommandDescription
mobile:audio:inject

Plays an audio file (mp3/wav) into the device audio-in.

mobile:key:event

Sends a key event to the device, using key codes and metastates.

mobile:presskey

Clicks a single or a sequence of device keyboard keys.

Files

Command

Description

mobile:media:delete

Delete the specified file from the device.

mobile:media:get

Copy a file from the device to the repository.

mobile:media:put

Upload a file from the repository to the device.

Location

CommandDescription
mobile:location:getGets the device location.
mobile:location:resetResets the device location.
mobile:location:setSets the device location.

Network Virtualization

Command

Description

mobile:vnetwork:start

Starts network virtualization for the device with the specified conditions.

mobile:vnetwork:stop

Stops network virtualization for the device and save PCAP file to the repository.

mobile:vnetwork:update

Updates network virtualization for the device with the specified conditions.

Timer

CommandDescription
mobile:timer:start

Begins to measure time, with the specified timer ID, until the mobile:timer:stop is invoked.

mobile:timer:stopStops time measurement of specified timer.
mobile:timer:infoRetrieves the specified timer value.
mobile:status:timer

Adds a timer report to the test. The measured timer result is reported from the test into the generated Single Test Report.

Vitals

Command

Description

mobile:monitor:start

Start collecting monitor data

mobile:monitor:stop

Stop collecting monitor data

Execution Reports

See the Reporting Public API information