What is new in Sahi Pro v9.2.0

abstract Sahi Pro v9.2.0 is a minor release with bug fixes and modifications.

Instructions to Install/ Upgrade using Installer

warning

If you're installing Sahi Pro for the first time or want to install Sahi Pro v9.2.0 from installer in a new location, then please refer Sahi Pro - Getting Started page.
If you wish to upgrade from an older version of Sahi using installer, refer to Upgrade Sahi Pro for details.

Instructions for updating through Web UI

warning

If you are using Sahi Pro v9.0.1 or above version, you can easily update to Sahi Pro v9.2.0 through Update Sahi Pro web UI.
For updating from Sahi Pro v9.0.0, please follow the instructions below.

On Linux OS, after upgrading through Update Sahi Pro web UI please grant permission for the 'SahiBaseDir/userdata/bin/verify_ssl_root_cert_linux.sh' file.
Eg: chmod 755 verify_ssl_root_cert_linux.sh
On Windows OS, when using any DB apart from H2, the Update feature stops working.
You need to update at least once from Sahi Pro 9.0.0 version in this manner to ensure all future updates work fine.

Resolution:
You will need to temporarily switch your database to H2 > Perform the Update and then Switch back to your current database settings.
For more information about using different databases for reports please see the document for Use a Different Database in Using Sahi.

Steps:
1. Take a backup of your existing database. (It may be "mysql", "mssql", "postgresql", "oracle" etc.) When upgrading Sahi Pro and reverting your database back to your current one, your db will also get updated. So, in order to avoid losing any data, taking a backup is a must before proceeding to the below steps.
2. Switch your database settings to H2 database.
3. Perform update through Update Sahi Pro web UI.
4. Now Switch back to your original DB settings.

New APIs

APIs _dataList, _datalistFilter, _setValueFromList are added to support datalist Html element.
_scriptInfo: Returns script information as an associative array.
_addToScriptInfo: Appends custom fields in Script Info.
_setClientCertificate: Sets the certificate to be used for client certificate authentication.

Modifications

_setValue: API will not set value in hidden elements.
_click: API now supports touch events for mobile browsers.
_dragDrop: API now automatically scrolls the page while finding the drag element and drop element.
_assertSnapShot: API now supports Headless Chrome.
_getOptions: API now supports datalist Html element.
_getSessionId: Argument $windowIdentifier now supports window name and window URL as well.
_copyFile: API now supports copying files having a size of more than 2 GB.

Bug Fixes and Improvements

Additions to Report
- Introduced Intermediate Statuses in Script Report.
- Error status will be visible for Scripts and TestCases.
- Statuses ABORTED and ABORTED_TIMEOUT will be visible for test cases on the Suites List page.
- Healed Report will be available on the Suite Analysis page.
- The browser version is added to Script Report.
- The graph will also be shown for scripts in running status.
Url containing IPv6 address is now supported.
Content Security Policy is now supported.
Add-ons can be uninstalled from Sahi's Configuration page.
Now Rollback feature is also available for add-ons and patches.
Data drive headers will now be automatically suggested in the Controller while recording a scenario.
Argument names will now appear in PascalCase for functions created in Editor.
Fixes in Playback
- Chromium project based browsers namely Google Chrome, Microsoft Edge, etc. employ WebContent Occlusion feature. With this feature, the browser hides the content of a window that is not in use. Consequently, playback with Sahi fails on such windows having no content. This feature is now disabled for Google Chrome and Microsoft Edge browser windows launched by Sahi. To disable this feature for other Chromium based browsers, refer here.
- Fixed: Steps to be performed on a cross domain non-top iframe are skipped during playback.
- Fixed: Steps are not executing on popup if window name contains multiple lines.
- If a URL contains invalid characters, it is encoded by Sahi. Such an encoded URL was being rejected by few website servers. This is now fixed.
- Syntax error occurs in some cases where array index is computed at run time. For example - _getText($totalRows[$i+1]). This is now fixed.
- Fixed: Error message occurs while asserting arrays with _assertEqual and _assertEqualArrays.
- Fixed: _assertEqualImages returns [Object object] when executed as a snippet from controller.
- Fixed: API _setXHRReadyStatesToWaitFor not working correctly.
Fixes in Report
- Fixed: Offline XML report is not generated for retry run.
- Commented functions of a scenario file appear in red color instead of grey color in the report. This happens when a step fails with 90 second error. This is now fixed.
- Fixed: In an excel report for a distributed run, the status color is not set for methods of a test case.
- Fixed: JS code coverage directory is not synced while synching 2 suite reports if the first suite report does not have JS code coverage.
- Fixed: Screenshot is missing from logs if the script file path contains spaces.
- Fixed: Aborted timeout count is not updated correctly while running a long suite with sub suites.
- Fixed: In few cases, the script was failing with 90 second error and the script status was being set as ERROR instead of ABORTED.
Fixed: Popup index increases after page reload in IE.
Fixed: Unable to apply a patch URL containing spaces in IE browser.
Fixed: Bug in Configuration page for managing external jars.
Fixed: Files android_devices.xml and ios_devices.xml necessary for configuring AWS device farm are not present in Sahi's userdata directory.
Fixed: Exception occurs while creating a data drive for a newly created scenario that is not saved yet.
Fixed: In a long scenario file, focus changes on switching tabs in Editor.
Fixed: Unable to refresh navigator in Editor if multiple Scripts directories are specified.
Fixed: Internal value 'sahi-xhr-sid' is unnecessarily being sent to web server in 'Access-Control-Request-Headers' request header.
Internal request header 'sahi-xhr-sid' will not be added for a cross domain XHR if the domain matches an entry in passthrough_ws_ssh_domains.txt.
Updated Firefox profiles to allow internal 'sahisid' cookie to be accessible across domains.
Avoided connecting to <Machine IP Address>:<Sahi Port> from Sahi proxy server as they both are same.
Attachment of type 'application/x-protobuf' will not be downloaded to SahiBaseDir/userdata/temp/download directory.

What is new in Sahi Pro Desktop Add-on v9.2.0

Bug Fixes

Fixed: Incorrect window index for apps like Remote Desktop Login and TeamViewer.

What is new in Sahi Pro Mobile Add-on v9.2.0

New APIs

_call: This is a generic API to directly call javascript on the DOM.

Modifications

_setValue: Added triggerKeyEvents property. This property triggers keyboard events while setting the value.
Deprecated: Property aws.devicefarm.enabled for iOS Automation with AWS Device Farm.

Bug Fixes

Fixed: Element index is different in recording and playback for some elements in Android.
Fixed: Stacktrace is not shown in the report in case of a step error in Android.
Fixed: FileAccessException occurred when connecting to an android device.
Fixed: API _setValue not working correctly when passing integer/float value in iOS.
Fixed: API _takeScreenShot not working correctly in Android Webview mode.
Fixed: API _takePageScreenShot not working correctly in Android Webview mode.

What is new in Sahi Pro SAP Add-on v9.2.0

New APIs

_closeSAPGUI: Closes SAP GUI logon pad.

Bug Fixes

Fixed: Unable to click on Tab element.
Fixed: Unable to double click on tree node item.
Fixed: Combo box action not recorded.