Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

SetProperty (Property, Value)

Description

This command can change the configuration on the device during runtime. It will set the given property to the given value.

Parameters

  • Property :  Property (See the supported properties below)
  • Value : The value to be set

Supported Properties:

PropertyValueFunctionSupported in
hybridClick Enable/disable or true/false (default mode = disable/false)When hybridClick is enabled, click method will be executed using javascript.

Supported_os
SupportIOStrue
SupportAndroidtrue
SupportWPtrue

report.image.width Size in pixels (default value: 500)Defines the size, in pixels, of the generated images in the report.

Supported_os
SupportIOStrue
SupportAndroidtrue
SupportWPtrue

screen.latencyUnit in millisecondsSome commands, for instance, SeeTestAutomation - Click, result in two screenshots in a report: a pre-action shot, which is taken right before the command execution starts, and a post-action shot. The value of screen.latency is used in the calculation of the time when the latter screenshot is taken. Namely, SeeTestAutomation holds on during screen.latency since the action of the current step is forwarded to a physical device and then grabs its post-action screenshot. Thus if you notice that the post-action screenshot is taken too early, you can tune the latency of its taking by updating the value of screen.latency. As a trade-off, however, this will slow down the execution of the test

Supported_os
SupportIOStrue
SupportAndroidtrue
SupportWPtrue

screen.quality 1-100 (percentages)To change the quality of the image received from the device.

Supported_os
SupportIOStrue
SupportAndroidtrue
SupportWPtrue

screen.refresh Greater than 0 in millisecondsTo control the refresh rate time gap to get a new image from the device.

Supported_os
SupportIOStrue
SupportAndroidtrue
SupportWPtrue

ignore.ocr.recommendation true/falseTo enable/disable OCR recognition.

Supported_os
SupportIOStrue
SupportAndroidtrue
SupportWPtrue

Android .instrumentation.security none, smart, hard (default value: smart)

To disable the Android LayoutParams FLAG_SECURE.

  • none - will not disable the security flag.
  • smart - will disable the security flag on the when activity resumeresumes.
  • hard - will disable the security flag on the activity resume and in a repeated sequence (every few sec).

Supported_os
SupportAndroidtrue

on.device.xpath true/falseIf it is set to true, it causes any web command that is using XPath to be calculated on the device itself. This enables a faster response. As part of the properties shown in the object spy are derivative it will not work on the device. So, if the XPath contains one of the followings tags, it will not be executed on the device (even if the property is set to true):
@onScreen, @top, @css, @width, @height, @x, @y, @hidden, @text or @nodeName

Supported_os
SupportIOStrue
SupportAndroidtrue

assert.element.idletrue/ false. (default value: false)

This property is used to control SeeTest verification behavior regarding busy elements. When the property is set to true, SeeTest will fail a command if the element in question is found on screen but in a busy state. Otherwise, the verification will ignore its busy state.

Usage examples:
1. To identify a toast which generally is a busy element, use: assert.element.idle=false.

2. To click on an element, use: assert.element.idle=true (because clicks do not work on busy elements).


Info
titleNote

This property is available also as an 'app-property', which can be declared and set on/off in the app.properties file. 


Supported_os
SupportAndroidtrue

element.visibility.level



full/center/none/legacy_mode default value:  legacy_mode.

This property is an app property used to define the desired visibility level of elements on the device's screen for the testing flow.

Following are the visibility levels supported:
full: fully contained; This mode defines the element visibility based on whether the element rectangle is fully contained within the screen rectangle.
center: center contained; This mode defines the element visibility based on whether the center of the element (click point) is visible on the screen
none: no visibility constraints: This mode does not verify element visibility on screen once the element is found in Dump
legacy_mode: Maintains old legacy - the current default mode

For example:

Running isElementFound() on an element that is completely hidden by the devices navigation bar will retrieve the following based on each mode:

Full: false

center: false

none: true

Note: elementSwipe.partialAppearance property is deprecated and it is recommended to use element.visibility.level property instead.

Supported_os
SupportIOStrue
SupportAndroidtrue
SupportWPtrue

chrome.load.timeout integer>=0 (time in milliseconds). Default value: 10,000 ms for local devices and 15000 ms for cloud devices.This property is a device property used to control the operations timeout on chrome. 
For example:  
1. when executing ' launch(chrome:...) ' command, the requested website tries to load on the current tab, this process requires first loading the last website opened on this tab and if the loading process got timed-out. Chrome will load the new URL in a new tab.  

2. Under bad network conditions, chrome might exhibit a performance deterioration. This property allows you to adjust chrome operations timeout under different network conditions.

Supported_os
SupportAndroidtrue

adbPortForward selected port number/ -1To enable specifying which adb port number you wish to search a connected Android device from. If set to -1, it will forward to all adb ports.

Supported_os
SupportAndroidtrue

Android .native .nonInstrumented nonInstrumentedtrue/falseEnable the user to switch between working under instrumented/non-instrumented mode during test execution.

Supported_os
SupportAndroidtrue

WPDevice .nonInstrumented.objects enable/disable, true/false (default value is enable/true) or short/thinIf set false/disable, it will not take the non-instrumented dump.
If set short/thin, it will take non-instrumented dump only for the application bar.

Supported_os
SupportWPtrue

ios.native .nonInstrumented true/falseFor Native dump only. If set to true, it will take the non-instrumented dump. 

Supported_os
SupportIOStrue

iosDevice .nonInstrumented enable/disable (default value: enable)To switch between instrumented/non-instrumented modes while working with an iOS device.

Supported_os
SupportIOStrue

ios.elementsendtext.action.fire true/ false (default value: false)When the user uses the  SeeTestAutomation - ElementSendText  command and the  ios.elementsendtext.action.fire property is enabled, it will trigger the event that should have been triggered by the keyboard.

Supported_os
SupportIOStrue

ios.atomic .sendText  true/falseWhen set to true,  SeeTestAutomation- SendText  command will ensure sending the text key by key,  atomically .

Supported_os
SupportIOStrue

ios.non-instrumented.dump.escape.attributes true/false (default value: false)

When set to true, it will escape properties (hidden, knownSuperClass) from the non-instrumented dump. Uses for big pages with a lot of elements. 

Info
titleNote

This property is available also as an 'app-property', which can be declared and set on/off in the app.properties file. 


Supported_os
SupportIOStrue

ios.non-instrumented.dump.parameters see SeeTestAutomation- Failure to get dump  Define a specific dump parameter to limits the elements numbers

Supported_os
SupportIOStrue

xcelement.type.include true/false (default value: false)Starting from SeeTest Automation 10.3 the 'Class' property has changed in non-instrumented dump. To go back to the older dump during runtime use this property with the value false.

Supported_os
SupportIOStrue

js.max.string.sizeinteger values  > 0 (default value: 255)Set the maximum text attribute  length  in the object properties.

Supported_os
SupportIOStrue
SupportAndroidtrue
SupportWPtrue

clicks.time.gapInteger values  > 0 (default value: 0)

iOS: Milliseconds between clicks in case a simulation of a triple click (or above) is desired. Set this property and make sure the number of clicks is 3 or above. This will simulate a fast repetitive click in the same spot (recommended values are 50 ms and up).
Default: 0. 

Android:This property can also be used for clickCoordinate() command in Android  

Supported_os
SupportIOStrue
SupportAndroidtrue

Android .instrumentation.camera true/ false or enable/disable. (default value: false)

This property enables you to support camera instrumentation on-the-fly. When set to true, the next time you use the install command with instrument=true, your application will be instrumented with the camera support.
This ability is intended especially for test automation on applications with the camera. For further information, please see SeeTestAutomation- SimulateCapture.

Note:

This property is available also as an 'app-property', which can be declared and set on/off in the app.properties file. 

Supported_os
SupportAndroidtrue

ios.auto.accept.alertstrue/false

If set to true, system alerts will be accepted automatically when they appear on screen. The click will happen during the next command that will use XPath queries.

OkOKAllowAccept


Supported_os
SupportIOStrue

ios.auto.dismiss.alerts

Info

Only works with iOS 9 and above.


true/false

If set to true, system alerts will be dismissed automatically when they appear on screen.  The click will happen during the next command that will use XPath queries.

The Dismiss options are:

DismissDon't allowCloseCancelNot now"...Later"


Supported_os
SupportIOStrue

android.install.grant.permissions

related Android 6+

true/falseGrants the permissions your app requires on install. Defaults to false

Supported_os
SupportAndroidtrue

attach.crash.log.to.report

true/falseSaves crash logs that were created on the device during the test to the report folder

Supported_os
SupportIOStrue

ios.dump.focus.process

process_name:<name> or

bundle_id: <bundleId> or

process_id:<pid>

Getting dump from specific process, identified by : process_name / bundle_id or process_id.

For example, getting dump from assistiveTouch:

ios.dump.focus.process=process_name:AssistiveTouchd

Supported_os
SupportIOStrue

ios.dump.non.instrumented.dump.include.attributes


attribute name

(currently only 'visible' attribute is supported).

Used only on iOS for getting dump non instrumented included the attributes.

For example: ios.dump.non.instrumented.dump.include.attributes=visible

Supported_os
SupportIOStrue

battery.report.percentagetrue/false

change the presented data units for battery monitoring from the default unit which is mAh to percentage

Supported_os
SupportAndroidtrue

ios.keyboard.close.by.dumptrue/falseClose keyboard with simulated user action based on keyboard in use

Supported_os
SupportIOStrue

location.service.gps

location.service.network

true/false

Toggle gps off by setting both properties to false.

Toggle gps on by using one of these properties to true:

  • for gps with 'device only' mode: use 'location.service.gps=true'
    'location.service.network=false'
  • for gps with 'battery saving' mode: use 'location.service.gps=false'
    'location.service.network=true'
  • for gps with 'High accuracy' mode: use 'location.service.gps=true'
    'location.service.network=true'

Supported_os
SupportAndroidtrue

ios.element-send-text.use.xcautomationtrue/falseUse XCAutomation for elementSendText, by default is true, if set to false, then elementSendText operation rather then being atomically executing on the device will be executing in multiple steps.

Supported_os
SupportIOStrue

ios.dump.fetch.toptrue / false(default)Instead of calculating "top" property with the legacy heuristics, this property makes the "top" property being queried from the OS. Use this only if you have problems with the existing property, as it is a costly operation.

Supported_os
SupportIOStrue

disable.reportertrueWhen running a grid test on cloud with a configured reporter, set this to true to save the test results locally.

Supported_os
SupportIOStrue
SupportAndroidtrue

ios.instrumentation.log.levelnone,fatal,error,warn,info,debug,allSets the desired log level to the iOS instrumentation.

Supported_os
SupportIOStrue

safari.webview.includetrue / false(default)Fetch the UI elements of safari webView.

Supported_os
SupportIOStrue

ios.element.top.bounds.contained.in.parent

true / false(default)

Sets top=false for elements that their rectangle bounds are not inside their parents bounds.

Supported_os
SupportIOStrue

ios.waiting.element.polling.interval

Integer values  >= 0 (default value:0)

Used for stabilising click operations.

Sets the interval between polling the element location in milliseconds, waiting for the element to be in the same location.

Supported_os
SupportIOStrue

ios.11.use.old.monitoring.service

true / false(default)Used only for iOS 11 to choose the service which uses for monitoring CPU / Memory (the old service monitors only debug applications).

Supported_os
SupportIOStrue

ios.request.location.permission

true / false (default)

Request location permission. Required for getLocation to work on iOS.

Supported on iOS 11 and above.

Supported_os
SupportIOStrue

controller.idle.timeout

Integer values >= 10000 (default: 10000)Set idle controller timeout, how long will the controller remain alive after stopping the test execution.

Supported_os
SupportIOStrue
SupportAndroidtrue