Adds methods: exec() and run()

lib/phantomjs.js

@@ -7,6 +7,8 @@
 
 var fs = require('fs')
 var path = require('path')
+var spawn = require('child_process').spawn
+var Promise = require('es6-promise').Promise
 
 
 /**
@@ -61,3 +63,34 @@ if (exports.path) {
     // We did our best. Likely because phantomjs was already installed.
   }
 }
+
+/**
+ * Executes a script or just runs PhantomJS
+ */
+exports.exec = function () {
+  var args = Array.prototype.slice.call(arguments)
+  return spawn(exports.path, args)
+}
+
+/**
+ * Runs PhantomJS with provided options
+ * @example
+ * // handy with WebDriver
+ * phantomjs.run('--webdriver=4444').then(program => {
+ *   // do something
+ *   program.kill()
+ * })
+ * @returns {Promise} the process of PhantomJS
+ */
+exports.run = function () {
+  var program = exports.exec.apply(null, arguments)
+  var isFirst = true
+  return new Promise(function (resolve) {
+    program.stdout.on('data', function () {
+      // This detects PhantomJS instance get ready.
+      if (!isFirst) return
+      isFirst = false
+      resolve(program)
+    })
+  })
+}

package.json

@@ -39,6 +39,7 @@
     "test": "nodeunit --reporter=minimal test/tests.js && eslint ."
   },
   "dependencies": {
+    "es6-promise": "^3.2.1",
     "extract-zip": "~1.5.0",
     "fs-extra": "~0.30.0",
     "hasha": "^2.2.0",
@@ -50,7 +51,8 @@
   },
   "devDependencies": {
     "eslint": "2.7.0",
-    "nodeunit": "0.9.1"
+    "nodeunit": "0.9.1",
+    "webdriverio": "^4.2.3"
   },
   "bundledDependencies": [
     "extract-zip",

test/tests.js

@@ -6,10 +6,10 @@
 var childProcess = require('child_process')
 var fs = require('fs')
 var path = require('path')
+var webdriverio = require('webdriverio')
 var phantomjs = require('../lib/phantomjs')
 var util = require('../lib/util')
 
-
 exports.testDownload = function (test) {
   test.expect(1)
   test.ok(fs.existsSync(phantomjs.path), 'Binary file should have been downloaded')
@@ -98,3 +98,28 @@ exports.testSuccessfulVerifyChecksum = function (test) {
     test.done()
   })
 }
+
+exports.testPhantomExec = function (test) {
+  test.expect(1)
+  var p = phantomjs.exec(path.join(__dirname, 'exit.js'))
+  p.on('exit', function (code) {
+    test.equals(code, 123, 'Exit code should be returned from phantom script')
+    test.done()
+  })
+}
+
+exports.testPhantomRun = function (test) {
+  test.expect(1)
+  var wdOpts = { desiredCapabilities: { browserName: 'phantomjs' } }
+  phantomjs.run('--webdriver=4444').then(function (p) {
+    webdriverio.remote(wdOpts).init()
+      .url('https://developer.mozilla.org/en-US/')
+      .getTitle().then(function (title) {
+        test.equals(title, 'Mozilla Developer Network', 'Page title')
+      })
+      .then(function () {
+        p.kill()
+        test.done()
+      })
+  })
+}