Sahi Documentation

Evaluation Questions

Browser and OS support

question Which operating systems and browsers does Sahi support?
answer The Sahi proxy server is written in Java. It can work well on Windows, Linux and Mac.

Sahi supports the following browsers: IE 6 to IE 11 Firefox 3.5+ (to latest) Chrome (versions since last 5 years) Safari and Opera (versions since last 4 years, but Opera support may not be very robust)

You may record on one browser and playback the script on another.

AJAX support

question Does Sahi support ajax based applications?
answer Yes, Sahi supports ajax applications very well.

Sahi automatically waits for Ajax requests to finish loading, so there is no need to add explicit waits in the code. This reduces the size of the codebase significantly.

SSL support

question Does sahi support sites using SSL communications?
answer Sahi Pro automatically handles SSL. Depending on your system, you may need to click once on the "SSL" link on the Sahi Pro Dashboard and accept that certificate. This is a one time operation.

Configuring Sahi

question Does Sahi Pro have screens to configure Sahi?
answer Most of Sahi Pro's configuration can be done via the Configure link on the Sahi Dashboard.

Can Sahi work without proxy configuration?

question We are not allowed to change the proxy settings of IE. In that case, will Sahi work with IE?
answer Sahi works on the basis of a proxy server. Using a proxy allows Sahi to inject code in webpages that allow it to access the DOM of the page, record and playback scripts.

Unfortunately, without changing the proxy settings, Sahi cannot work.

Can Sahi work with IE mode on Microsoft Edge?

question How to automate application which opens in IE mode on Microsoft Edge with Sahi Pro?
answer Follow the below steps to automate application which opens in IE mode on Microsoft Edge:
  1. Ensure your application opens in IE mode on Microsoft Edge with Sahi. Refer to the Microsoft Documentation for details.
  2. Configure Microsoft Edge Browser to open the below URLs in IE mode.
    1. Sahi Home page URL - https://sahi.example.com/_s_/dyn/Driver_initialized?browserType=edgenew
    2. Sahi Controller page URL - https://sahi.example.com/_s_/spr/controller8.htm
    3. Sahi Playback page URL - https://sahi.example.com/_s_/dyn/Player_auto
  3. By default, sahi.common_domain property is set as sahi.example.com in userdata.properties. If any other domain is set as Sahi common domain, replace sahi.example.com with that domain in the above URLs.
  4. To automate in IE mode, we need to set Sahi as system proxy. So, we need to make the below changes in browser_types.xml.
    1. Open <Sahi_Installation>/userdata/config/browser_types.xml file.
    2. Search for msedge.exe. Remove --proxy-server=127.0.0.1:$port from startup options for Microsoft Edge.
    3. Specify the value as true for <useSystemProxy> as shown in the example below. 
      <browserType>
		<name>edgenew</name>
		<displayName>Edge New</displayName>
		<icon>msedge.png</icon>
		<path>$ProgramFiles (x86)\Microsoft\Edge\Application\msedge.exe</path>
		<options>--no-default-browser-check --user-data-dir=$userDir\browser\edge\profiles\sahi$threadNo --disable-popup-blocking -inprivate --disable-background-networking --disable-component-update --disable-renderer-backgrounding --disable-backgrounding-occluded-windows</options>
		<processName>msedge.exe</processName>
		<useSystemProxy>true</useSystemProxy>
		<capacity>5</capacity>
	</browserType>
    4. Save and restart Sahi.
infoNote:
  • To configure IE mode, you may need to connect with your Admin/Infrastructure team.
  • Sahi common domain will now open in IE mode. So, Microsoft Edge will inhibit Sahi to automate other websites that open in Edge mode. To automate webpages that open in Edge mode, follow the below steps:
    1. Launch a browser. Go to http://localhost:9999/_s_/dyn/ControllerUI_showActiveSessions. This page shows the currently active sessions.
    2. Now launch the application that opens in Edge mode.
    3. Refresh the Recently Active Sessions page to check if your application page is listed and has the same URL and title.
    4. Once your application is listed(use the window Title and URL to determine the right browser), click on launch link on Active Sessions page to launch the controller for Edge mode.
  • IE browser employs various security zones. If an application domain is added to any restrictive security zones like Local intranet or Trusted sites, IE prevents Sahi from identifying such application pages. To fix this, we need to add Sahi's common domain (sahi.example.com) to the same security zone.
  • To open Developer tools for IE mode on Microsoft Edge, launch Run dialog box by pressing the Windows key + R. Enter %systemroot%\system32\f12\IEChooser.exe, and then click OK.