Andrej Cimperšek - diploma

-------------------------------------------------------------------------------

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.