SOURCE CODE: UizeDotCom.Page.Example.Test

/*______________
|       ______  |   U I Z E    J A V A S C R I P T    F R A M E W O R K
|     /      /  |   ---------------------------------------------------
|    /    O /   |    MODULE : UizeDotCom.Page.Example.Test
|   /    / /    |
|  /    / /  /| |    ONLINE : http://uize.com
| /____/ /__/_| | COPYRIGHT : (c)2008-2009 UIZE
|          /___ |   LICENSE : Available under MIT License or GNU General Public License
|_______________|             http://uize.com/license.html
*/

/*?
  Introduction
    A subclass of =UizeDotCom.Page.Example= that provides additional functionality specific to test pages.

    *DEVELOPERS:* `Chris van Rensburg`
*/

/*ScruncherSettings Mappings="=f" LineCompacting="TRUE"*/

Uize.module ({
  name:'UizeDotCom.Page.Example.Test',
  required:'Uize.Widget.Button',
  builder:function (_superclass) {
    /*** Class Constructor ***/
      var
        _class = _superclass.subclass (
          null,
          function () {
            var _this = this;

            /*** add performTest child buttonm ***/
              var _performTestButton = Uize.Widget.Button.addChildButton.call (
                this,
                'performTest',
                function () {
                  _performTestButton.set ({busy:true});
                  _this.setNodeInnerHtml (
                    'testResults',
                    '
BUSY PERFORMING TEST
' +
                    '
-- you get no progress bar because we don\'t want to pollute the results --
'
                  );
                  setTimeout (
                    function () {
                      _this.performTest (
                        function (_testResults) {
                          _this.setNodeInnerHtml ('testResults',_testResults);
                          /*?
                            Implied Nodes
                              testResults
                                A node whose innerHTML will be replaced with the test results HTML reported back from the call to the =performTest= instance method.
                          */
                          _performTestButton.set ({busy:'inherit'});
                          _performTestButton.setNodeInnerHtml ('','PERFORM TEST AGAIN');
                        }
                      );
                    },
                    500
                  );
                }
                /*?
                  Child Widgets
                    performTest
                      A button that, when clicked, calls the =performTest= instance method that should be overrided by each test page.
                */
              );
          }
        ),
        _classPrototype = _class.prototype
      ;

    /*** Public Instance Methods ***/
      _classPrototype.executeFunctionsWithPause = function (_functions,_pause,_callback) {
        function _executeNextFunction () {
          _functionNo++;
          _functionNo < _functionsLength
            ?
              setTimeout (
                function () {
                  var _startTime = new Date;
                  _functions [_functionNo] ();
                  _executionTimes.push (new Date - _startTime);
                  _executeNextFunction ();
                },
                _pause
              )
            : _callback (_executionTimes)
          ;
        }
        var
          _functionsLength = _functions.length,
          _executionTimes = [],
          _functionNo = -1
        ;
        _executeNextFunction ();
      };

      _classPrototype.performTest = function (_callback) {
        _callback ('');
        /*?
          Instance Methods
            performTest
              A method that performs the test for the test page.

              SYNTAX
              ................................
              performTest (reportResultsFUNC);
              ................................

              This method's implementation should be overrided by a particular test page, to perform the test specific to that page. Your implementation should expect to receive one parameter, =reportResultsFUNC=, being a function that should be called to report back the results of the test once it has completed. The =reportResultsFUNC= callback function expects one string parameter, being a report of the test's results in HTML format, which will be placed into the =testResults= implied node.
        */
      };

    return _class;
  }
});