Adding Yarn, updating dependencies, using 3.0.1 selenium by default (#259)

* Updated dependency versions with yarn. Added yarn lockfile. Using 3.0.1 selenium. Updated docs to reference newer drivers.

* Using java 8

* Switched travis job to be java to get 1.8

* Using travis install and script to drive tests

* Added documentation and error message to inform user of minimum java version

* Removing section seperators from README

* Fixed typo

* Feature/touchup travis (#3)

* Merged latest master

* Using node version matrix

* Using shorter travis matrix

* Using env matrix for travis node version

Author: Drew Diamantoukos

.travis.yml

@@ -1,10 +1,19 @@
 sudo: false
 
-language: node_js
-node_js:
-  - stable
-  - 6
-  - 5
-  - 4
-  - 0.12
+language: java
 
+jdk:
+  - oraclejdk8
+
+env:
+  - TRAVIS_NODE_VERSION="stable"
+  - TRAVIS_NODE_VERSION=5
+  - TRAVIS_NODE_VERSION=4
+  - TRAVIS_NODE_VERSION=0.12
+
+before_install:
+  - nvm install $TRAVIS_NODE_VERSION
+
+install: "npm install"
+
+script: "npm test"

README.md

@@ -53,7 +53,7 @@ Config file can be a JSON file or a [module file](https://nodejs.org/api/modules
 module.exports = {
   drivers: {
     chrome: {
-      version: '2.23',
+      version: '2.27',
       arch: process.arch,
       baseURL: 'https://chromedriver.storage.googleapis.com'
     },
@@ -64,6 +64,7 @@ module.exports = {
 ## Application Programming Interface (API)
 
 ### Sample configuration object
+
 Here you can find an up-to-date example of the configuration object:
 [lib/default-config.js](lib/default-config.js)
 
@@ -75,20 +76,20 @@ var selenium = require('selenium-standalone');
 selenium.install({
   // check for more recent versions of selenium here:
   // https://selenium-release.storage.googleapis.com/index.html
-  version: '2.53.1',
+  version: '3.0.1',
   baseURL: 'https://selenium-release.storage.googleapis.com',
   drivers: {
     chrome: {
       // check for more recent versions of chrome driver here:
       // https://chromedriver.storage.googleapis.com/index.html
-      version: '2.23',
+      version: '2.27',
       arch: process.arch,
       baseURL: 'https://chromedriver.storage.googleapis.com'
     },
     ie: {
       // check for more recent versions of internet explorer driver here:
       // https://selenium-release.storage.googleapis.com/index.html
-      version: '2.53.1',
+      version: '3.0.1',
       arch: process.arch,
       baseURL: 'https://selenium-release.storage.googleapis.com'
     }
@@ -114,12 +115,12 @@ Here are the current defaults:
 ```js
 {
   chrome: {
-    version: '2.23',
+    version: '2.27',
     arch: process.arch,
     baseURL: 'https://chromedriver.storage.googleapis.com'
   },
   ie: {
-    version: '2.53.1',
+    version: '3.0.1',
     arch: process.arch,
     baseURL: 'https://selenium-release.storage.googleapis.com'
   }
@@ -185,8 +186,22 @@ After installing selenium-standalone globally, execute the following commands to
 ln -s /usr/local/bin/selenium-standalone /etc/init.d/
 update-rc.d selenium-standalone defaults
 ```
+
 For more information: https://stackoverflow.com/questions/3666794/selenium-server-on-startup/30392437#30392437
 
+### Ensure you have the minimum required Java version
+
+With the release of Selenium 3+, the minimum required version of Java is 8, as [7 has ceased public updates](https://java.com/en/download/faq/java_7.xml).
+
+If an older selenium version is needed, you can check the requirements on the [official Selenium changelog](https://raw.githubusercontent.com/SeleniumHQ/selenium/master/java/CHANGELOG).
+
+Here is a reference sheet for the more recent Selenium version:
+
+| Selenium version | Minimum Java Required |
+|   ---   |   ---   |
+| 3.0.0+  | Java 8  |
+| 2.47.0+ | Java 7  |
+| 2.22.0+ | Java 6  |
 
 ### Running headlessly
 

lib/default-config.js

@@ -1,14 +1,14 @@
 module.exports = {
   baseURL: 'https://selenium-release.storage.googleapis.com',
-  version: '2.53.1',
+  version: '3.0.1',
   drivers: {
     chrome: {
       version: '2.27',
       arch: process.arch,
       baseURL: 'https://chromedriver.storage.googleapis.com'
     },
     ie: {
-      version: '2.53.1',
+      version: '3.0.1',
       arch: process.arch,
       baseURL: 'https://selenium-release.storage.googleapis.com'
     },

lib/start.js

@@ -18,7 +18,7 @@ function start(opts, cb) {
     cb = opts;
     opts = {};
   }
-  
+
   if (!opts.javaArgs) {
     opts.javaArgs = [];
   }
@@ -66,12 +66,12 @@ function start(opts, cb) {
       3) Selenium specific arguments
 
      Example:
-       java -Dwebdriver.chrome.driver=./.selenium/chromedriver/2.22-x64-chromedriver \
-          -jar ./.selenium/selenium-server/2.53.1-server.jar \
+       java -Dwebdriver.chrome.driver=./.selenium/chromedriver/2.27-x64-chromedriver \
+          -jar ./.selenium/selenium-server/3.0.1-server.jar \
           -role hub
    */
   var args = [];
-  
+
   if (fsPaths.chrome) {
     args.push('-Dwebdriver.chrome.driver=' + fsPaths.chrome.installPath);
   }
@@ -85,7 +85,7 @@ function start(opts, cb) {
   if (fsPaths.firefox) {
     args.push('-Dwebdriver.gecko.driver=' + fsPaths.firefox.installPath);
   }
-  
+
   args = args.concat(opts.javaArgs);
 
   args = args.concat(['-jar', fsPaths.selenium.installPath]);
@@ -133,18 +133,21 @@ function start(opts, cb) {
     });
 
     function errorIfNeverStarted(code) {
-      var err;
-
       neverStarted = true;
 
+      var errorMsg;
       if (code === 1) {
-        err = new Error('Selenium server did not start.' +
-          'Another Selenium process may already be running or your java version may be out of date.')
+        errorMsg = 'Selenium server did not start.\n';
       } else {
-        err = new Error('Selenium exited before it could start')
+       errorMsg = 'Selenium exited before it could start\n';
       }
+      errorMsg += 'Another Selenium process may already be running or your java version may be out of date.\n';
 
-      cb(err);
+      // TODO: Is there a way to get this info from the api?
+      // 3.x requires Java 8+, 2.47.0+ requires Java 7 - 7 is also end-of-life apparently ?
+      errorMsg += 'Be sure to check the official Selenium release notes for minimum required java version: https://raw.githubusercontent.com/SeleniumHQ/selenium/master/java/CHANGELOG\n';
+
+      cb(new Error(errorMsg));
     }
   });
 }

package.json

@@ -21,16 +21,16 @@
   "author": "Vincent Voyer <[email protected]>",
   "license": "MIT",
   "dependencies": {
-    "async": "1.2.1",
-    "commander": "2.6.0",
-    "lodash": "3.9.3",
-    "minimist": "1.1.0",
-    "mkdirp": "0.5.0",
+    "async": "^2.1.4",
+    "commander": "^2.9.0",
+    "lodash": "^4.17.4",
+    "minimist": "^1.2.0",
+    "mkdirp": "^0.5.1",
     "progress": "1.1.8",
     "request": "2.79.0",
     "tar-stream": "1.5.2",
-    "urijs": "1.16.1",
-    "which": "1.1.1",
+    "urijs": "^1.18.4",
+    "which": "^1.2.12",
     "yauzl": "^2.5.0"
   },
   "devDependencies": {