Sahi Documentation

What is new in Sahi Pro v9.1.0

abstract Sahi Pro v9.1.0 is a minor cumulative release that includes v9.0.1, v9.0.2 and bug fixes with 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.1.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 currently using Sahi Pro v9.0.1 or Sahi Pro v9.0.2, you can easily update through Update Sahi Pro web UI.
  • For updating from Sahi Pro v9.0.0, please follow the instructions below.
    1. 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
    2. On Windows OS, When using any DB apart from H2, 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.

Key Features

  1. Sahi Pro v9.1.0
    • No changes.
  2. Sahi Pro v9.0.2
    • Added support for passing index with window identifier in Popup Windows APIs to identify the browser window if the base window and popup window have same identifier.
    • Support for new versions of Chrome (>83) and Firefox (>78) which have third party cookie restrictions and modified behaviour of popup windows.
  3. Sahi Pro v9.0.1

Bug Fixes and Improvements

  1. Sahi Pro v9.1.0
    • Fixed: _takePageScreenShot not capturing proper screenshot when the system scale and layout value is other than 100% in Display Settings.
    • Fixed: If the browser window selected using _selectWindow or _popup does not exist, then it fails with '90 second' error instead of failing with 'Window/Domain not found' error.
    • Fixed: _assertSnapShot API is not giving expected results when the value for 'mode' property is 2.
    • Fixed: _setValue resulting in an error when the domain is added to Compatibility View settings of IE.
    • Fixed: Specified client certificate is not employed when Apache Client is enabled.
    • Fixed: Unable to save a file after downloading if the file name contains tab character.
    • Fixed: If the system display language is not English, SSL root certificate verification fails. Consequently, Sahi prompts to install the root certificate even when the root certificate is already installed.
    • Fixed: Rest request with Post method but no content gives incorrect response code when Apache Client is enabled.
    • Fixed: If the Argument in Scenario is a computation that uses the output of a function, then this function is not invoked.
    • Fixed: Steps and function calls are not shown for some specific cases on the script report page.
    • Fixed: Page containing Recaptcha does not load.
    • In the case of multiple cross-domain nested iframes, the window popup index shown was incorrect. It is now fixed.
    • Improvements in _dragDrop API to support drag and drop better.
    • Introduced functionality to toggle window popup index feature for cases where an index is used with window identifier in Popup Windows APIs.
      info To disable this, set sahi.window_popup_index.enable=false in <SahiPro>/userdata/config/userdata.properties. Note that disabling this setting may cause scripts to fail randomly when the base window and popup window have the same identifier.
  2. Sahi Pro v9.0.2
    • Fixed third-party cookies being blocked when Secure and SameSite="None" attributes are not set in latest Chrome and Firefox.
      • warning If you are using Chrome version 83 and above and getting 'step did not complete in 90 sec' issue, please delete the Chrome profiles folder at SahiBaseDir/userdata/browser/chrome/profiles and restart Sahi
      warning If you are using Mac OS and Firefox, please delete the Firefox profiles folder at SahiBaseDir/userdata/browser/ff/profiles and restart Sahi
    • Java 12 performance issues on controller and editor are fixed.
    • Fixed incorrect data is coming if blank cells are present and getData function is used to get data from excel(.xlsx) file.
    • Fixed 'Could not acquire browser instance' issue when multiple suites are trigger.
  3. Sahi Pro v9.0.1
    • Fixed Bugs for incorrect logs where native APIs failed.
    • Fixed bugs for JUnit logs.
    • Fix for external data drive file is not found while executing scenarios on Linux OS.
    • Fix for BDTA data file does not sync from Mac to Linux system in Drun.
    • Fix for newly written '[Keyword]' in keyword column does not allow to edit any cell in scenario in editor.
    • Fix for blank parameter is passed as function argument in scenario then it fails scenario playback execution.
    • Performance improvements for HAR in script reports.
    • Modified _dataDrive API to stop the execution for next set of data if the step fails because of browser/ window not responding.
    • Fixed Function details popup horizontal scroll issue in Chrome caused by Chrome update.
    • Sync add-ons with installed version of Sahi Pro.
    • Preserve shell script executable property in update feature.
    • Providing information about changes that will occur in the application when user wants to rollback to last install version.
    • Storing separate backup for patches.
    • Fix for update feature on Windows OS, When using any DB apart from H2.
    • Fix for third-party cookies being blocked in Chrome 83 version.
      • warning If you are using Chrome version 83 and getting 'step did not complete in 90 sec' issue randomly, please delete the Chrome profiles folder at SahiBaseDir/userdata/browser/chrome/profiles

Modifications

  1. Sahi Pro v9.1.0
    • _getWindows: Argument $includeIframes is added.
    • _takePageScreenShot: In capturing screenshot of elements, this API now supports horizontal scroll also. The default value for property trim is changed to false.
    • _assertSnapShot : The default value for property trim is changed to false.
  2. Sahi Pro v9.0.2
    • Sahi start pages and controller are moved to secure protocol (HTTPS) in order to effectively manage sessions with the latest browser restrictions.
    • Changed implementation for identifying popup windows because of an issue with Firefox v79 and above.
    • Popup window related modification:
        warningPlease update your scripts accordingly.
      1. Modal dialogs in IE will be identified as a popup window.
        warningAdd _selectWindow(<<Modal Title>>) in the script before interacting with the modal window.
      2. Cross-domain iframe in the popup window will be identified by domain & popup both. Before Sahi v9.0.2 it was identified by domain only.
        warningAdd _selectWindow(<<Popup Title>>) with _selectDomain(<<Domain>>) in the script before interacting with the cross-domain iframe in the popup window.
    warning If you are using Mobile browsers and if scripts are Aborting, please configure SSL using the steps in the link.
  3. Sahi Pro v9.0.1
    • No changes.

What is new in Sahi Pro Desktop Add-on

  1. Sahi Pro Desktop Add-on v9.1.0
    • No changes.
  2. Sahi Pro Desktop Add-on v9.0.2
    • No changes.
  3. Sahi Pro Desktop Add-on v9.0.1
    • Bug Fixes
      • Java/Applets Application: Handled exception in java mode when column value is null.

What is new in Sahi Pro Mobile Add-on

  1. Sahi Pro Mobile Add-on v9.1.0
    • No changes.
  2. Sahi Pro Mobile Add-on v9.0.2
    • No changes.
  3. Sahi Pro Mobile Add-on v9.0.1
    • Modifications
      • warning Note: From Sahi Pro v9.0.1, _connectDevice and _selectDevice executes implicitly if the start mode is Android or iOS. No need to write these APIs in the script.
      To execute these APIs explicitly from the script, pass connectDeviceInternal=false as an extra parameter in Playback settings. Refer here for more details.

What is new in Sahi Pro SAP Add-on

  1. Sahi Pro SAP Add-on v9.1.0
    • No changes.
  2. Sahi Pro SAP Add-on v9.0.2
    • No changes.
  3. Sahi Pro SAP Add-on v9.0.1
    • No changes.