Created
August 21, 2014 23:38
-
-
Save heath/765b10928eb8cc13456c to your computer and use it in GitHub Desktop.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
#!/usr/bin/env node | |
requireCoffee = process.argv.some(function(arg){ | |
return arg == "-c" || arg == "--coffee" | |
}) | |
if (requireCoffee) { | |
var coffee = require("coffee-script"); | |
global.coffee = true; | |
console.log("using coffeescript") | |
} | |
/** | |
* This is an explorer to help get the right element locators, and test out what | |
* Protractor commands will do on your site without running a full test suite. | |
* | |
* This beta version only uses the Chrome browser. | |
* | |
* Usage: | |
* | |
* Expects a selenium standalone server to be running at http://localhost:4444 | |
* from protractor directory, run with: | |
* | |
* ./bin/elementexplorer.js <urL> | |
* | |
* 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: | |
* | |
* > element(by.id('foobar')).getText() | |
* | |
* or | |
* | |
* > browser.get('http://www.angularjs.org') | |
* | |
* try just | |
* | |
* > browser | |
* | |
* to get a list of functions you can call. | |
* | |
* Typing tab at a blank prompt will fill in a suggestion for finding | |
* elements. | |
*/ | |
var webdriver = require('selenium-webdriver'); | |
var protractor = require('../lib/protractor.js'); | |
var repl = require('repl'); | |
var util = require('util'); | |
var vm = require('vm'); | |
var driver, browser; | |
var INITIAL_SUGGESTIONS = [ | |
'element(by.id(\'\'))', | |
'element(by.css(\'\'))', | |
'element(by.name(\'\'))', | |
'element(by.binding(\'\'))', | |
'element(by.xpath(\'\'))', | |
'element(by.tagName(\'\'))', | |
'element(by.className(\'\'))' | |
]; | |
var list = function(locator) { | |
return browser.findElements(locator).then(function(arr) { | |
var found = []; | |
for (var i = 0; i < arr.length; ++i) { | |
arr[i].getText().then(function(text) { | |
found.push(text); | |
}); | |
} | |
return found; | |
}); | |
}; | |
var flowEval = function(code, context, file, callback) { | |
// this will fail if you just press enter | |
if (global.coffee) code = coffee.compile(code); | |
var vmErr, | |
result, | |
flow = webdriver.promise.controlFlow(); | |
flow.execute(function() { | |
try { | |
result = vm.runInThisContext(code, file); | |
} catch (e) { | |
vmErr = e; | |
callback(vmErr, null); | |
} | |
if (vmErr && process.domain) { | |
process.domain.emit('error', vmErr); | |
process.domain.exit(); | |
} | |
return webdriver.promise.fulfilled(result); | |
}).then(function(res) { | |
if (!vmErr) { | |
callback(null, res); | |
} | |
}, function(err) { | |
callback('There was a webdriver error: ' + err.name + ' ' + err.message, | |
null); | |
}); | |
}; | |
var startRepl = function() { | |
var flowRepl = repl.start({ | |
'useGlobal': true, | |
'eval': flowEval | |
}); | |
var originalComplete = flowRepl.complete; | |
flowRepl.complete = function(line, completeCallback) { | |
if (line == '') { | |
completeCallback(null, [INITIAL_SUGGESTIONS, '']); | |
} else { | |
originalComplete.apply(this, arguments); | |
} | |
}; | |
flowRepl.on('exit', function() { | |
driver.quit(); | |
util.puts('Shutting down. Goodbye.'); | |
}); | |
}; | |
var startUp = function() { | |
driver = new webdriver.Builder(). | |
usingServer('http://localhost:4444/wd/hub'). | |
withCapabilities({'browserName': 'chrome'}).build(); | |
driver.getSession().then(function(session) { | |
driver.manage().timeouts().setScriptTimeout(11000); | |
browser = protractor.wrapDriver(driver); | |
// Set up globals to be available from the command line. | |
global.driver = driver; | |
global.protractor = protractor; | |
global.browser = browser; | |
global.$ = browser.$; | |
global.$$ = browser.$$; | |
global.element = browser.element; | |
global.by = global.By = protractor.By; | |
global.list = list; | |
util.puts('Type <tab> to see a list of locator strategies.'); | |
util.puts('Use the `list` helper function to find elements by strategy:'); | |
util.puts(' e.g., list(by.binding(\'\')) gets all bindings.'); | |
util.puts(''); | |
// var url = process.argv[2] || 'about:blank'; | |
// util.puts('Getting page at: ' + url); | |
// driver.get(url); | |
startRepl(); | |
}); | |
}; | |
startUp(); |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment