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

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.

mobile:espresso:execute

Executes Espresso test scripts on the device.

mobile:xctest:executeExecute XCTest test scripts directly on the current device in the Perfecto Lab

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

  • No labels