All browser configurations are made in sahi/userdata/browser_types.xml
The typical syntax is given below.
<browserTypes>
<browserType>
<name>firefox</name>
<displayName>Firefox</displayName>
<icon>firefox.png</icon>
<path>$ProgramFiles\Mozilla Firefox\firefox.exe</path>
<options>-profile "$userDir/browser/ff/profiles/sahi$threadNo"
-no-remote</options>
<processName>firefox.exe</processName>
<capacity>5</capacity>
</browserType>
</browserTypes>
| name | key by which this browserType will be referred |
| displayName | Text visible on the Sahi Dashboard |
| icon | png icon. These are bundled inside Sahi |
| path | path to browser executable. If you run this from a command line, it should invoke the browser |
| options | options needed by browser. Generally this sets the proxy, and isolates browser sessions so that cookies are not shared |
| processName | the processName for looking up PID of process. Sahi will do a tasklist or ps with this name to identify the process to kill |
| capacity | maximum number of browsers simultaneously executable without overwhelming the system. This depends on your system and you can configure this based on your judgement |
| useSystemProxy | true/false Specifies if Windows system proxy settings should be changed to use Proxy. Needed by Internet Explorer and Safari on Windows |
| force | true/false Sahi checks to see that the “path” attribute above is correct and available on the system. On some OSes the path is not really a file path but a command to invoke the browser. Use force=true in those cases |
If your browser is installed in a non standard directory, edit sahi/userdata/browser_types.xml and set the correct path.
Alternatively, you can click on “Configure” link on the Sahi Dashboard and edit browser_types.xml.
Sahi needs to be restarted for the settings to take effect.
Sahi comes with default configurations for various browsers and operating systems. These are available in sahi/config/browser_types directory. If sahi/userdata/config/browser_types.xml file is deleted, the correct file will be replaced from the defaults.
| Default browser configurations for various operating systems: | |||
|---|---|---|---|
| win32.xml | win64.xml | linux.xml | mac.xml |