Available commands and checkpoints
This sections provides a list of the commands and checkpoints available in Scriptless Mobile along with descriptions and references to more information, where available.
When you have sufficiently tested your tests, you can invoke them through CI/CD from external tools like Jenkins using the API calls described in Script Operations.
Group | Command | Description | More info |
---|---|---|---|
Applications |
Clean application |
Cleans the data (including cache) from any application installed on the device and brings the application back to its initial state. This saves time and instantly resets the app for the next test. To use this command, the application identifier is required. For information on retrieving the application identifier, see Application identifier. |
Perfecto extension: Clean application |
Applications |
Close application |
Closes an application on the device. The application process is killed, not minimized. If you reopen the application, the application will launch from the start page. (If you minimize the application, for example by using the Home button, the application will launch from the last page previously open.) To use this command, the application identifier is required. For information on retrieving the application identifier, see Application identifier. This command does not clear the cache. Service applications that live forever in the background may be auto-relaunched. |
Perfecto extension: Close application |
Applications |
Get installed applications |
Gets the list of applications installed on the device. |
|
Applications |
Install application |
Installs a single application on the device, using automation. To use this command, the application must first be uploaded to the Perfecto repository. The PerfectoLabUtils class provides the uploadMedia method to upload a file to the Repository. |
Perfecto extension: Install application |
Applications |
Run app in background |
Identifies the active application automatically, moves it to the background for the timeout defined, and then returns it to the foreground. You can check how your application behaves when coming back into foreground: Is your data saved? Is your session alive? Did your application crash? |
Perfecto extension: Run app in background |
Applications |
Set fingerprint |
Injects the authentication reply for a fingerprint check performed by the application. The command should be activated by the automation script at the point that the target application presents a "popup" indicating that the application is trying to retrieve information from the fingerprint reader. The application must have been installed with sensor instrumention enabled. To use this command, one of the two application identifiers is required. For information on retrieving the application identifier, see Application identifier. |
Perfecto extension: Set fingerprint |
Applications |
Set sensor authentication |
Injects the authentication reply for a sensor authentication check performed by the application (such as fingerprint or faceId) on supported devices. The command should be activated by the automation script at the point that the target application presents a popup window indicating that the application is trying to retrieve information from the sensor reader. The application must have been installed with sensor instrumentation enabled. To use this command, one of the two application identifiers is required. For information on retrieving the application identifier, see Application identifier. |
|
Applications |
Start activity |
Starts an Android activity on the device. Android applications are composed of a series of "Activity" units. Each Activity presents a UI screen that allows users to perform some part of the application, such as call a number, take a photo, send an email, or view a map. When testing the application, it may be desirable to start the application execution from a specific Activity, rather than the initial Activity (usually referred to as the .Main). Applications can be large and complex, written by many development teams. The start activity and sync activity commands enable a tester to start and sync a specific activity on the device and decreases the time it takes to write a test, allowing more coverage in a dynamic environment where time to develop tests is short. |
Perfecto extension: Start activity |
Applications |
Start application |
Launches an application on the device. Use this function at the beginning of a script to ensure a known starting point for the user. To use this command, one of the two application identifiers is required. For information on retrieving the application identifier, see Application identifier. |
Perfecto extension: Start application |
Applications |
Start PWA |
Launches a progressive web application (PWA) on the device. To use this command, the display name of the PWA icon is required. |
Perfecto extension: Start PWA |
Applications |
Stop PWA |
Closes the progressive web application (PWA) currently running in the foreground. |
Perfecto extension: Stop PWA |
Applications |
Sync activity |
Verifies that the Android package or activity has started on the device. At least one of the package or activity parameters must be provided. |
Perfecto extension: Sync activity |
Applications |
Uninstall application |
Removes a single application from the device. You can remove a single application or all applications from the device, returning the device to its out-of-the-box state. For more information on removing all applications, refer to the Uninstall applications command. To use this command, an application identifier is required. For information on retrieving the application identifier, see Application identifier. Restriction: Pre-installed (system) applications cannot be uninstalled.
|
Perfecto extension: Uninstall application |
Applications |
Uninstall applications |
Uninstalls all applications on the device, returning the device to its initial state. This does not affect applications pre-installed on the device. You can remove a single application or all applications from the device, returning it to its out-of-the-box state. For more information on removing a single application, seeUninstall application. |
Perfecto extension: Uninstall applications |
Audio |
Audio to text |
Converts audio to text by applying powerful neural network models. It accepts an audio file that may be recorded from a device and creates a text file that contains the textual translation of the audio file. Important: This functionality is part of the Advanced Audio Package, a separate license that provides access to tools for testing a device's audio quality. For more information, contact your Perfecto account representative.
|
Perfecto extension: Audio to text |
Audio |
Audio to text validation |
Accepts an audio file that may be recorded from a device and creates a text file that contains the textual translation (transcript) of the audio file. In addition, the command performs a text checkpoint function, checking for the existence of a text string in the translated text file. This function utilizes matching parameters similar to the text checkpoint function. Important: This functionality is part of the Advanced Audio Package, a separate license that provides access to tools for testing a device's audio quality. For more information, contact your Perfecto account representative.
|
Perfecto extension: Audio to text validation |
Audio |
Audio validation |
Validates audio input for MOS quality (WAV audio files only). The command receives an audio file that may have been recorded from a device and uses parameters to trim off any silence from the beginning or end of the audio. Using this trimmed file, it then executes an analysis service. Important: This functionality is part of the Advanced Audio Package, a separate license that provides access to tools for testing a device's audio quality. For more information, contact your Perfecto account representative.
|
Perfecto extension: Audio validation |
Audio |
Inject audio |
Plays an audio file into the device audio-in. Supported file types: MP3 and WAV. When using the Text to Speech command with audio injection, the audio file should be in the .wav format. When selecting Wait, the audio file cannot exceed 4 minutes. For audio files longer than 4 minutes, select No wait and follow with a Wait command. The quality of sound (sample rate) needs to be 16000 Hz or above. Restriction: Audio Injection is supported only for devices that are audio-enabled but not through a Yosemite connection.
|
Perfecto extension: Inject audio |
Audio |
Start audio recording |
Starts recording the audio output from the device and creates a WAV file. The file is saved in the media storage server. A URL to the file location is returned in the response to the command and, if supplied, in the Result variable supplied as a parameter. To hear the audio when using Start Audio in the Perfecto Automation IDE, you need to use the Open Device command and the parameter "Audio Recording" should be set to TRUE. Important: The audio file is not available until after the Stop audio recording command is completed.
|
Perfecto extension: Start audio recording |
Audio |
Stop audio recording |
Stops recording the audio output from the device, closes the file, and stores it in the media storage server at the URL declared at the start of audio recording. Important: The audio file is not available until after the Stop audio recording command is completed.
|
Perfecto extension: Stop audio recording |
Audio |
Text to audio |
Accepts either a text file or text string and returns an audio file. The function can be configured to produce the audio with a male or female voice and supports several languages. Important: This functionality is part of the Advanced Audio Package, a separate license that provides access to tools for testing a device's audio quality. For more information, contact your Perfecto account representative.
|
Perfecto extension: Text to audio |
Audio |
Voice assistant inject |
Sends a text string to the device's Voice Assistant (Siri) and allows the assistant to complete the action. Restriction: Supported on devices running iOS 10.3 or later, configured for the XCUITest framework.
|
Perfecto extension: Voice assistant inject |
Browser > Cookies |
Add cookie |
Adds a cookie into the browser cache. |
|
Browser > Cookies |
Delete all cookies |
Deletes all cookies from the browser cache. The browser must be open for the command to function. Restriction: Delete all cookies will not work if there are Cookies that have the Secureor HttpOnly flag set. Use the Delete cookie command to delete each non-secure cookie.
|
|
Browser > Cookies |
Delete cookie |
Deletes a cookie from the browser cache. Restriction: Delete cookie will not for cookies that have the Secure or HttpOnly flag set.
|
|
Browser > Cookies |
Get all cookies |
Returns all cookies for the browser. Each entry in the data table includes the cookie identifier and the link to the page. |
|
Browser > Cookies |
Get cookie |
Returns the value associated with the specified cookie and (optionally) stores it in the variable. |
|
Browser |
Browser clean |
Clears the browser content. The browser being cleaned is inherited from the Browser open or Browser goto commands. No validation is performed. The green success status confirmation within the execution report does not validate that the browser was opened; rather, it validates that the native command request was successfully received by the device OS. Important: The supported browser needs to be open and "on top" of the device screen.
|
Perfecto extension: Browser clean |
Browser |
Browser execute |
Executes a JavaScript script on the device browser application. Supported for Chrome, Safari, and instrumented hybrid apps. |
Perfecto extension: Browser execute |
Browser |
Browser go to |
Opens the browser application and browses to the specified location. This is done with a direct native command to the device OS, and not with navigation. No validation is performed. The green success status confirmation within the execution report does not validate that the browser was opened; rather, it validates that the native command request was successfully received by the device OS. The URL page will not refresh if the browser go to function is used with the same URL consecutively. To ensure that the URL page is reloaded, use the Browser open function followed by the Browser go to function. |
Perfecto extension: Browser go to |
Browser |
Browser navigate |
Directs the browser page back and forward (supports the browser's navigation buttons). Can also be used to refresh the current webpage. The command can be used with Java code. |
Perfecto extension: Browser navigate |
Browser |
Browser open |
Opens the browser. This is done with a direct native command to the device OS, and not with navigation. Supported for Chrome, Safari, and instrumented hybrid apps. No validation is performed. The green success status confirmation within the execution report does not validate that the browser was opened; rather it validates that the native command request was successfully received by the device OS. |
Perfecto extension: Browser open |
Browser |
Browser sync |
Verifies that the browser application is running and the page is loaded. As a best practice, this function should follow a command such as a button click to ensure that the page is loaded following the command. The timeout is performed after the button click, as opposed to the timeout in a button click command, which is performed before the click and waits for the page to load. No validation is performed. The green success status confirmation within the execution report does not validate that the browser was opened; rather it validates that the native command request was successfully received by the device OS. |
Perfecto extension: Browser sync |
Device > Cleanup |
Clean device |
When a "deep clean" is selected, it removes all installed applications, all user data, and all installed files from the device. If the Clean Chrome parameter is selected, it resets the Chrome history on the device. On iOS devices, this command only removes user-installed applications. |
Perfecto extension: Clean device |
Device > Files |
Delete file |
Deletes a single or multiple files from the device storage. Use the File transfer widget to identify the device folder and file name. |
Perfecto extension: Delete file |
Device > Files |
Get file |
Copies a file from the device's file-system to the Perfecto Repository. Provide the full specification of the file location in the Repository and the target file location (including the file name) on the device. |
Perfecto extension: Get file |
Device > Files |
Put file |
Copies a file from the repository to the device's file system. Within iOS applications, you can use this command to place a file in any of the following folders as well: Documents, Library, tmp. If the specified folder does not exist, the command will create the folder before copying the file. This command is supported for automation testing. For interactive testing, you can use the Transfer a file option. |
Perfecto extension: Put file |
Device > Image Injection |
Start image injection |
Retrieves an image from the repository. Perfecto supplies this image to the specified application when the application tries to retrieve a camera image. The application must have been installed with sensor instrumentation. To use this command, one of the two application identifiers is required. For information on retrieving the application identifier, see Application identifier. Image injection continues for this application until activating the Stop Image Injection function. |
Perfecto extension: Start image injection |
Device > Image Injection |
Stop image injection |
Stops Perfecto from supplying an image to the application when the application tries to retrieve a camera image. Images are supplied by the device camera after invoking the command. Used in conjunction with Start Image Injection. |
Perfecto extension: Stop image injection |
Device > Location |
Get location |
Retrieves the current location of the device. The location coordinates are returned as a Latitude, Longitude pair. |
Perfecto extension: Get location |
Device > Location |
Reset location |
Stops setting the device location. This returns the device to its current actual location. Used alongside the Set device location function |
Perfecto extension: Reset location |
Device > Location |
Set location |
Sets the device location. This enables testing a location-aware app that uses location services without moving the device from place to place to generate location data. The location is supplied as one of the following:
|
Perfecto extension: Set location |
Device > Logs |
Get device log |
Retrieves the latest tail number of lines from the operating system log on the device. The device log contains valuable data that can help understand execution problems. |
Perfecto extension: Get device log |
Device > Logs |
Start debug logs |
Notifies the system to start collecting log information. |
|
Device > Logs |
Stop debug logs |
Notifies the system to stop collecting debug log entries. |
|
Device > Network Settings |
Get network settings |
Returns the status of the network setting specified: wifi, data (only for devices with a valid SIM card installed), and/or airplane-mode. Can insert the retrieved value into a defined variable. Use the Property parameter to specify the network setting to retrieve. This command is supported for both Android and iOS devices. Important: If Airplane Mode is enabled, Data will be disabled.
|
Perfecto extension: Get network settings |
Device > Network Settings |
Set network settings |
Sets the status of the specified network settings: wifi, data (only for devices with a valid SIM card installed), and/or airplane-mode. |
Perfecto extension: Set network settings |
Device > Time Zone |
Get time zone |
Retrieves the time zone configured on the device. The return value is a string that complies with the tz database format. |
|
Device > Time Zone |
Reset time zone |
Resets the time zone configured on the device to the default time zone. |
|
Device > Time Zone |
Set time zone |
Sets the device time zone. Before changing the device time zone, verify that the Automatic time zone setting is turned off on the device. The time zone of the device will automatically be reset when the device is closed by Perfecto. The command fails if the timezone parameter does not comply with the tz database format. |
|
Device > Vitals |
Start vitals |
Starts collecting part or all of the real-time vitals data generated by the device until the Vitals stop command is invoked or the script ends. The collected information helps determine how efficient an application is at using resources as well as measuring the general device performance. |
Perfecto extension: Vitals start |
Device > Vitals |
Stop vitals |
Ends the collection of device vitals. The collected information is saved as a CSV file in the repository. Once script execution is complete, the CSV file is available for download from the Single Test Report. If the script contains several start/stop pairs for the same device, there will be a single CSV file for the device, provided the device remains open. Numerous open/close device actions in the scrip will result in several CSV files. In other words, a CSV file is generated per device closure. If the data collection frequency interval, defined by the Vitals start function, is shorter than the script runtime, no CSV file is created. |
Perfecto extension: Vitals stop |
Device |
Close device |
Releases one ore more devices previously allocated to the current session/script execution. When a device is closed, it will automatically be returned to its default state, orientation, and home screen. |
|
Device |
Device info |
Retrieves the specified device property and inserts its value into a defined variable. Use the Property parameter to specify the device property to retrieve. |
Perfecto extension: Device info |
Device |
Device setup |
Sets the environmental properties of the device. Available properties: Location, Orientation, Network and Background applications. |
|
Device |
Device shell |
Runs an adb shell command on an Android device, for example to list the content of a folder on a device or to show a list of devices connected to a device. |
Perfecto extension: Shell command |
Device |
Device state |
Changes the mechanical position of a device that supports a flip cover or slide keyboard. The operation parameter indicates what action to take. |
|
Device |
Get wifi ip address |
Retrieves the internal IP address of the device. Verify that the device is connected to WiFi. Returns the internal IP address of the device in Lab WiFi. |
|
Device |
Keyboard display |
Controls the virtual keyboard display that appears when an edit field is selected |
Perfecto extension: Keyboard display |
Device |
Lock screen |
Locks the device screen for a specified number of seconds. Check instantly how your app behaves when the screen is locked. |
Perfecto extension: Lock screen |
Device |
Open device |
Allocates one or more devices to the current script execution and prepares them for usage. Allocated devices are available to the execution without interruption until either the Close device function is used or the script ends. |
|
Device |
Open notifications |
Opens the notifications shade. This is helpful when testing for scenarios that use notifications from internal and external apps. How does your app behave when a weather notification comes in? |
Perfecto extension: Open notifications |
Device |
Ping device |
Perfecto extension: |
|
Device |
Reboot device |
Reboots the device by performing a software restart on iOS and Android devices and returns it in the unlocked state. |
Perfecto extension: Reboot device |
Device |
Recover device |
The device will not be rebooted; it will be disconnected and reconnected to the Perfecto data center, and returned unlocked. To reboot the device, use the Reboot device function. Recovery will take a few minutes to complete. Use this function at the end of your script instance of the device in error. This is useful for your next run. |
Perfecto extension: Recover device |
Device |
Rotate device |
Rotates the device to either landscape or portrait. To rotate the device orientation, set method to Device. This will affect the screen orientation as well. To rotate the device view without manipulating the device screen, set method to be View. The Next parameter value in operation enables a 90° rotation. The Rotate device function performs the same operation as the Rotate option in the Manual Testing view. The operation and state parameters cannot be used together because they dictate a different behavior. |
Perfecto extension: Rotate device |
Device |
Select device |
Enables selecting a device according to device attributes instead of a specific device ID. For example, specifying an iPad 4 model will randomly select an available iPad 4 device. When you define multiple parameters (such as Model and OS Version), the command will select a single device that matches all of the defined requirements. All Select Device parameters accept regular expressions, including wildcards. The parameters are case insensitive. |
|
Device |
Send key event |
Sends a keyboard event to the device. Uses standard Android keycodes. For example: Key code = 29 and the Metastate = 1 will print an "A" Key code = 29 and the Metastate = 0 will print an "a" Key codes and metastates are defined by Android. |
Perfecto extension: Send key event |
Device |
Toggle radio |
Turns the device's Radio signal on or off. This essentially disconnects or re-connects the cellular service of the device. |
Perfecto extension: Toggle radio |
Device |
Trackball |
Performs a trackball roll. |
Perfecto extension: Trackball |
Reporting |
End test |
Notifies the reporting service that the test execution has finished and the status to report for the test. Important: If success = true, the failureDescription parameter should not be included.
See also the Start test command. |
|
Reporting |
Start test |
Adds specific test tags to represent the specific test context (what is being tested). For example, you can add “ValidateLogin” to represent a test that validates a user login. Other examples of tags that can be used here are test types such as regression, nightly, or smoke test. Use the End test command to end the logical test and report the test status . |
|
Script > Execute |
Execute script |
Deprecated. This command has been replaced with the Embedded tests functionality. |
|
Script > Flow |
Break |
Stops the flow of the current loop iteration and continues it in the first operation after the loop iteration. The Break function should be used within a condition. There is no value or logic in using it outside of a condition because the script lines following it will not be executed and are unnecessary. |
Native automation: Break |
Script > Flow |
Continue |
Stops the flow of the current loop iteration and continues it in the next loop iteration. The Continue function should be used within a condition. There is no value or logic in using it outside of a condition because the script lines following it will not be executed and are unnecessary. |
Native automation: Continue |
Script > Flow |
Exit |
Stops the flow of the current script. If the script is nested, the execution flow returns to the parent script. The Exit function should be used within a condition. There is no value or logic in using it outside of a condition because the script lines following it will not be executed and are unnecessary. |
Native automation: Exit |
Script > Timer |
Get timer |
Retrieves the value of the timer specified by the timerId parameter. There is no need to stop the timer to use the Get timer function. |
Perfecto extension: Get timer |
Script > Timer |
Timer report |
Adds a timer report to the test. The measured timer result is reported from the test (retrieved via the Get timer command) into the generated Single Test Report. The report is named according to the name parameter and based on the timing measurement specified by the result parameter. For more details on adding timer reports to your test, see Performance testing. |
Perfecto extension: Timer report |
Script > Timer |
Timer start |
Begins measuring time via a timer identified by the timerId parameter until the Timer stop command is used. The initPolicy parameter is useful when using the command within a loop, where the timer can be reset or continued with each iteration. |
Perfecto extension: Timer start |
Script > Timer |
Timer stop |
Stops the timer with the specified timer ID. There is no need to stop the timer to use the Get timer function. |
Perfecto extension: Timer stop |
Script |
Counter update |
Updates a counter variable. It is possible to increase or decrease the value of a counter and set it to a specific value. |
Native automation: Counter update |
Script |
Integer convert |
Converts an integer into a text string. |
Native automation: Integer convert |
Script |
Script info |
Retrieves the script information and can insert its value into a defined variable. Use the Property parameter to specify the script info to retrieve. |
Native automation: Script info |
Script |
String concatenate |
Joins two or more character strings. |
Native automation: Concatenate string |
Script |
String convert |
Converts a text string into an integer. |
Native automation: String convert |
Script |
String indexOf |
Returns the index within this text of the first/last occurrence of the specified subtext, starting the search at the specified index. |
Native automation: String indexOf |
Script |
String substring |
Retrieves a substring of the given string. If no value is given for end, the substring starting at the beginindex continues until the end of the string will be returned. |
Native automation: String substring |
Services > Cloud |
Cloud call |
Generates an external voice call recording to the selected destination. It is possible to select multiple destinations that may include devices, users, and phone numbers. There is no default. To use this command, at least one destination must be selected. |
Perfecto extension: Cloud call |
Services > Cloud |
Cloud email |
Sends an email message to the selected destination. To diversify, it is possible to select multiple destinations that may include different email addresses, devices, and users. There is no default. At least one destination must be selected. If not specified, the message subject and body defaulted to none and test email. To receive email message, confirm that the destination device is configured. |
Perfecto extension: Cloud email |
Services > Cloud |
Cloud SMS |
Sends an SMS message to the selected destination. It is possible to select multiple destinations that may include devices, users, and phones. There is no default. To use this command, at least one destination must be selected. |
Perfecto extension: Cloud SMS |
Services > Network Virtualization |
Network virtualization start |
Starts network virtualization for the device with the specified conditions. Network virtualization will be stopped when the script ends. For network condition testing, the device used is connected to the Web via Perfecto WiFi. Setup is completed by Perfecto. Use the Network virtualization start and update commands to activate and update the network conditions. Without this activation, there is no effect on the device communication to the web. Selecting latency effects both in and out traffic. For example, selecting latency of 100 results in the actual latency being 200 (100 each way). For typical network emulation values, see Network conditions for network virtualization. |
Perfecto extension: Network virtualization start |
Services > Network Virtualization |
Network virtualization stop |
Stops the network virtualization for the device and saves the PCAP file to the repository. The PCAP file logs the network traffic. The parameter indicates if the should be attached to the execution report. If will then be included as a link in the extracted PDF and HTML report. |
Perfecto extension: Network virtualization stop |
Services > Network Virtualization |
Network virtualization update |
Updates the network virtualization for the device with the specified conditions. For any condition that is not specified, the system will continue to use the existing value. For network conditions testing, the device used is connected to the Web via PerfectoWiFi. Setup is completed by Perfecto. Use the Network virtualizationstart and update commands to activate and update the network conditions. Without this activation, there is no effect on the device communication to the web. Selecting latency effects both in and out traffic. For example, selecting latency of 100 results in the actual latency being 200 (100 each way). For typical network emulation values, see Network conditions for network virtualization. |
Perfecto extension: Network virtualization update |
Services > Perfecto Connect |
Perfecto connect attach |
Connects the given device to the local network using the Perfecto Connect tunnel created by the perfectoconnectclient. The tunnelId parameter should provide the identifier of the tunnel to connect through. Used in conjunction with the Perfecto Connect detach command. |
|
Services > Perfecto Connect |
Perfecto connect detach |
Disconnects the given device from the local network. The tunnelId parameter should provide the identifier of the tunnel used to connect the device. Used in conjunction with the Perfecto Connect attach command. |
|
UI Objects > Application |
Application info |
Retrieves the specified application property and can insert the value into a defined variable. Use the Property parameter to specify the webpage property to retrieve. Use the Property parameter to specify the application property, application version or orientation, to retrieve. Only one property value or performance value can be specified in each command. The Response provides the value of the requested property value in the returnValue field. |
|
UI Objects > Application |
Application.Element.Click |
Uses an element identifier (XPath or specific attribute) to search for the specified element in the display of the active window and then clicks the element. Used in conjunction with either the Perfecto or Appium framework to interpret the element classes. |
|
UI Objects > Application |
Application.Element.Find |
Finds an element or elements in the active application. Can be used to validate whether an element exists in the application. The returnValue of the rsponse will indicate the UI Element hierarchy to the found element. |
|
UI Objects > Application |
Application.Element.Info |
Retrieves the specified property of the element and can insert its value into a defined variable. Use the Property parameter to specify the element property to retrieve. |
|
UI Objects > Application |
Application.Element.MultiTap |
Uses an element identifier (XPath or specific attribute) to search for the element in the display of the active window and then sends one or more taps with one or more touch points on the element. Used in conjunction with either the Perfecto or Appium framework to interpret the element classes. |
|
UI Objects > Application |
Application.Element.Set |
Uses an element identifier (XPath or attribute value) to search for the element in the display of the active window and then enters the supplied text to the element. Uses either the Perfecto or Appium object tree framework. |
|
UI Objects > Objects Optimization |
Objects optimization start |
Builds an Object search tree that is limited to the objects visible on the screen. This speeds up the object search functionality for large iOS View objects. Used in conjunction with the Object optimization stop command. |
|
UI Objects > Objects Optimization |
Objects optimization stop |
Builds an Object search tree that is limited to the objects visible on the screen. This speeds up the object search functionality for large iOS View objects. This command cancels the optimization. Used in conjunction with the Object optimization start command. |
|
UI Objects > Visual |
Button.Click(image) |
Identifies a button based on an image label and clicks it. The image file should be stored in the repository prior to running this command. By default, the find image function searches for the image on the current screen. However, if there is a possibility that the image is not on the current screen, enable the Scroll and search parameter. When this parameter enabled, the default scroll direction is down. For iOS devices, the default scroll direction is right. To change the scroll direction to down, select body in the Search area parameter. For more information on how to use the Next parameter, see Create custom swipe gestures This command should be used in combination with Visual Relations. |
|
UI Objects > Visual |
Button.Click(text) |
Identifies a button based on a text label and clicks it. By default, the find text function searches for the text on the current screen. However, if there is a possibility that the selected text is not on the current screen, enable the Scroll and search parameter. When enabled, the default scroll direction is down. For iOS devices, the default scroll direction is right. To change the scroll direction to down, select body in the Search area parameter. For more information on how to use the Next parameter, see Create custom swipe gestures This command should be used in combination with Visual Relations. |
|
UI Objects > Visual |
Edit.Get(image) |
Identifies an edit field based on an image label and retrieves its value. The value can be inserted into a defined variable. The field is in relation to the found label and is defined by the label position and offset parameters. For more information, see Visual Relations. By default, the find image function searches for the image on the current screen. However, if there is a possibility that the image is not on the current screen, enable the Scroll and search parameter. When enabled, the default scroll direction is down. For iOS devices, the default scroll direction is right. To change the scroll direction to down, select body in the Search area parameter. For more information on how to use the Next parameter, see Create custom swipe gestures |
Perfecto extension: Edit.Get image |
UI Objects > Visual |
Edit.Get(text) |
Identifies an edit field based on a text label and retrieves its value. The value can be inserted into a defined variable. By default, the find text function searches for the text on the current screen. However, if there is a possibility that the selected text is not on the current screen, enable the Scroll and search parameter. When enabled, the default scroll direction is down. For iOS devices, the default scroll direction is right. To change the scroll direction to down, select body in the Search area parameter. For more information on how to use the Next parameter, see Create custom swipe gestures This command should be used in combination with Visual Relations. |
Perfecto extension: Edit.Get text |
UI Objects > Visual |
Edit.Set(image) |
Identifies an edit field based on an image label and inserts the text specified in the value parameter into the field. The field is in relation to the found label and is defined by the label position and offset parameters. |
Perfecto extension: Edit.Setimage |
UI Objects > Visual |
Edit.Set(text) |
Identifies an edit field based on a text label and inserts the text specified in the value parameter into the field. The field is in relation to the found label and is defined by the label position and offset parameters. |
Perfecto extension: Edit.Set text |
UI Objects > Webpage |
Webpage info |
Retrieves the specified webpage property and can insert the value into a defined variable. Use the property parameter to specify the webpage property to retrieve. Only one property value or performance value can be specified in each command. The returnValue field of the response provides the value of the requested property value. |
|
UI Objects > Webpage |
Webpage.Element.Click |
Uses an element identifier (HTML attribute value or XPath) to search for the element in the display of the active window and then clicks the element. Assumes that the display is using DOM elements. |
|
UI Objects > Webpage |
Webpage.Element.Find |
Uses an element identifier (HTML attribute value or XPath) to search for the element in the display of the active window. Assumes that the display is using DOM elements. Can be used to validate whether an element exists on the webpage. The returnValue of the response provides the element tree traversal to the element if found. |
|
UI Objects > Webpage |
Webpage.Element.Info |
Retrieves the specified property of the element and can insert its value into a defined variable. Use the property parameter to specify the element property to retrieve. |
|
UI Objects > Webpage |
Webpage.Element.Info.CSS |
Retrieves the specified css property value of a web page control and can insert its value into a defined variable. Use the property parameter to specify the element property to retrieve. |
|
UI Objects > Webpage |
Webpage.Element.Set |
Uses an element identifier (HTML attribute value or XPath) to search for the element in the display of the active window and then enters the supplied text into the element. Use the text parameter to specify the text to set. Assumes that the display is using DOM elements. |
|
(No group) |
Comment |
Adds a comment in the script. Comments appear in the script and in the generated report. |
Native automation: Comment |
(No group) |
Drag |
Performs the drag gesture. You can define the touch sequence coordinates and time frame of the drag. The location parameter supplies the coordinates of the start and end points of the drag. There is a touchdown at the beginning of the drag and a touch-up at the end of the drag. A touchdown is performed with the first pair of coordinates. This is followed by a drag through all the coordinates until the last one, where a touch-up is performed. |
Perfecto extension: Drag |
(No group) |
Find image |
Finds an image (needle) on the device screen (haystack) and stores the coordinates for future commands. By default, the find image function searches for the image on the current screen. |
Perfecto extension: Find image |
(No group) |
Find text |
Locates the test specified by the content parameter and stores its coordinates on the device for future use by other operations. Note that these coordinates are not sent back as return value. |
Perfecto extension: Find text |
(No group) |
Gesture |
Performs a multi-touch operation called pinch and zoom. For this gesture, the start and end coordinates must be defined. It is also possible to define the duration of the gesture. The start and end coordinates specify the touch sequence path for a single finger. The other finger is symmetrical. |
Perfecto extension: Gesture |
(No group) |
Home |
Brings the device to its idle/home screen. For iOS and Android devices, the device is unlocked and returned to its default rotate orientation. For example, iOS devices are returned to portrait mode and iPad devices to landscape mode. Use this function at the beginning of a script to ensure a known starting point for the user. |
|
(No group) |
Press key |
Clicks on a single or sequence of special device keys (either control or keyboard). You can hover over the device keys to identify them, then enter the Keys parameter according to the required syntax. Common keys include: LEFT, RIGHT, UP, DOWN, OK, BACK, MENU, VOL_UP, VOL_DOWN, CAMERA, CLEAR Important: The listed keys are not necessarily supported by all devices. The available keys depend on the device.
Presskey will always press the keyboard keys according to the default layout configuration. |
Perfecto extension: Press key |
(No group) |
Screen text |
Returns the text that appears on the screen of the device (but does not select the text). The retrieved screen text can be stored in a defined String variable or to a location in the Perfecto Repository (see key parameter) and then used with the string compare and string attribute checkpoints. |
Perfecto extension: Screen text |
(No group) |
Screenshot |
Captures an image of the current screen display, in the selected format. The digital screenshot included in the report. Additional configurations include capturing an analog image, saving the image in the repository, and reducing the image resolution for long scripts that result in large reports. Use this function to see how the application looks at any given time during a script run. For additional time saving, enable the Grid label advanced parameter to generate a separate view mode with customizable screenshot labels. You can also use this command for dynamic image validation during runtime. This means that during runtime, a device screenshot image can be saved to the repository and then compared to the current screen on the device to validate what was expected. |
|
(No group) |
Select image |
Clicks on the image (needle) in the PNG file whose name is indicated by the content parameter. Store the image in the repository prior to running this command. By default, the select image function searches for the text on the current screen. If there is a possibility that the selected text is not on the current screen, enable the Scroll and search parameter. When enabled, the default scroll direction is down. For iOS devices, the default scroll direction is right. To change the scroll direction to down, select body in the Search area parameter. Prerequisite: The image to be searched must be uploaded to the Perfecto repository. In the command, the repository location will be selected in the Expected Needle parameter. For information on uploading files to the repository, see Manage the repository. |
Perfecto extension: Select image |
(No group) |
Select text |
Clicks on the text specified by the label parameter. By default, the select text function searches for the text on the current screen. However, if there is a possibility that the selected text is not on the current screen, enable the Scroll and search parameter. When enabled, the default scroll direction is down. For iOS devices, the default scroll direction is right. To change the scroll direction to down, select body in the Search area parameter. |
Perfecto extension: Select text |
(No group) |
Swipe |
Performs the swipe gesture, which is a three-part gesture:
The relationship between the start and end coordinates defines the direction vector of the swipe. It is possible to also define the time frame of the swipe. The start and end coordinate values can be in pixels or in percentage. Always use the same type for both coordinates. The (0,0) point is in the upper left corner of the screen. The x-coordinate value increases to the right and the y-coordinate value increases to the bottom. |
Perfecto extension: Swipe |
(No group) |
Touch |
Performs a touch operation on the specified coordinate location. A long press can be performed by using the durationparameter. A touchdown press is released with a touch- up release. |
Perfecto extension: Touch |
(No group) |
Type |
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. |
|
(No group) |
Wait |
Waits the specified duration before performing the next script step. As a best practice, use the Timeout parameter and not the Wait command. |
Native automation: Wait |
Group |
Checkpoint |
Description |
More info |
---|---|---|---|
Reporting |
Assert |
Evaluates a variable of type number against a defined number. This evaluation includes multiple possible operators, such as Greater, Equal, or Not equal. |
|
Script |
Counter checkpoint |
Ensures the device is playing sounds. The audio checkpoint validates that an audio clip is playing on the device. It is also possible to set the minimal duration of the audio clip to be validated. |
Native automation: Counter checkpoint |
Script |
Number compare checkpoint |
Evaluates a variable of type number against a defined number. This evaluation includes multiple possible operators, such as Greater, Equal, or Not equal. |
Native automation: Number compare checkpoint |
Script |
String attribute checkpoint |
Verifies whether a variable of type string is empty or not. |
Native automation: String attribute checkpoint |
Script |
String compare checkpoint |
Evaluates a variable of type string against a defined string. This evaluation includes multiple possible operators such as Greater, Equal and Not equal. The defined string may be a regular expression. |
Native automation: String compare checkpoint |
Script |
Time checkpoint |
Verifies that a stopped timer does not exceed a defined duration limit. The timer records all types of time measurements (elapsed, user, RTT, system and Handset) , and the validation is performed against one specific type. The timer must be stopped before performing this validation. |
Native automation: Time checkpoint |
(No group) |
Audio checkpoint |
Ensures the device is playing sounds. The audio checkpoint validates that an audio clip is playing on the device. It is also possible to set the minimal duration of the audio clip to be validated. |
|
(No group) |
Text checkpoint |
Verifies the text specified by the content parameter appears on the device screen. By default the text is searched on the current screen. If there is a possibility that the text is on a following screen, you can enable the Scroll and search parameter. When enabled, the default scroll direction is down. For iOS devices, the default scroll direction is right. To change the scroll direction to down, select body in the Search area parameter. |
Perfecto extension: Text checkpoint |
(No group) |
Image checkpoint |
Verifies that the given image appears on the device screen. In case of failure, the script will be marked as failed. By default, the find image function searches for the image on the current screen. If there is a possibility that the selected image is not in the current screen, you can enable the Scroll and search parameter. When enabled, the default scroll direction is down. For iOS devices, the default scroll direction is right. To change the scroll direction to down, select body as the Search area. Prerequisite: The image to be searched must be uploaded to the Perfecto repository. In the command, the repository location will be selected in the Expected Needle parameter. For information on uploading files to the repository, see Manage the repository. |
Perfecto extension: Image checkpoint |