README

wScriptLauncher

wScriptLauncher provides a simple human-machine, machine-machine interfaces to run a script file on a platform of interest and get output to your terminal. The platform could be remote or local, browser or native. Platforms list could be extended by an implementation of a new custom platform provider.

Implemented platforms :

Name - platform option value

Mozilla Firefox - firefox
Google Chrome - chrome
Electron - electron
PhantomJs - phantomjs
Node.js - node
Browserstack - browserstack

Installation

npm install wscriptlauncher

Usage options

Option	Type	Optional	Default	Description
filePath	string		path to script file
platform	string	*	chrome	sets target platfrom
headless	boolean	*	true	run in headless mode
terminatingAfter	boolean	*	true	terminate launcher after script execution
verbosity	number	*	1	sets level of details of console output

Usage with Nodejs:

var _ = wTools;

/* Initialize launcher with provided options object */

var launcher = wScriptLauncher
({
  filePath : '/path/to/file',
  headless : true,
  platform : 'chrome',
  terminatingAfter : true,
  verbosity : 1
});

/* Run our script file on target platform by calling launch, it
   returns wConsequence object which gives us a message with platform provider
   when all work will be done. More about wConsequence - https://github.com/Wandalen/wConsequence
*/

launcher.launch()
.got( function ( err, provider )
{
  if( err )
  throw _.errLog( err );

  console.log( provider );
});

Sample here.

Usage with command line:

To print help:

launcher

To run script with default setting:

launcher /path/to/file.js

To run script with options, first argument must be path:

launcher /path/to/file.js platform : chrome headless : 0 terminatingAfter : 1

Another way to run script with options:

launcher filePath : /path/to/file.js platform : firefox headless : 1

Acknowledgements

We would like to thank Browserstack for support!

Usage no npm install needed!