[js] Remove support for the legacy SafariDriver. Safari 10 or bust.

Users can still use the standalone server for Safari 9.

#2725

Author: jleyba

javascript/node/selenium-webdriver/CHANGES.md

@@ -1,3 +1,24 @@
+## v.next
+
+* Removed native support for Safari 9 and older. Apple's safaridriver
+  is now used for Safari 10 (available on El Capitan and macOS Sierra).
+
+  To use Safari 9, the builder should be configured to use an instance of the
+  Selenium standalone server and `safari.Options` should be configured to
+  enable the legacy driver. For instance:
+
+  ```
+  const webdriver = require('selenium-webdriver');
+  const safari = require('selenium-webdriver/safari');
+
+  let driver = new webdriver.Builder()
+      .forBrowser('safari')
+      .usingServer('http://localhost:4444/wd/hub')
+      .setSafariOptions(new safari.Options().useLegacyDriver(true))
+      .build();
+  ```
+
+
 ## v3.0.0-beta-3
 
 * Fixed a bug where the promise manager would silently drop callbacks after

javascript/node/selenium-webdriver/README.md

@@ -11,22 +11,15 @@ Selenium may be installed via npm with
     npm install selenium-webdriver
 
 You will need to download additional components to work with each of the major
-browsers. The drivers for Chrome, Firefox, Safari, PhantomJS, Opera, and
+browsers. The drivers for Chrome, Firefox, PhantomJS, Opera, and
 Microsoft's IE and Edge web browsers are all standalone executables that should
 be placed on your system [PATH]. Apple's safaridriver is shipped with
-Safari 10 in macOS Sierra. You will need to enable Remote Automation in
-the Develop menu of Safari 10 before testing.
+Safari 10 for OS X El Capitan and macOS Sierra. You will need to enable Remote
+Automation in the Develop menu of Safari 10 before testing.
 
 > **NOTE:**  Mozilla's [geckodriver] is only required for Firefox 47+.
 > Everything you need for Firefox 38-46 is included with this package.
 
-> **NOTE:**  Apple's [safaridriver] is preferred for testing Safari 10+.
-> To test versions of Safari prior to Safari 10, The
-> [SafariDriver.safariextz][release] browser extension should be
-> installed in your browser before using Selenium. We recommend
-> disabling the extension when using the browser without Selenium
-> or installing the extension in a profile only used for testing.
-
 
 | Browser           | Component                          |
 | ----------------- | ---------------------------------- |

javascript/node/selenium-webdriver/package.json

@@ -26,7 +26,6 @@
     "adm-zip": "0.4.4",
     "rimraf": "^2.2.8",
     "tmp": "0.0.24",
-    "ws": "^1.0.1",
     "xml2js": "0.4.4"
   },
   "devDependencies": {