fix: remove elementExplorer api and command line

Protractor debugger and element explorer cannot be used for Node.js 8+ and were removed in version 7.

Author: alan-agius4

bin/elementexplorer.js

@@ -258,51 +258,6 @@ used from the browser's console.
 > window.clientSideScripts.findInputs('username', document.getElementById('#myEl'));
 ```
 
-**Testing Out Protractor Interactively**
-
-When debugging or first writing test suites, you may find it helpful to
-try out Protractor commands without starting up the entire test suite. You can
-do this with the element explorer.
-
-To run element explorer, simply run protractor as you normally would, but pass in
-the flag --elementExplorer:
-
-    protractor --elementExplorer
-
-This will load up the URL on WebDriver and put the terminal into a REPL loop.
-You will see a > prompt. The `browser`, `element` and `protractor` variables will
-be available. Enter a command such as:
-
-    > browser.get('http://www.angularjs.org')
-
-or
-
-    > element(by.id('foobar')).getText()
-
-Typing tab at a blank prompt will fill in a suggestion for finding
-elements. You can also use the `list(locator)` command to list all elements
-matching a locator.
-
-Element explorer will start chrome by default. However, you can specify
-another browser, change browser settings, or specify any other config that you
-normally would with your protractor test. To do this, pass configs to
-protractor like you normally would,
-but with the `--elementExplorer` flag set:
-
-    protractor [configFile] [options] --elementExplorer
-
-For example, to connect to ChromeDriver directly, use
-
-    protractor --directConnect --elementExplorer
-
-Element explore will ignore your specs, not set up your framework (e.g. jasmine,
-mocha, cucumber), and only allow you to pass in 1 capability, but will honor
-every other parameter in your config.
-
-Note `baseUrl` is used here as the initial page, i.e. element explorer will try
-to navigate to `baseUrl` automatically on start.
-
-
 ## Taking Screenshots
 
 WebDriver can snap a screenshot with `browser.takeScreenshot()`. This can be a

docs/debugging.md

@@ -99,7 +99,6 @@ let allowedNames = [
   'nodeDebug',
   'debuggerServerPort',
   'frameworkPath',
-  'elementExplorer',
   'debug',
   'logLevel',
   'disableChecks',
@@ -134,7 +133,6 @@ let yargsOptions: any = {
     framework: 'Test framework to use: jasmine, mocha, or custom',
     resultJsonOutputFile: 'Path to save JSON test result',
     troubleshoot: 'Turn on troubleshooting output',
-    elementExplorer: 'Interactively test Protractor commands',
     debuggerServerPort: 'Start a debugger server at specified port instead of repl',
     disableChecks: 'Disable cli checks',
     logLevel: 'Define Protractor log level [ERROR, WARN, INFO, DEBUG]'
@@ -148,7 +146,6 @@ let yargsOptions: any = {
     build: 'capabilities.build',
     grep: 'jasmineNodeOpts.grep',
     'invert-grep': 'jasmineNodeOpts.invertGrep',
-    explorer: 'elementExplorer'
   },
   strings: {'capabilities.tunnel-identifier': ''}
 };
@@ -232,7 +229,7 @@ if (!configFile) {
   }
 }
 
-if (!configFile && !argv.elementExplorer && args.length < 3) {
+if (!configFile && args.length < 3) {
   console.log(
       '**you must either specify a configuration file ' +
       'or at least 3 options. See below for the options:\n');

lib/cli.ts

@@ -159,8 +159,7 @@ let initFn = function(configFile: string, additionalConfig: Config) {
             });
       })
       .then(() => {
-        // 3) If we're in `elementExplorer` mode, run only that.
-        if (config.elementExplorer || config.framework === 'explorer') {
+        if (config.framework === 'explorer') {
           if (config.multiCapabilities.length != 1) {
             throw new Error('Must specify only 1 browser while using elementExplorer');
           } else {