Skip to content
Get Free Trial

Execute External Programs

Sahi allows calling external programs via _execute or by calling Java directly

Since
Sahi Pro 3.5
Desktop Engine 7.0.0
Mobile Engine 7.5.0
SAP Engine 9.0.0

Modes BrowserWindowsJavaAndroidiOSSAP

_execute($cmd[, $isSync[, $timeout]])

Arguments

NameTypeDescription
$cmdstringCommand to be executed. Normally this will be a command that can be run on the system's commandline
$isSyncbooleanoptionalIf true, returns only on completion of cmd. If false, returns immediately while cmd is run in background
$timeoutintegeroptionalIf timeout is specified and if isSync is true, the function will return after timeout milliseconds if cmd has not finished till then. cmd will continue to run in background

Returns

stringcommand output

_execute allows calling batch files, shell scripts or regular commands from Sahi script.

_execute("C:\\sendemail.bat"); // runs C:\sendemail.bat and returns immediately while sendmail runs in the background
_execute("C:\\sendemail.bat", true); // runs C:\sendemail.bat and waits till sendmail finishes
// runs C:\sendemail.bat and returns after 2 seconds if sendmail has not completed by then.
_execute("C:\\sendemail.bat", true, 2000);
// if _execute("C:\\sendemail.bat"); does not work, on Windows, try:
_execute("cmd /C C:\\sendemail.bat");
// On Linux and Mac use forward slashes as filepath separator
// Make sure that the shell script has necessary permissions
_execute("/home/user1/bin/sendemail.sh");
// or
_execute("sh /home/user1/bin/sendemail.sh");