-------------------------------------------------------------------------------
dojox.robot.recorder
-------------------------------------------------------------------------------
Version 0.1
Release date: 2008-07-30
-------------------------------------------------------------------------------
Project state: experimental
-------------------------------------------------------------------------------
Project authors
	Mark Hays
-------------------------------------------------------------------------------
Project description
 
Writing automated test cases takes time, and DOH is no exception. You have to
look up element ids, invent dojo.queries for elements with no id,
figure out exactly how many pixels to move the mouse . . . the list goes on.
 
This recorder module enables DOH test case writers to create complete DOH test
scripts directly from their actions and input on a Web page. Simply drop the
generated code into your test page, set a pass condition, and the test will
repeat your actions.
-------------------------------------------------------------------------------
Dependencies:
 
dojo
-------------------------------------------------------------------------------
Documentation
 
See installation instructions below to prepare a test page for recording.
 
To record a test, click in an area of the document with no dojo.stopEvents
and press CTRL-ALT-ENTER in the main window. You will get a verification alert
when you successfully start the recorder. Then you can interact with the Web
page and the recorder will monitor your actions. It's usually good to record one
test per widget instance per type of interaction (keyboard vs mouse for instance)
you are testing.
 
After you finish interacting with the Web page, click out of any dojo.stopEvents
and press CTRL-ALT-ENTER again. You will see a box containing the generated source 
code for your recording. Copy this into a dojo.addOnLoad on the same page to register 
the test with DOH. Replace the /*Your condition here*/ text with a JS condition that
indicates that the test passed. Again, having multiple small tests will help you
keep the condition small. Add a doh.run() call after you register all of your tests
to make them execute when you load the page.
-------------------------------------------------------------------------------
Installation instructions
 
To ready the recorder for a particular page, add this line to your dojo.requires:
dojo.require("dojox.robot.recorder");
 
You can safely remove this line after you are finished recording your tests.
-------------------------------------------------------------------------------
Additional Notes
 
Known limitations:
- Content in an iframe might not report events to the recorder.
- keyDown/keyUp events are supported by DOH, but not by the recorder.
	If you hold a key down, it will generate lots of keyPress events instead.
	Simply change these to one keyDown call yourself.