SeeTestAutomation- SetProperty
info
Please note that this tool is classified as a Legacy tool. We recommend transitioning to our updated solutions to maintain optimal performance and security in your workflows. For more information on this matter, please reach out to technical support .
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:
| Property | Value | Function | Notes |
|---|---|---|---|
| hybridClick | true/false (default: false) | Enables JavaScript-based click method. | |
| report.image.width | Size in pixels (default: 500) | Sets the size of generated images in reports. | |
| screen.latency | Milliseconds | Delays post-action screenshot to account for physical device latency. | |
| screen.quality | 1–100 (percent) | Sets the image quality for screenshots from the device. | |
| screen.refresh | > 0 milliseconds | Sets refresh rate for capturing updated device images. | |
| ignore.ocr.recommendation | true/false | Enables/disables OCR recognition. | |
| Android.instrumentation.security | none, smart, hard (default: smart) | Controls disabling of Android FLAG_SECURE. | Android only |
| on.device.xpath | true/false | Executes XPath queries on device for faster response. | Certain tags not supported on device. |
| assert.element.idle | true/false (default: false) | Controls command behavior for elements in busy state. | Android only. Can also be app-property. |
| element.visibility.level | full/center/none/legacy_mode (default: legacy_mode) | Controls visibility constraints during element validation. | Replaces elementSwipe.partialAppearance |
| chrome.load.timeout | integer >= 0 (ms); default: 10000 (local), 15000 (cloud) | Timeout for Chrome operations. | Android only |
| adbPortForward | port number / -1 | Specifies ADB port for device connection. | Android only |
| Android.native.nonInstrumented | true/false | Enables switching between instrumented/non-instrumented Android modes. | Android only |
| ios.native.nonInstrumented | true/false | Enables non-instrumented dumps for native apps. | iOS only |
| iosDevice.nonInstrumented | enable/disable (default: enable) | Toggles instrumented/non-instrumented modes for iOS devices. | iOS only |
| ios.elementsendtext.action.fire | true/false (default: false) | Triggers keyboard events on ElementSendText command. | iOS only |
| ios.atomic.sendText | true/false | Sends text atomically (key-by-key). | iOS only |
| ios.non-instrumented.dump.escape.attributes | true/false (default: false) | Escapes certain properties from non-instrumented dump. | iOS only; also an app-property |
| ios.non-instrumented.dump.parameters | [refer to error logs] | Limits number of elements in non-instrumented dump. | iOS only |
| xcelement.type.include | true/false (default: false) | Reverts to older class behavior in dump (pre-v10.3). | iOS only |
| js.max.string.size | integer > 0 (default: 255) | Sets max text length for object properties. | |
| clicks.time.gap | integer > 0 (default: 0) | Milliseconds between rapid multiple clicks. | Android and iOS |
| Android.instrumentation.camera | true/false or enable/disable (default: false) | Supports instrumentation for apps using the camera. | Android only; also an app-property |
| ios.auto.accept.alerts | true/false | Automatically accepts system alerts. | iOS only |
| ios.auto.dismiss.alerts | true/false | Automatically dismisses system alerts. | iOS 9+ only |
| android.install.grant.permissions | true/false (default: false) | Grants app permissions during installation. | Android only |
| attach.crash.log.to.report | true/false | Attaches device crash logs to the report folder. | iOS only |
| ios.dump.focus.process | process_name/bundle_id/process_id | Gets dump from a specific process. | iOS only |
| ios.dump.non.instrumented.dump.include.attributes | attribute name (e.g. visible) | Includes specific attributes in dump. | iOS only |
| battery.report.percentage | true/false | Changes battery monitoring unit from mAh to percentage. | Android only |
| ios.keyboard.close.by.dump | true/false | Simulates user action to close keyboard. | iOS only |
| location.service.gps / location.service.network | true/false | Toggles GPS/location service modes. | Android only |
| ios.element-send-text.use.xcautomation | true/false (default: true) | Uses XCAutomation for text entry. | iOS only |
| ios.dump.fetch.top | true/false (default: false) | Gets "top" property from OS (expensive operation). | iOS only |
| disable.reporter | true | Saves test results locally during grid tests. | |
| ios.instrumentation.log.level | none, fatal, error, warn, info, debug, all | Sets iOS instrumentation log level. | iOS only |
| safari.webview.include | true/false (default: false) | Includes Safari WebView UI elements in dump. | iOS only |
| ios.element.top.bounds.contained.in.parent | true/false (default: false) | Controls visibility check for parent-bound elements. | iOS only |
| ios.waiting.element.polling.interval | Integer >= 0 (default: 0) | Polling interval for element stability check. | iOS only |
| ios.11.use.old.monitoring.service | true/false (default: false) | Uses old CPU/memory monitoring for iOS 11. | iOS only |
| ios.request.location.permission | true/false (default: false) | Requests location permission (required for getLocation). | iOS 11+ only |
| controller.idle.timeout | Integer >= 10000 (default: 10000) | Time for controller to stay alive after test ends. |