Sahi headless execution with PhantomJS
PhantomJS is a headless browser based on WebKit. (A headless browser runs without a user interface)
Documentation since Sahi Pro V4.3.2
Section titled “Documentation since Sahi Pro V4.3.2”For Windows:
Section titled “For Windows:”-
Download phantomjs-1.9.x-windows.zip from http://code.google.com/p/phantomjs/downloads/list (Or choose the correct one from http://phantomjs.org/download.html) and make sure the version is 1.9.0 or above.
-
Unzip it and copy phantomjs.exe to sahi/ext/phantomjs folder such that you have sahi/ext/phantomjs/phantomjs.exe
-
On the Dashboard, click Add Browser. In
browser_types.xml, which opens, add this entry if it isn’t there:<browserType><name>phantomjs</name><displayName>PhantomJS</displayName><icon>phantomjs.png</icon><path>$sahiDir\ext\phantomjs\sahi_phantomjs.bat</path><options>--proxy=127.0.0.1:$port $sahiDir\ext\phantomjs\phantomsahi.js</options><processName>phantomjs.exe</processName><capacity>100</capacity><force>false</force></browserType> -
Save and restart Sahi.
-
To run a test in PhantomJS: Click on “Bin” on the dashboard (or navigate to sahi/userdata/bin on a command prompt) and run the command
Terminal window testrunner.bat sahitests/sahi_demo.sah http://sahi.co.in/demo/ phantomjs
For Linux:
Section titled “For Linux:”-
To install phantomjs, open terminal and enter the following command
sudo apt-get install phantomjsTo check if completed, just type (without quotes): “phantomjs –version” and it must appear 1.9 or above.
If the version is below 1.9 then follow the below steps or directly perform the below steps to get the version 1.9 or above.
Terminal window cd /usr/local/sharesudo wget https://phantomjs.googlecode.com/files/phantomjs-1.9.0-linux-x86_64.tar.bz2tar xjf phantomjs-1.9.0-linux-x86_64.tar.bz2sudo ln -s /usr/local/share/phantomjs-1.9.0-linux-x86_64/bin/phantomjs /usr/local/share/phantomjssudo ln -s /usr/local/share/phantomjs-1.9.0-linux-x86_64/bin/phantomjs /usr/local/bin/phantomjssudo ln -s /usr/local/share/phantomjs-1.9.0-linux-x86_64/bin/phantomjs /usr/bin/phantomjs -
On the Dashboard, click Add Browser. In
browser_types.xml, which opens, add this entry if it isn’t there:<browserType><name>phantomjs</name><displayName>PhantomJS</displayName><icon>phantomjs.png</icon><path>$sahiDir/ext/phantomjs/sahi_phantomjs.sh</path><options>--proxy=127.0.0.1:$port $sahiDir/ext/phantomjs/phantomsahi.js</options><processName>phantomjs</processName><capacity>100</capacity><force>false</force></browserType> -
Save and restart Sahi.
-
To run a test in PhantomJS: Open terminal, navigate to sahi/userdata/bin and run the command
Terminal window sh testrunner.sh sahitests/sahi_demo.sah http://sahi.co.in/demo/ phantomjs
This will run the Sahi script without opening a browser.
For Mac:
Section titled “For Mac:”-
To install phantomjs, open terminal and enter the following command
brew install phantomjsTo check if completed, just type (without quotes): “phantomjs -v” and it must appear 1.9 or above.
To install Homebrew on Mac OS.
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" -
On the Dashboard, click Add Browser. In
browser_types.xml, which opens, add this entry if it isn’t there:<browserType><name>phantomjs</name><displayName>PhantomJS</displayName><icon>phantomjs.png</icon><path>$sahiDir/ext/phantomjs/sahi_phantomjs.sh</path><options>--proxy=127.0.0.1:$port $sahiDir/ext/phantomjs/phantomsahi.js</options><processName>phantomjs</processName><capacity>100</capacity><useSystemProxy>false</useSystemProxy></browserType> -
Save and restart Sahi.
-
To run a test in PhantomJS: Open terminal, navigate to sahi/userdata/bin and run the command
Terminal window sh testrunner.sh sahitests/sahi_demo.sah http://sahi.co.in/demo/ phantomjs
This will run the Sahi script without opening a browser.
Older Documentation (before Sahi Pro V4.3.2)
Section titled “Older Documentation (before Sahi Pro V4.3.2)”-
Download phantomjs-1.x.x-win32-dynamic.zip from this link.
-
Unzip it to, say C:\phantomjs-1.x.x-win32 such that phantomjs.exe is available at C:\phantomjs-1.x.x-win32\phantomjs.exe
-
Create a file sahi.js in C:\phantomjs-1.x.x-win32 with the content below:
For version 1.2.0 onwards, use:
if (phantom.args.length === 0) {console.log('Usage: sahi.js <Sahi Playback Start URL>');phantom.exit();} else {// var address = unescape(phantom.args[0]); // use if < v1.7var address = phantom.args[0];console.log('Loading ' + address);var page = new WebPage();page.open(address, function(status) {if (status === 'success') {var title = page.evaluate(function() {return document.title;});console.log('Page title is ' + title);} else {console.log('FAIL to load the address');}});}For version 1.1.0, use:
if (phantom.state.length === 0) {if (phantom.args.length === 0) {console.log('Usage: sahi.js <Sahi Playback Start URL>');phantom.exit();} else {var address = unescape(phantom.args[0]);phantom.state = "sahi script running";console.log('Loading ' + address);phantom.open(address);}} else {if (phantom.loadStatus == 'success') {console.log('Page title is ' + document.title);} else {console.log('FAIL to load the address');}}The above code is based on the example provided by PhantomJS
-
On the Dashboard, click Add Browser. In
browser_types.xml, which opens, add:<browserType><name>phantomjs</name><displayName>PhantomJS</displayName><icon>phantomjs.png</icon><path>C:\phantomjs-1.1.0-win32\phantomjs.exe</path><options>--proxy=localhost:9999 C:\phantomjs-1.1.0-win32\sahi.js</options><processName>phantomjs.exe</processName><capacity>100</capacity><force>true</force></browserType>before the ending tag in browser_types.xml
-
Save and restart Sahi.
-
To run a test in PhantomJS: Click on “Bin” on the dashboard (or navigate to sahi/userdata/bin on a command prompt) and run the command
testrunner.bat sahitests/sahi_demo.sah http://sahi.co.in/demo/ phantomjsThis will run the Sahi script without opening a browser.

