automate
Not really ready for prime time. Works well for us
Automated javascript testing. Esp for phonegap applications where you need to bundle integration tests with the app and test on an actual device.
Dependencies
- Only npm support at this point. So you'll need something like browserify to bundle it into the browser.
- requires jQuery
Has two components.
- Server: a reporting server where test run information is logged
- lib/automate.js is the runner code that needs to be bundled with the js app
Install
npm install automatejs
Server
Start the server using
node appjs //ornpm start
Automatejs client library
Create an instance of automate for each run. This creates a unique run id, used to submit reports to server
var Automate = var automate = serverUrl nameOfTest;
Now use the various methods to say what all you need to do
automate;automate;automate;
Add your asserts at any point. You can use any assert library, here I use chai.
automate;
Signal that you are done specifying your tests
automate; //Runs each step one by one, and submits the report to server
API reference
Constructor
var automate = automateSeverUrl nameOfTest;//examplevar automate = "http://localhost:5000" "regression suite";
Methods
Tap
automate;//exampleautomate;
fill a textbox or text input
automate;//exampleautomate;
select a drop down
automate;//exampleautomate;
start/then: execute arbitrary piece of javascript at that time. Useful to add asserts. start and then are equivalent, just syntax sugar to indicate start of a test.
automatestartautomate.then(function)//exampleautomate.start(function(){ to;};
waitFor: timeout or function
automate;automatefn: return true to indicate waitFor condition is met//exampleautomate;automate
runAll: Signal that you are done specifying the test. Now run actions one by one. On each step, information will be logged in automate server. If there is an error in any step, it'll bail out.
automate
module: Indicate start of a module. Once a module is set, any actions done like a tap are logged under that module. If none specified, all tests go into 'default' module. Module names should be unique, or reports will get messed up.
automate//exampleautomate
License & Contribution
Extension Cord is released under the Apache 2.0 license. Comments, bugs, pull requests, and other contributions are all welcomed! For questions please feel free to contact pnewman@deem.com or paul.yi@deem.com