Test: Asynchronous Event Testing
+ +This example shows how to create an asynchronous test with the YUI Test framework for testing browser-based JavaScript code.
+ A code>Y.Test.Case object is created to test the
+ Y.Anim object. The test waits until the animation is complete
+ before checking the settings of the animated element.
Asynchronous Events Test Example
+ +This example begins by creating a namespace:
+
Y.namespace("example.test");
Y.namespace("example.test");
This namespace serves as the core object upon which others will be added (to prevent creating global objects).
+ +Creating the TestCase
+ +The first step is to create a new Y.Test.Caseobject called AsyncTestCase.
+ To do so, using the Y.Test.Caseconstructor and pass in an object literal containing information about the tests to be run:
Y.example.test.AsyncTestCase = new Y.Test.Case({ //name of the test case - if not provided, one is auto-generated name : "Animation Tests", //--------------------------------------------------------------------- // Test methods - names must begin with "test" //--------------------------------------------------------------------- testAnimation : function (){ var myAnim = new Y.Anim({ node: '#testDiv', to: { width: 400 }, duration: 3, easing: Y.Easing.easeOut }); //assign oncomplete handler myAnim.on("end", function(){ //tell the TestRunner to resume this.resume(function(){ Y.Assert.areEqual(document.getElementById("testDiv").offsetWidth, 400, "Width of the DIV should be 400."); }); }, this, true); //start the animation myAnim.run(); //wait until something happens this.wait(); } });
Y.example.test.AsyncTestCase = new Y.Test.Case({ + + //name of the test case - if not provided, one is auto-generated + name : "Animation Tests", + + //--------------------------------------------------------------------- + // Test methods - names must begin with "test" + //--------------------------------------------------------------------- + + testAnimation : function (){ + + var myAnim = new Y.Anim({ + node: '#testDiv', + to: { + width: 400 + }, + duration: 3, + easing: Y.Easing.easeOut + }); + + //assign oncomplete handler + myAnim.on("end", function(){ + + //tell the TestRunner to resume + this.resume(function(){ + + Y.Assert.areEqual(document.getElementById("testDiv").offsetWidth, 400, "Width of the DIV should be 400."); + + }); + + }, this, true); + + //start the animation + myAnim.run(); + + //wait until something happens + this.wait(); + + } + +});
The only test in the Y.Test.Caseis called testAnimation. It begins by creating a new
+Anim object that will animate the width of a div to 400 pixels over three seconds. An
+event handler is assigned to the Anim object's end event, within which the
+resume() method is called. A function is passed into the resume() method to indicate
+the code to run when the test resumes, which is a test to make sure the width is 400 pixels. After that, the
+run() method is called to begin the animation and the wait() method is called to
+tell the Y.Test.Runner to wait until it is told to resume testing again. When the animation completes,
+the end event is fired and the test resumes, assuring that the width is correct.
Running the tests
+ +With all of the tests defined, the last step is to run them:
+ +
//create the console var r = new Y.Console({ verbose : true, newestOnTop : false }); r.render('#testLogger'); //create the logger Y.Test.Runner.add(Y.example.test.AsyncTestCase); //run the tests Y.Test.Runner.run();
//create the console +var r = new Y.Console({ + verbose : true, + newestOnTop : false +}); + +r.render('#testLogger'); + +//create the logger +Y.Test.Runner.add(Y.example.test.AsyncTestCase); + +//run the tests +Y.Test.Runner.run();
Before running the tests, it's necessary to create a Y.Console object to display the results (otherwise the tests would run
+ but you wouldn't see the results). After that, the Y.Test.Runner is loaded with the Y.Test.Caseobject by calling
+ add() (any number of Y.Test.Caseand TestSuite objects can be added to a Y.Test.Runner,
+ this example only adds one for simplicity). The very last step is to call run(), which begins executing the tests in its
+ queue and displays the results in the Y.Console.

