Skip to content
Get Free Trial

Sahi Scripting Basics

Sahi script is based on javascript. Sahi script is parsed by Sahi and the parsed script is fully valid javascript which is executed by the rhino javascript engine. Below are the normal constructs used in Sahi script. They are the same as javascript except for the mandatory $ used in variables.

Statements are normal lines of code. They end with a semi-colon.

Eg.

_click(_link("Login"));
var $variableName = value;

or

var $variableName; // declaration
$variableName = value; // assignment

All variables start with a $. The keyword var is used for local variables.

Eg.

var $username = "SahiTestUser";
var $password; // declaration;
$password = $username + "_password"; // "SahiTestUser_password"
// This is a single line comment
/*
This is a multiline comment.
This has two lines
*/
if (condition) {
// statements
}

Eg.

// Comparing normal values
if ($username == "PartnerUser"){
_click(_link("Partner Login"));
}
// Comparing with browser attributes exposed by Sahi
if (_getText(_div("page_type")) == "Partner Page"){
_click(_link("Partner Login"));
}
// Comparing with browser attributes NOT exposed by Sahi's built-in fetch apis
// using _fetch
if (_fetch(_link(0).href) == "http://sahi.co.in/"){
_click(_link("Partner Login"));
}
// Comparing with browser attributes NOT exposed by Sahi's built-in fetch apis
// using _condition
if (_condition(_link(0).href="=" "http://sahi.co.in/")){
_click(_link("Partner Login"));
}
for (var $i=0; $i<$max; $i++){
// statements
}

Eg.

// This loop will login with user1, password1, user2, password2 etc.
// login and logout are custom functions.
for (var $i=0; $i<10; $i++){
login("user"+$i, "password"+$i);
logout();
}
while (condition) {
// statements
}

Eg.

$i = 0;
while ($i++ < 10) {
login("user"+$i, "password"+$i);
logout();
}

Functions are the basic building blocks in your automation. Functions are used to club together multiple steps into one logical action.

Functions reduce code duplication and allow easier maintenance of scripts.

function functionName($parameter1, $parameter2) {
// statements
}

For example a login function may look like this

// function declaration
function login($usr, $pwd){
_click(_link("Login"));
_setValue(_textbox("username"), $usr);
_setValue(_password("password"), $pwd);
_click(_submit("Login"));
}
// function call
login("test", "secret");

To reuse a function from one script in another, we include the relevant script using _include. Functions and variables declared in the included script are available in the including script.

Eg.

common.sah

// File: common.sah
// declare $DEFAULT_USER variable
var $DEFAULT_USER = "test";
// login function declaration
function login($usr, $pwd){
_click(_link("Login"));
_setValue(_textbox("username"), $usr);
_setValue(_password("password"), $pwd);
_click(_submit("Login"));
}

testcase1.sah

// File: testcase1.sah
// include common.sah shown above.
_include("common.sah");
// Note how login and $DEFAULT_USER are actually declared
// in common.sah but available here in testcase1.sah.
login($DEFAULT_USER, "secret");