ruby_css_lint 0.0.1

data/csslint/lib/yuitest-rhino-cli.js

@@ -0,0 +1,3955 @@
+/**
+ * YUI Test Framework
+ * @module yuitest
+ */
+
+/**
+ * The root namespace for YUI Test.
+ * @class YUITest
+ * @static
+ */
+
+var YUITest = {
+    version: "@VERSION@"
+};
+
+
+/**
+ * Simple custom event implementation.
+ * @namespace YUITest
+ * @class EventTarget
+ * @constructor
+ */
+YUITest.EventTarget = function(){
+
+    /**
+     * Event handlers for the various events.
+     * @type Object
+     * @private
+     * @property _handlers
+     * @static
+     */
+    this._handlers = {};
+
+};
+    
+YUITest.EventTarget.prototype = {
+
+    //restore prototype
+    constructor: YUITest.EventTarget,
+            
+    //-------------------------------------------------------------------------
+    // Event Handling
+    //-------------------------------------------------------------------------
+    
+    /**
+     * Adds a listener for a given event type.
+     * @param {String} type The type of event to add a listener for.
+     * @param {Function} listener The function to call when the event occurs.
+     * @return {void}
+     * @method attach
+     */
+    attach: function(type, listener){
+        if (typeof this._handlers[type] == "undefined"){
+            this._handlers[type] = [];
+        }
+
+        this._handlers[type].push(listener);
+    },
+    
+    /**
+     * Adds a listener for a given event type.
+     * @param {String} type The type of event to add a listener for.
+     * @param {Function} listener The function to call when the event occurs.
+     * @return {void}
+     * @method subscribe
+     * @deprecated
+     */
+    subscribe: function(type, listener){
+        this.attach.apply(this, arguments);
+    },
+    
+    /**
+     * Fires an event based on the passed-in object.
+     * @param {Object|String} event An object with at least a 'type' attribute
+     *      or a string indicating the event name.
+     * @return {void}
+     * @method fire
+     */    
+    fire: function(event){
+        if (typeof event == "string"){
+            event = { type: event };
+        }
+        if (!event.target){
+            event.target = this;
+        }
+        
+        if (!event.type){
+            throw new Error("Event object missing 'type' property.");
+        }
+        
+        if (this._handlers[event.type] instanceof Array){
+            var handlers = this._handlers[event.type];
+            for (var i=0, len=handlers.length; i < len; i++){
+                handlers[i].call(this, event);
+            }
+        }            
+    },
+
+    /**
+     * Removes a listener for a given event type.
+     * @param {String} type The type of event to remove a listener from.
+     * @param {Function} listener The function to remove from the event.
+     * @return {void}
+     * @method detach
+     */
+    detach: function(type, listener){
+        if (this._handlers[type] instanceof Array){
+            var handlers = this._handlers[type];
+            for (var i=0, len=handlers.length; i < len; i++){
+                if (handlers[i] === listener){
+                    handlers.splice(i, 1);
+                    break;
+                }
+            }
+        }            
+    },
+    
+    /**
+     * Removes a listener for a given event type.
+     * @param {String} type The type of event to remove a listener from.
+     * @param {Function} listener The function to remove from the event.
+     * @return {void}
+     * @method unsubscribe
+     * @deprecated
+     */
+    unsubscribe: function(type, listener){
+        this.detach.apply(this, arguments);          
+    }    
+
+};
+
+
+/**
+ * Object containing helper methods.
+ * @namespace YUITest
+ * @class Util
+ * @static
+ */
+YUITest.Util = {
+
+    /**
+     * Mixes the own properties from the supplier onto the
+     * receiver.
+     * @param {Object} receiver The object to receive the properties.
+     * @param {Object} supplier The object to supply the properties.
+     * @return {Object} The receiver that was passed in.
+     * @method mix
+     * @static
+     */
+    mix: function(receiver, supplier){
+    
+        for (var prop in supplier){
+            if (supplier.hasOwnProperty(prop)){
+                receiver[prop] = supplier[prop];
+            }
+        }
+        
+        return receiver;    
+    },
+    
+    /**
+     * Stub for JSON functionality. When the native JSON utility
+     * is available, it will be used. Otherwise, a stub object
+     * is created. Developers should override YUITest.Util.JSON
+     * when attempting to use it in environments where a native
+     * JSON utility is unavailable.
+     * @property JSON
+     * @type JSON
+     * @static
+     */
+    JSON: typeof JSON != "undefined" ? JSON : {
+        stringify: function(){
+            //TODO: Should include code to do this?
+            throw new Error("No JSON utility specified.");
+        }    
+    }
+
+};
+    
+
+
+/**
+ * Object containing object helper methods.
+ * @namespace YUITest
+ * @class Object
+ * @static
+ */
+YUITest.Object = {
+    /**
+     * Property names that IE doesn't enumerate in for..in loops, even when they
+     * should be enumerable. When `_hasEnumBug` is `true`, it's necessary to
+     * manually enumerate these properties.
+     *
+     * @property _forceEnum
+     * @type String[]
+     * @protected
+     * @static
+     */
+    _forceEnum : [
+        'hasOwnProperty',
+        'isPrototypeOf',
+        'propertyIsEnumerable',
+        'toString',
+        'toLocaleString',
+        'valueOf'
+    ],
+    
+    /**
+     * `true` if this browser has the JScript enumeration bug that prevents
+     * enumeration of the properties named in the `_forceEnum` array, `false`
+     * otherwise.
+     *
+     * See:
+     *   - <https://developer.mozilla.org/en/ECMAScript_DontEnum_attribute#JScript_DontEnum_Bug>
+     *   - <http://whattheheadsaid.com/2010/10/a-safer-object-keys-compatibility-implementation>
+     *
+     * @property _hasEnumBug
+     * @type {Boolean}
+     * @protected
+     * @static
+     */
+    _hasEnumBug : !{valueOf: 0}.propertyIsEnumerable('valueOf'),
+    
+    /**
+    * Determines whether or not the provided item is of type object
+    * or function. Note that arrays are also objects, so
+    * <code>YUITest.Object.isObject([]) === true</code>.
+    * @method isObject
+    * @static
+    * @param o The object to test.
+    * @param failfn {boolean} fail if the input is a function.
+    * @return {boolean} true if o is an object.
+    */
+    _isObject : function(o, failfn) {
+        var t = typeof o;
+        return (o && (t === 'object' || (!failfn && (t === 'function' || typeof t === 'function')))) || false;
+    },
+    
+    /**
+     * Returns an array containing the object's enumerable keys. Does not include
+     * prototype keys or non-enumerable keys.
+     *
+     * Note that keys are returned in enumeration order (that is, in the same order
+     * that they would be enumerated by a `for-in` loop), which may not be the same
+     * as the order in which they were defined.
+     *
+     * This method is an alias for the native ES5 `Object.keys()` method if
+     * available.
+     *
+     * @example
+     *
+     *     Y.Object.keys({a: 'foo', b: 'bar', c: 'baz'});
+     *     // => ['a', 'b', 'c']
+     *
+     * @method keys
+     * @param {Object} obj An object.
+     * @return {String[]} Array of keys.
+     * @static
+     */
+    keys : Object.keys || function (obj) {
+        if (!YUITest.Object.isObject(obj)) {
+            throw new TypeError('Object.keys called on a non-object');
+        }
+
+        var keys = [],
+            i, key, len;
+
+        for (key in obj) {
+            if (owns(obj, key)) {
+                keys.push(key);
+            }
+        }
+
+        if (YUITest.Object._hasEnumBug) {
+            for (i = 0, len = YUITest.Object._forceEnum.length; i < len; ++i) {
+                key = YUITest.Object._forceEnum[i];
+
+                if (owns(obj, key)) {
+                    keys.push(key);
+                }
+            }
+        }
+
+        return keys;
+    }
+};
+
+/**
+ * Error is thrown whenever an assertion fails. It provides methods
+ * to more easily get at error information and also provides a base class
+ * from which more specific assertion errors can be derived.
+ *
+ * @param {String} message The message to display when the error occurs.
+ * @namespace YUITest
+ * @class AssertionError
+ * @constructor
+ */ 
+YUITest.AssertionError = function (message){
+    
+    /**
+     * Error message. Must be duplicated to ensure browser receives it.
+     * @type String
+     * @property message
+     */
+    this.message = message;
+    
+    /**
+     * The name of the error that occurred.
+     * @type String
+     * @property name
+     */
+    this.name = "Assert Error";
+};
+
+YUITest.AssertionError.prototype = {
+
+    //restore constructor
+    constructor: YUITest.AssertionError,
+
+    /**
+     * Returns a fully formatted error for an assertion failure. This should
+     * be overridden by all subclasses to provide specific information.
+     * @method getMessage
+     * @return {String} A string describing the error.
+     */
+    getMessage : function () {
+        return this.message;
+    },
+    
+    /**
+     * Returns a string representation of the error.
+     * @method toString
+     * @return {String} A string representation of the error.
+     */
+    toString : function () {
+        return this.name + ": " + this.getMessage();
+    }
+
+};
+
+/**
+ * ComparisonFailure is subclass of Error that is thrown whenever
+ * a comparison between two values fails. It provides mechanisms to retrieve
+ * both the expected and actual value.
+ *
+ * @param {String} message The message to display when the error occurs.
+ * @param {Object} expected The expected value.
+ * @param {Object} actual The actual value that caused the assertion to fail.
+ * @namespace YUITest 
+ * @extends AssertionError
+ * @class ComparisonFailure
+ * @constructor
+ */ 
+YUITest.ComparisonFailure = function (message, expected, actual){
+
+    //call superclass
+    YUITest.AssertionError.call(this, message);
+    
+    /**
+     * The expected value.
+     * @type Object
+     * @property expected
+     */
+    this.expected = expected;
+    
+    /**
+     * The actual value.
+     * @type Object
+     * @property actual
+     */
+    this.actual = actual;
+    
+    /**
+     * The name of the error that occurred.
+     * @type String
+     * @property name
+     */
+    this.name = "ComparisonFailure";
+    
+};
+
+//inherit from YUITest.AssertionError
+YUITest.ComparisonFailure.prototype = new YUITest.AssertionError;
+
+//restore constructor
+YUITest.ComparisonFailure.prototype.constructor = YUITest.ComparisonFailure;
+
+/**
+ * Returns a fully formatted error for an assertion failure. This message
+ * provides information about the expected and actual values.
+ * @method getMessage
+ * @return {String} A string describing the error.
+ */
+YUITest.ComparisonFailure.prototype.getMessage = function(){
+    return this.message + "\nExpected: " + this.expected + " (" + (typeof this.expected) + ")"  +
+            "\nActual: " + this.actual + " (" + (typeof this.actual) + ")";
+};
+
+/**
+ * ShouldError is subclass of Error that is thrown whenever
+ * a test is expected to throw an error but doesn't.
+ *
+ * @param {String} message The message to display when the error occurs.
+ * @namespace YUITest 
+ * @extends AssertionError
+ * @class ShouldError
+ * @constructor
+ */ 
+YUITest.ShouldError = function (message){
+
+    //call superclass
+    YUITest.AssertionError.call(this, message || "This test should have thrown an error but didn't.");
+    
+    /**
+     * The name of the error that occurred.
+     * @type String
+     * @property name
+     */
+    this.name = "ShouldError";
+    
+};
+
+//inherit from YUITest.AssertionError
+YUITest.ShouldError.prototype = new YUITest.AssertionError();
+
+//restore constructor
+YUITest.ShouldError.prototype.constructor = YUITest.ShouldError;
+
+/**
+ * ShouldFail is subclass of AssertionError that is thrown whenever
+ * a test was expected to fail but did not.
+ *
+ * @param {String} message The message to display when the error occurs.
+ * @namespace YUITest 
+ * @extends YUITest.AssertionError
+ * @class ShouldFail
+ * @constructor
+ */ 
+YUITest.ShouldFail = function (message){
+
+    //call superclass
+    YUITest.AssertionError.call(this, message || "This test should fail but didn't.");
+    
+    /**
+     * The name of the error that occurred.
+     * @type String
+     * @property name
+     */
+    this.name = "ShouldFail";
+    
+};
+
+//inherit from YUITest.AssertionError
+YUITest.ShouldFail.prototype = new YUITest.AssertionError();
+
+//restore constructor
+YUITest.ShouldFail.prototype.constructor = YUITest.ShouldFail;
+
+/**
+ * UnexpectedError is subclass of AssertionError that is thrown whenever
+ * an error occurs within the course of a test and the test was not expected
+ * to throw an error.
+ *
+ * @param {Error} cause The unexpected error that caused this error to be 
+ *                      thrown.
+ * @namespace YUITest 
+ * @extends YUITest.AssertionError
+ * @class UnexpectedError
+ * @constructor
+ */  
+YUITest.UnexpectedError = function (cause){
+
+    //call superclass
+    YUITest.AssertionError.call(this, "Unexpected error: " + cause.message);
+    
+    /**
+     * The unexpected error that occurred.
+     * @type Error
+     * @property cause
+     */
+    this.cause = cause;
+    
+    /**
+     * The name of the error that occurred.
+     * @type String
+     * @property name
+     */
+    this.name = "UnexpectedError";
+    
+    /**
+     * Stack information for the error (if provided).
+     * @type String
+     * @property stack
+     */
+    this.stack = cause.stack;
+    
+};
+
+//inherit from YUITest.AssertionError
+YUITest.UnexpectedError.prototype = new YUITest.AssertionError();
+
+//restore constructor
+YUITest.UnexpectedError.prototype.constructor = YUITest.UnexpectedError;
+
+/**
+ * UnexpectedValue is subclass of Error that is thrown whenever
+ * a value was unexpected in its scope. This typically means that a test
+ * was performed to determine that a value was *not* equal to a certain
+ * value.
+ *
+ * @param {String} message The message to display when the error occurs.
+ * @param {Object} unexpected The unexpected value.
+ * @namespace YUITest 
+ * @extends AssertionError
+ * @class UnexpectedValue
+ * @constructor
+ */ 
+YUITest.UnexpectedValue = function (message, unexpected){
+
+    //call superclass
+    YUITest.AssertionError.call(this, message);
+    
+    /**
+     * The unexpected value.
+     * @type Object
+     * @property unexpected
+     */
+    this.unexpected = unexpected;
+    
+    /**
+     * The name of the error that occurred.
+     * @type String
+     * @property name
+     */
+    this.name = "UnexpectedValue";
+    
+};
+
+//inherit from YUITest.AssertionError
+YUITest.UnexpectedValue.prototype = new YUITest.AssertionError();
+
+//restore constructor
+YUITest.UnexpectedValue.prototype.constructor = YUITest.UnexpectedValue;
+
+/**
+ * Returns a fully formatted error for an assertion failure. This message
+ * provides information about the expected and actual values.
+ * @method getMessage
+ * @return {String} A string describing the error.
+ */
+YUITest.UnexpectedValue.prototype.getMessage = function(){
+    return this.message + "\nUnexpected: " + this.unexpected + " (" + (typeof this.unexpected) + ") ";
+};
+
+
+/**
+ * Represents a stoppage in test execution to wait for an amount of time before
+ * continuing.
+ * @param {Function} segment A function to run when the wait is over.
+ * @param {int} delay The number of milliseconds to wait before running the code.
+ * @class Wait
+ * @namespace Test
+ * @constructor
+ *
+ */
+YUITest.Wait = function (segment, delay) {
+    
+    /**
+     * The segment of code to run when the wait is over.
+     * @type Function
+     * @property segment
+     */
+    this.segment = (typeof segment == "function" ? segment : null);
+
+    /**
+     * The delay before running the segment of code.
+     * @type int
+     * @property delay
+     */
+    this.delay = (typeof delay == "number" ? delay : 0);        
+};
+
+  
+/**
+ * The Assert object provides functions to test JavaScript values against
+ * known and expected results. Whenever a comparison (assertion) fails,
+ * an error is thrown.
+ * @namespace YUITest
+ * @class Assert
+ * @static
+ */
+YUITest.Assert = {
+
+    /**
+     * The number of assertions performed.
+     * @property _asserts
+     * @type int
+     * @private
+     */
+    _asserts: 0,
+
+    //-------------------------------------------------------------------------
+    // Helper Methods
+    //-------------------------------------------------------------------------
+    
+    /**
+     * Formats a message so that it can contain the original assertion message
+     * in addition to the custom message.
+     * @param {String} customMessage The message passed in by the developer.
+     * @param {String} defaultMessage The message created by the error by default.
+     * @return {String} The final error message, containing either or both.
+     * @protected
+     * @static
+     * @method _formatMessage
+     */
+    _formatMessage : function (customMessage, defaultMessage) {
+        if (typeof customMessage == "string" && customMessage.length > 0){
+            return customMessage.replace("{message}", defaultMessage);
+        } else {
+            return defaultMessage;
+        }        
+    },
+    
+    /**
+     * Returns the number of assertions that have been performed.
+     * @method _getCount
+     * @protected
+     * @static
+     */
+    _getCount: function(){
+        return this._asserts;
+    },
+    
+    /**
+     * Increments the number of assertions that have been performed.
+     * @method _increment
+     * @protected
+     * @static
+     */
+    _increment: function(){
+        this._asserts++;
+    },
+    
+    /**
+     * Resets the number of assertions that have been performed to 0.
+     * @method _reset
+     * @protected
+     * @static
+     */
+    _reset: function(){
+        this._asserts = 0;
+    },
+    
+    //-------------------------------------------------------------------------
+    // Generic Assertion Methods
+    //-------------------------------------------------------------------------
+    
+    /** 
+     * Forces an assertion error to occur.
+     * @param {String} message (Optional) The message to display with the failure.
+     * @method fail
+     * @static
+     */
+    fail : function (message) {
+        throw new YUITest.AssertionError(YUITest.Assert._formatMessage(message, "Test force-failed."));
+    },       
+    
+    //-------------------------------------------------------------------------
+    // Equality Assertion Methods
+    //-------------------------------------------------------------------------    
+    
+    /**
+     * Asserts that a value is equal to another. This uses the double equals sign
+     * so type cohersion may occur.
+     * @param {Object} expected The expected value.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method areEqual
+     * @static
+     */
+    areEqual : function (expected, actual, message) {
+        YUITest.Assert._increment();
+        if (expected != actual) {
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Values should be equal."), expected, actual);
+        }
+    },
+    
+    /**
+     * Asserts that a value is not equal to another. This uses the double equals sign
+     * so type cohersion may occur.
+     * @param {Object} unexpected The unexpected value.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method areNotEqual
+     * @static
+     */
+    areNotEqual : function (unexpected, actual, 
+                         message) {
+        YUITest.Assert._increment();
+        if (unexpected == actual) {
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Values should not be equal."), unexpected);
+        }
+    },
+    
+    /**
+     * Asserts that a value is not the same as another. This uses the triple equals sign
+     * so no type cohersion may occur.
+     * @param {Object} unexpected The unexpected value.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method areNotSame
+     * @static
+     */
+    areNotSame : function (unexpected, actual, message) {
+        YUITest.Assert._increment();
+        if (unexpected === actual) {
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Values should not be the same."), unexpected);
+        }
+    },
+
+    /**
+     * Asserts that a value is the same as another. This uses the triple equals sign
+     * so no type cohersion may occur.
+     * @param {Object} expected The expected value.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method areSame
+     * @static
+     */
+    areSame : function (expected, actual, message) {
+        YUITest.Assert._increment();
+        if (expected !== actual) {
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Values should be the same."), expected, actual);
+        }
+    },    
+    
+    //-------------------------------------------------------------------------
+    // Boolean Assertion Methods
+    //-------------------------------------------------------------------------    
+    
+    /**
+     * Asserts that a value is false. This uses the triple equals sign
+     * so no type cohersion may occur.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isFalse
+     * @static
+     */
+    isFalse : function (actual, message) {
+        YUITest.Assert._increment();
+        if (false !== actual) {
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Value should be false."), false, actual);
+        }
+    },
+    
+    /**
+     * Asserts that a value is true. This uses the triple equals sign
+     * so no type cohersion may occur.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isTrue
+     * @static
+     */
+    isTrue : function (actual, message) {
+        YUITest.Assert._increment();
+        if (true !== actual) {
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Value should be true."), true, actual);
+        }
+
+    },
+    
+    //-------------------------------------------------------------------------
+    // Special Value Assertion Methods
+    //-------------------------------------------------------------------------    
+    
+    /**
+     * Asserts that a value is not a number.
+     * @param {Object} actual The value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isNaN
+     * @static
+     */
+    isNaN : function (actual, message){
+        YUITest.Assert._increment();
+        if (!isNaN(actual)){
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Value should be NaN."), NaN, actual);
+        }    
+    },
+    
+    /**
+     * Asserts that a value is not the special NaN value.
+     * @param {Object} actual The value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isNotNaN
+     * @static
+     */
+    isNotNaN : function (actual, message){
+        YUITest.Assert._increment();
+        if (isNaN(actual)){
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Values should not be NaN."), NaN);
+        }    
+    },
+    
+    /**
+     * Asserts that a value is not null. This uses the triple equals sign
+     * so no type cohersion may occur.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isNotNull
+     * @static
+     */
+    isNotNull : function (actual, message) {
+        YUITest.Assert._increment();
+        if (actual === null) {
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Values should not be null."), null);
+        }
+    },
+
+    /**
+     * Asserts that a value is not undefined. This uses the triple equals sign
+     * so no type cohersion may occur.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isNotUndefined
+     * @static
+     */
+    isNotUndefined : function (actual, message) {
+        YUITest.Assert._increment();
+        if (typeof actual == "undefined") {
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Value should not be undefined."), undefined);
+        }
+    },
+
+    /**
+     * Asserts that a value is null. This uses the triple equals sign
+     * so no type cohersion may occur.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isNull
+     * @static
+     */
+    isNull : function (actual, message) {
+        YUITest.Assert._increment();
+        if (actual !== null) {
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Value should be null."), null, actual);
+        }
+    },
+        
+    /**
+     * Asserts that a value is undefined. This uses the triple equals sign
+     * so no type cohersion may occur.
+     * @param {Object} actual The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isUndefined
+     * @static
+     */
+    isUndefined : function (actual, message) {
+        YUITest.Assert._increment();
+        if (typeof actual != "undefined") {
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Value should be undefined."), undefined, actual);
+        }
+    },    
+    
+    //--------------------------------------------------------------------------
+    // Instance Assertion Methods
+    //--------------------------------------------------------------------------    
+   
+    /**
+     * Asserts that a value is an array.
+     * @param {Object} actual The value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isArray
+     * @static
+     */
+    isArray : function (actual, message) {
+        YUITest.Assert._increment();
+        var shouldFail = false;
+        if (Array.isArray){
+            shouldFail = !Array.isArray(actual);
+        } else {
+            shouldFail = Object.prototype.toString.call(actual) != "[object Array]";
+        }
+        if (shouldFail){
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Value should be an array."), actual);
+        }    
+    },
+   
+    /**
+     * Asserts that a value is a Boolean.
+     * @param {Object} actual The value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isBoolean
+     * @static
+     */
+    isBoolean : function (actual, message) {
+        YUITest.Assert._increment();
+        if (typeof actual != "boolean"){
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Value should be a Boolean."), actual);
+        }    
+    },
+   
+    /**
+     * Asserts that a value is a function.
+     * @param {Object} actual The value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isFunction
+     * @static
+     */
+    isFunction : function (actual, message) {
+        YUITest.Assert._increment();
+        if (!(actual instanceof Function)){
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Value should be a function."), actual);
+        }    
+    },
+   
+    /**
+     * Asserts that a value is an instance of a particular object. This may return
+     * incorrect results when comparing objects from one frame to constructors in
+     * another frame. For best results, don't use in a cross-frame manner.
+     * @param {Function} expected The function that the object should be an instance of.
+     * @param {Object} actual The object to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isInstanceOf
+     * @static
+     */
+    isInstanceOf : function (expected, actual, message) {
+        YUITest.Assert._increment();
+        if (!(actual instanceof expected)){
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Value isn't an instance of expected type."), expected, actual);
+        }
+    },
+    
+    /**
+     * Asserts that a value is a number.
+     * @param {Object} actual The value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isNumber
+     * @static
+     */
+    isNumber : function (actual, message) {
+        YUITest.Assert._increment();
+        if (typeof actual != "number"){
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Value should be a number."), actual);
+        }    
+    },    
+    
+    /**
+     * Asserts that a value is an object.
+     * @param {Object} actual The value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isObject
+     * @static
+     */
+    isObject : function (actual, message) {
+        YUITest.Assert._increment();
+        if (!actual || (typeof actual != "object" && typeof actual != "function")){
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Value should be an object."), actual);
+        }
+    },
+    
+    /**
+     * Asserts that a value is a string.
+     * @param {Object} actual The value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isString
+     * @static
+     */
+    isString : function (actual, message) {
+        YUITest.Assert._increment();
+        if (typeof actual != "string"){
+            throw new YUITest.UnexpectedValue(YUITest.Assert._formatMessage(message, "Value should be a string."), actual);
+        }
+    },
+    
+    /**
+     * Asserts that a value is of a particular type. 
+     * @param {String} expectedType The expected type of the variable.
+     * @param {Object} actualValue The actual value to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isTypeOf
+     * @static
+     */
+    isTypeOf : function (expectedType, actualValue, message){
+        YUITest.Assert._increment();
+        if (typeof actualValue != expectedType){
+            throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Value should be of type " + expectedType + "."), expectedType, typeof actualValue);
+        }
+    },
+    
+    //--------------------------------------------------------------------------
+    // Error Detection Methods
+    //--------------------------------------------------------------------------    
+   
+    /**
+     * Asserts that executing a particular method should throw an error of
+     * a specific type. This is a replacement for _should.error.
+     * @param {String|Function|Object} expectedError If a string, this
+     *      is the error message that the error must have; if a function, this
+     *      is the constructor that should have been used to create the thrown
+     *      error; if an object, this is an instance of a particular error type
+     *      with a specific error message (both must match).
+     * @param {Function} method The method to execute that should throw the error.
+     * @param {String} message (Optional) The message to display if the assertion
+     *      fails.
+     * @method throwsError
+     * @return {void}
+     * @static
+     */
+    throwsError: function(expectedError, method, message){
+        YUITest.Assert._increment();
+        var error = false;
+    
+        try {
+            method();        
+        } catch (thrown) {
+            
+            //check to see what type of data we have
+            if (typeof expectedError == "string"){
+                
+                //if it's a string, check the error message
+                if (thrown.message != expectedError){
+                    error = true;
+                }
+            } else if (typeof expectedError == "function"){
+            
+                //if it's a function, see if the error is an instance of it
+                if (!(thrown instanceof expectedError)){
+                    error = true;
+                }
+            
+            } else if (typeof expectedError == "object" && expectedError !== null){
+            
+                //if it's an object, check the instance and message
+                if (!(thrown instanceof expectedError.constructor) || 
+                        thrown.message != expectedError.message){
+                    error = true;
+                }
+            
+            } else { //if it gets here, the argument could be wrong
+                error = true;
+            }
+            
+            if (error){
+                throw new YUITest.UnexpectedError(thrown);                    
+            } else {
+                return;
+            }
+        }
+        
+        //if it reaches here, the error wasn't thrown, which is a bad thing
+        throw new YUITest.AssertionError(YUITest.Assert._formatMessage(message, "Error should have been thrown."));
+    }
+
+};
+
+
+/**
+ * The ArrayAssert object provides functions to test JavaScript array objects
+ * for a variety of cases.
+ * @namespace YUITest
+ * @class ArrayAssert
+ * @static
+ */
+ 
+YUITest.ArrayAssert = {
+
+    //=========================================================================
+    // Private methods
+    //=========================================================================
+    
+    /**
+     * Simple indexOf() implementation for an array. Defers to native
+     * if available.
+     * @param {Array} haystack The array to search.
+     * @param {Variant} needle The value to locate.
+     * @return {int} The index of the needle if found or -1 if not.
+     * @method _indexOf
+     * @private
+     */
+    _indexOf: function(haystack, needle){
+        if (haystack.indexOf){
+            return haystack.indexOf(needle);
+        } else {
+            for (var i=0; i < haystack.length; i++){
+                if (haystack[i] === needle){
+                    return i;
+                }
+            }
+            return -1;
+        }
+    },
+    
+    /**
+     * Simple some() implementation for an array. Defers to native
+     * if available.
+     * @param {Array} haystack The array to search.
+     * @param {Function} matcher The function to run on each value.
+     * @return {Boolean} True if any value, when run through the matcher,
+     *      returns true.
+     * @method _some
+     * @private
+     */
+    _some: function(haystack, matcher){
+        if (haystack.some){
+            return haystack.some(matcher);
+        } else {
+            for (var i=0; i < haystack.length; i++){
+                if (matcher(haystack[i])){
+                    return true;
+                }
+            }
+            return false;
+        }
+    },    
+
+    /**
+     * Asserts that a value is present in an array. This uses the triple equals 
+     * sign so no type cohersion may occur.
+     * @param {Object} needle The value that is expected in the array.
+     * @param {Array} haystack An array of values.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method contains
+     * @static
+     */
+    contains : function (needle, haystack, 
+                           message) {
+        
+        YUITest.Assert._increment();               
+
+        if (this._indexOf(haystack, needle) == -1){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value " + needle + " (" + (typeof needle) + ") not found in array [" + haystack + "]."));
+        }
+    },
+
+    /**
+     * Asserts that a set of values are present in an array. This uses the triple equals 
+     * sign so no type cohersion may occur. For this assertion to pass, all values must
+     * be found.
+     * @param {Object[]} needles An array of values that are expected in the array.
+     * @param {Array} haystack An array of values to check.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method containsItems
+     * @static
+     */
+    containsItems : function (needles, haystack, 
+                           message) {
+        YUITest.Assert._increment();               
+
+        //begin checking values
+        for (var i=0; i < needles.length; i++){
+            if (this._indexOf(haystack, needles[i]) == -1){
+                YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value " + needles[i] + " (" + (typeof needles[i]) + ") not found in array [" + haystack + "]."));
+            }
+        }
+    },
+
+    /**
+     * Asserts that a value matching some condition is present in an array. This uses
+     * a function to determine a match.
+     * @param {Function} matcher A function that returns true if the items matches or false if not.
+     * @param {Array} haystack An array of values.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method containsMatch
+     * @static
+     */
+    containsMatch : function (matcher, haystack, 
+                           message) {
+        
+        YUITest.Assert._increment();               
+        //check for valid matcher
+        if (typeof matcher != "function"){
+            throw new TypeError("ArrayAssert.containsMatch(): First argument must be a function.");
+        }
+        
+        if (!this._some(haystack, matcher)){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "No match found in array [" + haystack + "]."));
+        }
+    },
+
+    /**
+     * Asserts that a value is not present in an array. This uses the triple equals 
+     * Asserts that a value is not present in an array. This uses the triple equals 
+     * sign so no type cohersion may occur.
+     * @param {Object} needle The value that is expected in the array.
+     * @param {Array} haystack An array of values.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method doesNotContain
+     * @static
+     */
+    doesNotContain : function (needle, haystack, 
+                           message) {
+        
+        YUITest.Assert._increment();               
+
+        if (this._indexOf(haystack, needle) > -1){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value found in array [" + haystack + "]."));
+        }
+    },
+
+    /**
+     * Asserts that a set of values are not present in an array. This uses the triple equals 
+     * sign so no type cohersion may occur. For this assertion to pass, all values must
+     * not be found.
+     * @param {Object[]} needles An array of values that are not expected in the array.
+     * @param {Array} haystack An array of values to check.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method doesNotContainItems
+     * @static
+     */
+    doesNotContainItems : function (needles, haystack, 
+                           message) {
+
+        YUITest.Assert._increment();               
+
+        for (var i=0; i < needles.length; i++){
+            if (this._indexOf(haystack, needles[i]) > -1){
+                YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value found in array [" + haystack + "]."));
+            }
+        }
+
+    },
+        
+    /**
+     * Asserts that no values matching a condition are present in an array. This uses
+     * a function to determine a match.
+     * @param {Function} matcher A function that returns true if the item matches or false if not.
+     * @param {Array} haystack An array of values.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method doesNotContainMatch
+     * @static
+     */
+    doesNotContainMatch : function (matcher, haystack, 
+                           message) {
+        
+        YUITest.Assert._increment();     
+      
+        //check for valid matcher
+        if (typeof matcher != "function"){
+            throw new TypeError("ArrayAssert.doesNotContainMatch(): First argument must be a function.");
+        }
+        
+        if (this._some(haystack, matcher)){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value found in array [" + haystack + "]."));
+        }
+    },
+        
+    /**
+     * Asserts that the given value is contained in an array at the specified index.
+     * This uses the triple equals sign so no type cohersion will occur.
+     * @param {Object} needle The value to look for.
+     * @param {Array} haystack The array to search in.
+     * @param {int} index The index at which the value should exist.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method indexOf
+     * @static
+     */
+    indexOf : function (needle, haystack, index, message) {
+    
+        YUITest.Assert._increment();     
+
+        //try to find the value in the array
+        for (var i=0; i < haystack.length; i++){
+            if (haystack[i] === needle){
+                if (index != i){
+                    YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value exists at index " + i + " but should be at index " + index + "."));                    
+                }
+                return;
+            }
+        }
+        
+        //if it makes it here, it wasn't found at all
+        YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value doesn't exist in array [" + haystack + "]."));
+    },
+        
+    /**
+     * Asserts that the values in an array are equal, and in the same position,
+     * as values in another array. This uses the double equals sign
+     * so type cohersion may occur. Note that the array objects themselves
+     * need not be the same for this test to pass.
+     * @param {Array} expected An array of the expected values.
+     * @param {Array} actual Any array of the actual values.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method itemsAreEqual
+     * @static
+     */
+    itemsAreEqual : function (expected, actual, 
+                           message) {
+        
+        YUITest.Assert._increment();     
+        
+        //first check array length
+        if (expected.length != actual.length){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Array should have a length of " + expected.length + " but has a length of " + actual.length));
+        }
+       
+        //begin checking values
+        for (var i=0; i < expected.length; i++){
+            if (expected[i] != actual[i]){
+                throw new YUITest.Assert.ComparisonFailure(YUITest.Assert._formatMessage(message, "Values in position " + i + " are not equal."), expected[i], actual[i]);
+            }
+        }
+    },
+    
+    /**
+     * Asserts that the values in an array are equivalent, and in the same position,
+     * as values in another array. This uses a function to determine if the values
+     * are equivalent. Note that the array objects themselves
+     * need not be the same for this test to pass.
+     * @param {Array} expected An array of the expected values.
+     * @param {Array} actual Any array of the actual values.
+     * @param {Function} comparator A function that returns true if the values are equivalent
+     *      or false if not.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @return {Void}
+     * @method itemsAreEquivalent
+     * @static
+     */
+    itemsAreEquivalent : function (expected, actual, 
+                           comparator, message) {
+        
+        YUITest.Assert._increment();     
+
+        //make sure the comparator is valid
+        if (typeof comparator != "function"){
+            throw new TypeError("ArrayAssert.itemsAreEquivalent(): Third argument must be a function.");
+        }
+        
+        //first check array length
+        if (expected.length != actual.length){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Array should have a length of " + expected.length + " but has a length of " + actual.length));
+        }
+        
+        //begin checking values
+        for (var i=0; i < expected.length; i++){
+            if (!comparator(expected[i], actual[i])){
+                throw new YUITest.Assert.ComparisonFailure(YUITest.Assert._formatMessage(message, "Values in position " + i + " are not equivalent."), expected[i], actual[i]);
+            }
+        }
+    },
+    
+    /**
+     * Asserts that an array is empty.
+     * @param {Array} actual The array to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isEmpty
+     * @static
+     */
+    isEmpty : function (actual, message) {        
+        YUITest.Assert._increment();     
+        if (actual.length > 0){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Array should be empty."));
+        }
+    },    
+    
+    /**
+     * Asserts that an array is not empty.
+     * @param {Array} actual The array to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method isNotEmpty
+     * @static
+     */
+    isNotEmpty : function (actual, message) {        
+        YUITest.Assert._increment();     
+        if (actual.length === 0){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Array should not be empty."));
+        }
+    },    
+    
+    /**
+     * Asserts that the values in an array are the same, and in the same position,
+     * as values in another array. This uses the triple equals sign
+     * so no type cohersion will occur. Note that the array objects themselves
+     * need not be the same for this test to pass.
+     * @param {Array} expected An array of the expected values.
+     * @param {Array} actual Any array of the actual values.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method itemsAreSame
+     * @static
+     */
+    itemsAreSame : function (expected, actual, 
+                          message) {
+        
+        YUITest.Assert._increment();     
+
+        //first check array length
+        if (expected.length != actual.length){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Array should have a length of " + expected.length + " but has a length of " + actual.length));
+        }
+                    
+        //begin checking values
+        for (var i=0; i < expected.length; i++){
+            if (expected[i] !== actual[i]){
+                throw new YUITest.Assert.ComparisonFailure(YUITest.Assert._formatMessage(message, "Values in position " + i + " are not the same."), expected[i], actual[i]);
+            }
+        }
+    },
+    
+    /**
+     * Asserts that the given value is contained in an array at the specified index,
+     * starting from the back of the array.
+     * This uses the triple equals sign so no type cohersion will occur.
+     * @param {Object} needle The value to look for.
+     * @param {Array} haystack The array to search in.
+     * @param {int} index The index at which the value should exist.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method lastIndexOf
+     * @static
+     */
+    lastIndexOf : function (needle, haystack, index, message) {
+    
+        //try to find the value in the array
+        for (var i=haystack.length; i >= 0; i--){
+            if (haystack[i] === needle){
+                if (index != i){
+                    YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value exists at index " + i + " but should be at index " + index + "."));                    
+                }
+                return;
+            }
+        }
+        
+        //if it makes it here, it wasn't found at all
+        YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Value doesn't exist in array."));        
+    }
+    
+};
+
+
+/**
+ * The ObjectAssert object provides functions to test JavaScript objects
+ * for a variety of cases.
+ * @namespace YUITest
+ * @class ObjectAssert
+ * @static
+ */
+YUITest.ObjectAssert = {
+
+    /**
+     * Asserts that an object has all of the same properties
+     * and property values as the other.
+     * @param {Object} expected The object with all expected properties and values.
+     * @param {Object} actual The object to inspect.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method areEqual
+     * @static
+     * @deprecated
+     */
+    areEqual: function(expected, actual, message) {
+        YUITest.Assert._increment();         
+        
+        var expectedKeys = YUITest.Object.keys(expected),
+            actualKeys = YUITest.Object.keys(actual);
+        
+        //first check keys array length
+        if (expectedKeys.length != actualKeys.length){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Object should have " + expectedKeys.length + " keys but has " + actualKeys.length));
+        }
+        
+        //then check values
+        for (var name in expected){
+            if (expected.hasOwnProperty(name)){
+                if (expected[name] != actual[name]){
+                    throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, "Values should be equal for property " + name), expected[name], actual[name]);
+                }            
+            }
+        }           
+    },
+    
+    /**
+     * Asserts that an object has a property with the given name.
+     * @param {String} propertyName The name of the property to test.
+     * @param {Object} object The object to search.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method hasKey
+     * @static
+     * @deprecated Use ownsOrInheritsKey() instead
+     */    
+    hasKey: function (propertyName, object, message) {
+        YUITest.ObjectAssert.ownsOrInheritsKey(propertyName, object, message);   
+    },
+    
+    /**
+     * Asserts that an object has all properties of a reference object.
+     * @param {Array} properties An array of property names that should be on the object.
+     * @param {Object} object The object to search.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method hasKeys
+     * @static
+     * @deprecated Use ownsOrInheritsKeys() instead
+     */    
+    hasKeys: function (properties, object, message) {
+        YUITest.ObjectAssert.ownsOrInheritsKeys(properties, objects, message);
+    },
+    
+    /**
+     * Asserts that a property with the given name exists on an object's prototype.
+     * @param {String} propertyName The name of the property to test.
+     * @param {Object} object The object to search.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method inheritsKey
+     * @static
+     */    
+    inheritsKey: function (propertyName, object, message) {
+        YUITest.Assert._increment();               
+        if (!(propertyName in object && !object.hasOwnProperty(propertyName))){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Property '" + propertyName + "' not found on object instance."));
+        }     
+    },
+    
+    /**
+     * Asserts that all properties exist on an object prototype.
+     * @param {Array} properties An array of property names that should be on the object.
+     * @param {Object} object The object to search.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method inheritsKeys
+     * @static
+     */    
+    inheritsKeys: function (properties, object, message) {
+        YUITest.Assert._increment();        
+        for (var i=0; i < properties.length; i++){
+            if (!(propertyName in object && !object.hasOwnProperty(properties[i]))){
+                YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Property '" + properties[i] + "' not found on object instance."));
+            }      
+        }
+    },
+    
+    /**
+     * Asserts that a property with the given name exists on an object instance (not on its prototype).
+     * @param {String} propertyName The name of the property to test.
+     * @param {Object} object The object to search.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method ownsKey
+     * @static
+     */    
+    ownsKey: function (propertyName, object, message) {
+        YUITest.Assert._increment();               
+        if (!object.hasOwnProperty(propertyName)){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Property '" + propertyName + "' not found on object instance."));
+        }     
+    },
+    
+    /**
+     * Asserts that all properties exist on an object instance (not on its prototype).
+     * @param {Array} properties An array of property names that should be on the object.
+     * @param {Object} object The object to search.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method ownsKeys
+     * @static
+     */    
+    ownsKeys: function (properties, object, message) {
+        YUITest.Assert._increment();        
+        for (var i=0; i < properties.length; i++){
+            if (!object.hasOwnProperty(properties[i])){
+                YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Property '" + properties[i] + "' not found on object instance."));
+            }      
+        }
+    },
+    
+    /**
+     * Asserts that an object owns no properties.
+     * @param {Object} object The object to check.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method ownsNoKeys
+     * @static
+     */    
+    ownsNoKeys : function (object, message) {
+        YUITest.Assert._increment();  
+        var count = 0,
+            name;
+        for (name in object){
+            if (object.hasOwnProperty(name)){
+                count++;
+            }
+        }
+        
+        if (count !== 0){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Object owns " + count + " properties but should own none."));        
+        }
+
+    },
+
+    /**
+     * Asserts that an object has a property with the given name.
+     * @param {String} propertyName The name of the property to test.
+     * @param {Object} object The object to search.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method ownsOrInheritsKey
+     * @static
+     */    
+    ownsOrInheritsKey: function (propertyName, object, message) {
+        YUITest.Assert._increment();               
+        if (!(propertyName in object)){
+            YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Property '" + propertyName + "' not found on object."));
+        }    
+    },
+    
+    /**
+     * Asserts that an object has all properties of a reference object.
+     * @param {Array} properties An array of property names that should be on the object.
+     * @param {Object} object The object to search.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method ownsOrInheritsKeys
+     * @static
+     */    
+    ownsOrInheritsKeys: function (properties, object, message) {
+        YUITest.Assert._increment();  
+        for (var i=0; i < properties.length; i++){
+            if (!(properties[i] in object)){
+                YUITest.Assert.fail(YUITest.Assert._formatMessage(message, "Property '" + properties[i] + "' not found on object."));
+            }      
+        }
+    }    
+};
+
+
+
+/**
+ * The DateAssert object provides functions to test JavaScript Date objects
+ * for a variety of cases.
+ * @namespace  YUITest
+ * @class DateAssert
+ * @static
+ */
+ 
+YUITest.DateAssert = {
+
+    /**
+     * Asserts that a date's month, day, and year are equal to another date's.
+     * @param {Date} expected The expected date.
+     * @param {Date} actual The actual date to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method datesAreEqual
+     * @static
+     */
+    datesAreEqual : function (expected, actual, message){
+        YUITest.Assert._increment();        
+        if (expected instanceof Date && actual instanceof Date){
+            var msg = "";
+            
+            //check years first
+            if (expected.getFullYear() != actual.getFullYear()){
+                msg = "Years should be equal.";
+            }
+            
+            //now check months
+            if (expected.getMonth() != actual.getMonth()){
+                msg = "Months should be equal.";
+            }                
+            
+            //last, check the day of the month
+            if (expected.getDate() != actual.getDate()){
+                msg = "Days of month should be equal.";
+            }                
+            
+            if (msg.length){
+                throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, msg), expected, actual);
+            }
+        } else {
+            throw new TypeError("YUITest.DateAssert.datesAreEqual(): Expected and actual values must be Date objects.");
+        }
+    },
+
+    /**
+     * Asserts that a date's hour, minutes, and seconds are equal to another date's.
+     * @param {Date} expected The expected date.
+     * @param {Date} actual The actual date to test.
+     * @param {String} message (Optional) The message to display if the assertion fails.
+     * @method timesAreEqual
+     * @static
+     */
+    timesAreEqual : function (expected, actual, message){
+        YUITest.Assert._increment();
+        if (expected instanceof Date && actual instanceof Date){
+            var msg = "";
+            
+            //check hours first
+            if (expected.getHours() != actual.getHours()){
+                msg = "Hours should be equal.";
+            }
+            
+            //now check minutes
+            if (expected.getMinutes() != actual.getMinutes()){
+                msg = "Minutes should be equal.";
+            }                
+            
+            //last, check the seconds
+            if (expected.getSeconds() != actual.getSeconds()){
+                msg = "Seconds should be equal.";
+            }                
+            
+            if (msg.length){
+                throw new YUITest.ComparisonFailure(YUITest.Assert._formatMessage(message, msg), expected, actual);
+            }
+        } else {
+            throw new TypeError("YUITest.DateAssert.timesAreEqual(): Expected and actual values must be Date objects.");
+        }
+    }
+    
+};
+
+/**
+ * Creates a new mock object.
+ * @namespace YUITest
+ * @class Mock
+ * @constructor
+ * @param {Object} template (Optional) An object whose methods
+ *      should be stubbed out on the mock object.
+ */
+YUITest.Mock = function(template){
+
+    //use blank object is nothing is passed in
+    template = template || {};
+    
+    var mock,
+        name;
+    
+    //try to create mock that keeps prototype chain intact
+    //fails in the case of ActiveX objects
+    try {
+        function f(){}
+        f.prototype = template;
+        mock = new f();
+    } catch (ex) {
+        mock = {};
+    }
+
+    //create stubs for all methods
+    for (name in template){
+        if (template.hasOwnProperty(name)){
+            if (typeof template[name] == "function"){
+                mock[name] = function(name){
+                    return function(){
+                        YUITest.Assert.fail("Method " + name + "() was called but was not expected to be.");
+                    };
+                }(name);
+            }
+        }
+    }
+
+    //return it
+    return mock;    
+};
+    
+/**
+ * Assigns an expectation to a mock object. This is used to create
+ * methods and properties on the mock object that are monitored for
+ * calls and changes, respectively.
+ * @param {Object} mock The object to add the expectation to.
+ * @param {Object} expectation An object defining the expectation. For
+ *      a method, the keys "method" and "args" are required with
+ *      an optional "returns" key available. For properties, the keys
+ *      "property" and "value" are required.
+ * @return {void}
+ * @method expect
+ * @static
+ */ 
+YUITest.Mock.expect = function(mock /*:Object*/, expectation /*:Object*/){
+
+    //make sure there's a place to store the expectations
+    if (!mock.__expectations) {
+        mock.__expectations = {};
+    }
+
+    //method expectation
+    if (expectation.method){
+        var name = expectation.method,
+            args = expectation.args || [],
+            result = expectation.returns,
+            callCount = (typeof expectation.callCount == "number") ? expectation.callCount : 1,
+            error = expectation.error,
+            run = expectation.run || function(){},
+            i;
+            
+        //save expectations
+        mock.__expectations[name] = expectation;
+        expectation.callCount = callCount;
+        expectation.actualCallCount = 0;
+            
+        //process arguments
+        for (i=0; i < args.length; i++){
+             if (!(args[i] instanceof YUITest.Mock.Value)){
+                args[i] = YUITest.Mock.Value(YUITest.Assert.areSame, [args[i]], "Argument " + i + " of " + name + "() is incorrect.");
+            }       
+        }
+    
+        //if the method is expected to be called
+        if (callCount > 0){
+            mock[name] = function(){   
+                try {
+                    expectation.actualCallCount++;
+                    YUITest.Assert.areEqual(args.length, arguments.length, "Method " + name + "() passed incorrect number of arguments.");
+                    for (var i=0, len=args.length; i < len; i++){
+                        args[i].verify(arguments[i]);
+                    }                
+
+                    run.apply(this, arguments);
+                    
+                    if (error){
+                        throw error;
+                    }
+                } catch (ex){
+                    //route through TestRunner for proper handling
+                    YUITest.TestRunner._handleError(ex);
+                }
+                
+                return result;
+            };
+        } else {
+        
+            //method should fail if called when not expected
+            mock[name] = function(){
+                try {
+                    YUITest.Assert.fail("Method " + name + "() should not have been called.");
+                } catch (ex){
+                    //route through TestRunner for proper handling
+                    YUITest.TestRunner._handleError(ex);
+                }                    
+            };
+        }
+    } else if (expectation.property){
+        //save expectations
+        mock.__expectations[name] = expectation;
+    }
+};
+
+/**
+ * Verifies that all expectations of a mock object have been met and
+ * throws an assertion error if not.
+ * @param {Object} mock The object to verify..
+ * @return {void}
+ * @method verify
+ * @static
+ */ 
+YUITest.Mock.verify = function(mock){    
+    try {
+    
+        for (var name in mock.__expectations){
+            if (mock.__expectations.hasOwnProperty(name)){
+                var expectation = mock.__expectations[name];
+                if (expectation.method) {
+                    YUITest.Assert.areEqual(expectation.callCount, expectation.actualCallCount, "Method " + expectation.method + "() wasn't called the expected number of times.");
+                } else if (expectation.property){
+                    YUITest.Assert.areEqual(expectation.value, mock[expectation.property], "Property " + expectation.property + " wasn't set to the correct value."); 
+                }                
+            }
+        }
+
+    } catch (ex){
+        //route through TestRunner for proper handling
+        YUITest.TestRunner._handleError(ex);
+    }
+};
+
+/**
+ * Creates a new value matcher.
+ * @param {Function} method The function to call on the value.
+ * @param {Array} originalArgs (Optional) Array of arguments to pass to the method.
+ * @param {String} message (Optional) Message to display in case of failure.
+ * @namespace YUITest.Mock
+ * @class Value
+ * @constructor
+ */
+YUITest.Mock.Value = function(method, originalArgs, message){
+    if (this instanceof YUITest.Mock.Value){
+        this.verify = function(value){
+            var args = [].concat(originalArgs || []);
+            args.push(value);
+            args.push(message);
+            method.apply(null, args);
+        };
+    } else {
+        return new YUITest.Mock.Value(method, originalArgs, message);
+    }
+};
+
+/**
+ * Predefined matcher to match any value.
+ * @property Any
+ * @static
+ * @type Function
+ */
+YUITest.Mock.Value.Any        = YUITest.Mock.Value(function(){});
+
+/**
+ * Predefined matcher to match boolean values.
+ * @property Boolean
+ * @static
+ * @type Function
+ */
+YUITest.Mock.Value.Boolean    = YUITest.Mock.Value(YUITest.Assert.isBoolean);
+
+/**
+ * Predefined matcher to match number values.
+ * @property Number
+ * @static
+ * @type Function
+ */
+YUITest.Mock.Value.Number     = YUITest.Mock.Value(YUITest.Assert.isNumber);
+
+/**
+ * Predefined matcher to match string values.
+ * @property String
+ * @static
+ * @type Function
+ */
+YUITest.Mock.Value.String     = YUITest.Mock.Value(YUITest.Assert.isString);
+
+/**
+ * Predefined matcher to match object values.
+ * @property Object
+ * @static
+ * @type Function
+ */
+YUITest.Mock.Value.Object     = YUITest.Mock.Value(YUITest.Assert.isObject);
+
+/**
+ * Predefined matcher to match function values.
+ * @property Function
+ * @static
+ * @type Function
+ */
+YUITest.Mock.Value.Function   = YUITest.Mock.Value(YUITest.Assert.isFunction);
+
+/**
+ * Convenience type for storing and aggregating
+ * test result information.
+ * @private
+ * @namespace YUITest
+ * @class Results
+ * @constructor
+ * @param {String} name The name of the test.
+ */
+YUITest.Results = function(name){
+
+    /**
+     * Name of the test, test case, or test suite.
+     * @type String
+     * @property name
+     */
+    this.name = name;
+    
+    /**
+     * Number of passed tests.
+     * @type int
+     * @property passed
+     */
+    this.passed = 0;
+    
+    /**
+     * Number of failed tests.
+     * @type int
+     * @property failed
+     */
+    this.failed = 0;
+    
+    /**
+     * Number of errors that occur in non-test methods.
+     * @type int
+     * @property errors
+     */
+    this.errors = 0;
+    
+    /**
+     * Number of ignored tests.
+     * @type int
+     * @property ignored
+     */
+    this.ignored = 0;
+    
+    /**
+     * Number of total tests.
+     * @type int
+     * @property total
+     */
+    this.total = 0;
+    
+    /**
+     * Amount of time (ms) it took to complete testing.
+     * @type int
+     * @property duration
+     */
+    this.duration = 0;
+}
+
+/**
+ * Includes results from another results object into this one.
+ * @param {YUITest.Results} result The results object to include.
+ * @method include
+ * @return {void}
+ */
+YUITest.Results.prototype.include = function(results){
+    this.passed += results.passed;
+    this.failed += results.failed;
+    this.ignored += results.ignored;
+    this.total += results.total;
+    this.errors += results.errors;
+};
+
+/**
+ * Test case containing various tests to run.
+ * @param template An object containing any number of test methods, other methods,
+ *                 an optional name, and anything else the test case needs.
+ * @class TestCase
+ * @namespace YUITest
+ * @constructor
+ */
+YUITest.TestCase = function (template) {
+    
+    /**
+     * Special rules for the test case. Possible subobjects
+     * are fail, for tests that should fail, and error, for
+     * tests that should throw an error.
+     */
+    this._should = {};
+    
+    //copy over all properties from the template to this object
+    for (var prop in template) {
+        this[prop] = template[prop];
+    }    
+    
+    //check for a valid name
+    if (typeof this.name != "string"){
+        this.name = "testCase" + (+new Date());
+    }
+
+};
+        
+YUITest.TestCase.prototype = {  
+
+    //restore constructor
+    constructor: YUITest.TestCase,
+    
+    /**
+     * Method to call from an async init method to
+     * restart the test case. When called, returns a function
+     * that should be called when tests are ready to continue.
+     * @method callback
+     * @return {Function} The function to call as a callback.
+     */
+    callback: function(){
+        return YUITest.TestRunner.callback.apply(YUITest.TestRunner,arguments);
+    },
+
+    /**
+     * Resumes a paused test and runs the given function.
+     * @param {Function} segment (Optional) The function to run.
+     *      If omitted, the test automatically passes.
+     * @return {Void}
+     * @method resume
+     */
+    resume : function (segment) {
+        YUITest.TestRunner.resume(segment);
+    },
+
+    /**
+     * Causes the test case to wait a specified amount of time and then
+     * continue executing the given code.
+     * @param {Function} segment (Optional) The function to run after the delay.
+     *      If omitted, the TestRunner will wait until resume() is called.
+     * @param {int} delay (Optional) The number of milliseconds to wait before running
+     *      the function. If omitted, defaults to zero.
+     * @return {Void}
+     * @method wait
+     */
+    wait : function (segment, delay){
+        
+        var actualDelay = (typeof segment == "number" ? segment : delay);
+        actualDelay = (typeof actualDelay == "number" ? actualDelay : 10000);
+    
+		if (typeof segment == "function"){
+            throw new YUITest.Wait(segment, actualDelay);
+        } else {
+            throw new YUITest.Wait(function(){
+                YUITest.Assert.fail("Timeout: wait() called but resume() never called.");
+            }, actualDelay);
+        }
+    },
+    
+    //-------------------------------------------------------------------------
+    // Assertion Methods
+    //-------------------------------------------------------------------------
+
+    /**
+     * Asserts that a given condition is true. If not, then a YUITest.AssertionError object is thrown
+     * and the test fails.
+     * @method assert
+     * @param {Boolean} condition The condition to test.
+     * @param {String} message The message to display if the assertion fails.
+     */
+    assert : function (condition, message){
+        YUITest.Assert._increment();
+        if (!condition){
+            throw new YUITest.AssertionError(YUITest.Assert._formatMessage(message, "Assertion failed."));
+        }    
+    },
+    
+    /**
+     * Forces an assertion error to occur. Shortcut for YUITest.Assert.fail().
+     * @method fail
+     * @param {String} message (Optional) The message to display with the failure.
+     */
+    fail: function (message) {    
+        YUITest.Assert.fail(message);
+    },
+    
+    //-------------------------------------------------------------------------
+    // Stub Methods
+    //-------------------------------------------------------------------------
+
+    /**
+     * Function to run once before tests start to run.
+     * This executes before the first call to setUp().
+     */
+    init: function(){
+        //noop
+    },
+    
+    /**
+     * Function to run once after tests finish running.
+     * This executes after the last call to tearDown().
+     */
+    destroy: function(){
+        //noop
+    },
+
+    /**
+     * Function to run before each test is executed.
+     * @return {Void}
+     * @method setUp
+     */
+    setUp : function () {
+        //noop
+    },
+    
+    /**
+     * Function to run after each test is executed.
+     * @return {Void}
+     * @method tearDown
+     */
+    tearDown: function () {    
+        //noop
+    }
+};
+
+
+    
+/**
+ * A test suite that can contain a collection of TestCase and TestSuite objects.
+ * @param {String||Object} data The name of the test suite or an object containing
+ *      a name property as well as setUp and tearDown methods.
+ * @namespace YUITest
+ * @class TestSuite
+ * @constructor
+ */
+YUITest.TestSuite = function (data) {
+
+    /**
+     * The name of the test suite.
+     * @type String
+     * @property name
+     */
+    this.name = "";
+
+    /**
+     * Array of test suites and test cases.
+     * @type Array
+     * @property items
+     * @private
+     */
+    this.items = [];
+
+    //initialize the properties
+    if (typeof data == "string"){
+        this.name = data;
+    } else if (data instanceof Object){
+        for (var prop in data){
+            if (data.hasOwnProperty(prop)){
+                this[prop] = data[prop];
+            }
+        }
+    }
+
+    //double-check name
+    if (this.name === ""){
+        this.name = "testSuite" + (+new Date());
+    }
+
+};
+    
+YUITest.TestSuite.prototype = {
+    
+    //restore constructor
+    constructor: YUITest.TestSuite,
+    
+    /**
+     * Adds a test suite or test case to the test suite.
+     * @param {YUITest.TestSuite||YUITest.TestCase} testObject The test suite or test case to add.
+     * @return {Void}
+     * @method add
+     */
+    add : function (testObject) {
+        if (testObject instanceof YUITest.TestSuite || testObject instanceof YUITest.TestCase) {
+            this.items.push(testObject);
+        }
+        return this;
+    },
+    
+    //-------------------------------------------------------------------------
+    // Stub Methods
+    //-------------------------------------------------------------------------
+
+    /**
+     * Function to run before each test is executed.
+     * @return {Void}
+     * @method setUp
+     */
+    setUp : function () {
+    },
+    
+    /**
+     * Function to run after each test is executed.
+     * @return {Void}
+     * @method tearDown
+     */
+    tearDown: function () {
+    }
+    
+};
+
+/**
+ * An object object containing test result formatting methods.
+ * @namespace YUITest
+ * @class TestFormat
+ * @static
+ */
+YUITest.TestFormat = function(){
+    
+    /* (intentionally not documented)
+     * Basic XML escaping method. Replaces quotes, less-than, greater-than,
+     * apostrophe, and ampersand characters with their corresponding entities.
+     * @param {String} text The text to encode.
+     * @return {String} The XML-escaped text.
+     */
+    function xmlEscape(text){
+    
+        return text.replace(/[<>"'&]/g, function(value){
+            switch(value){
+                case "<":   return "&lt;";
+                case ">":   return "&gt;";
+                case "\"":  return "&quot;";
+                case "'":   return "&apos;";
+                case "&":   return "&amp;";
+            }
+        });
+    
+    }
+        
+        
+    return {
+    
+        /**
+         * Returns test results formatted as a JSON string. Requires JSON utility.
+         * @param {Object} result The results object created by TestRunner.
+         * @return {String} A JSON-formatted string of results.
+         * @method JSON
+         * @static
+         */
+        JSON: function(results) {
+            return YUITest.Util.JSON.stringify(results);
+        },
+        
+        /**
+         * Returns test results formatted as an XML string.
+         * @param {Object} result The results object created by TestRunner.
+         * @return {String} An XML-formatted string of results.
+         * @method XML
+         * @static
+         */
+        XML: function(results) {
+
+            function serializeToXML(results){
+                var xml = "<" + results.type + " name=\"" + xmlEscape(results.name) + "\"";
+                
+                if (typeof(results.duration)=="number"){
+                    xml += " duration=\"" + results.duration + "\"";
+                }
+                
+                if (results.type == "test"){
+                    xml += " result=\"" + results.result + "\" message=\"" + xmlEscape(results.message) + "\">";
+                } else {
+                    xml += " passed=\"" + results.passed + "\" failed=\"" + results.failed + "\" ignored=\"" + results.ignored + "\" total=\"" + results.total + "\">";
+                    for (var prop in results){
+                        if (results.hasOwnProperty(prop)){
+                            if (results[prop] && typeof results[prop] == "object" && !(results[prop] instanceof Array)){
+                                xml += serializeToXML(results[prop]);
+                            }
+                        }
+                    }       
+                }
+
+                xml += "</" + results.type + ">";
+                
+                return xml;    
+            }
+
+            return "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" + serializeToXML(results);
+
+        },
+
+
+        /**
+         * Returns test results formatted in JUnit XML format.
+         * @param {Object} result The results object created by TestRunner.
+         * @return {String} An XML-formatted string of results.
+         * @method JUnitXML
+         * @static
+         */
+        JUnitXML: function(results) {
+
+            function serializeToJUnitXML(results){
+                var xml = "";
+                    
+                switch (results.type){
+                    //equivalent to testcase in JUnit
+                    case "test":
+                        if (results.result != "ignore"){
+                            xml = "<testcase name=\"" + xmlEscape(results.name) + "\" time=\"" + (results.duration/1000) + "\">";
+                            if (results.result == "fail"){
+                                xml += "<failure message=\"" + xmlEscape(results.message) + "\"><![CDATA[" + results.message + "]]></failure>";
+                            }
+                            xml+= "</testcase>";
+                        }
+                        break;
+                        
+                    //equivalent to testsuite in JUnit
+                    case "testcase":
+                    
+                        xml = "<testsuite name=\"" + xmlEscape(results.name) + "\" tests=\"" + results.total + "\" failures=\"" + results.failed + "\" time=\"" + (results.duration/1000) + "\">";
+                        
+                        for (var prop in results){
+                            if (results.hasOwnProperty(prop)){
+                                if (results[prop] && typeof results[prop] == "object" && !(results[prop] instanceof Array)){
+                                    xml += serializeToJUnitXML(results[prop]);
+                                }
+                            }
+                        }            
+                        
+                        xml += "</testsuite>";
+                        break;
+                    
+                    //no JUnit equivalent, don't output anything
+                    case "testsuite":
+                        for (var prop in results){
+                            if (results.hasOwnProperty(prop)){
+                                if (results[prop] && typeof results[prop] == "object" && !(results[prop] instanceof Array)){
+                                    xml += serializeToJUnitXML(results[prop]);
+                                }
+                            }
+                        }                                                     
+                        break;
+                        
+                    //top-level, equivalent to testsuites in JUnit
+                    case "report":
+                    
+                        xml = "<testsuites>";
+                    
+                        for (var prop in results){
+                            if (results.hasOwnProperty(prop)){
+                                if (results[prop] && typeof results[prop] == "object" && !(results[prop] instanceof Array)){
+                                    xml += serializeToJUnitXML(results[prop]);
+                                }
+                            }
+                        }            
+                        
+                        xml += "</testsuites>";            
+                    
+                    //no default
+                }
+                
+                return xml;
+         
+            }
+
+            return "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" + serializeToJUnitXML(results);
+        },
+    
+        /**
+         * Returns test results formatted in TAP format.
+         * For more information, see <a href="http://testanything.org/">Test Anything Protocol</a>.
+         * @param {Object} result The results object created by TestRunner.
+         * @return {String} A TAP-formatted string of results.
+         * @method TAP
+         * @static
+         */
+        TAP: function(results) {
+        
+            var currentTestNum = 1;
+
+            function serializeToTAP(results){
+                var text = "";
+                    
+                switch (results.type){
+
+                    case "test":
+                        if (results.result != "ignore"){
+
+                            text = "ok " + (currentTestNum++) + " - " + results.name;
+                            
+                            if (results.result == "fail"){
+                                text = "not " + text + " - " + results.message;
+                            }
+                            
+                            text += "\n";
+                        } else {
+                            text = "#Ignored test " + results.name + "\n";
+                        }
+                        break;
+                        
+                    case "testcase":
+                    
+                        text = "#Begin testcase " + results.name + "(" + results.failed + " failed of " + results.total + ")\n";
+                                        
+                        for (var prop in results){
+                            if (results.hasOwnProperty(prop)){
+                                if (results[prop] && typeof results[prop] == "object" && !(results[prop] instanceof Array)){
+                                    text += serializeToTAP(results[prop]);
+                                }
+                            }
+                        }            
+                        
+                        text += "#End testcase " + results.name + "\n";
+                        
+                        
+                        break;
+                    
+                    case "testsuite":
+
+                        text = "#Begin testsuite " + results.name + "(" + results.failed + " failed of " + results.total + ")\n";                
+                    
+                        for (var prop in results){
+                            if (results.hasOwnProperty(prop)){
+                                if (results[prop] && typeof results[prop] == "object" && !(results[prop] instanceof Array)){
+                                    text += serializeToTAP(results[prop]);
+                                }
+                            }
+                        }                                                      
+
+                        text += "#End testsuite " + results.name + "\n";
+                        break;
+
+                    case "report":
+                    
+                        for (var prop in results){
+                            if (results.hasOwnProperty(prop)){
+                                if (results[prop] && typeof results[prop] == "object" && !(results[prop] instanceof Array)){
+                                    text += serializeToTAP(results[prop]);
+                                }
+                            }
+                        }              
+                        
+                    //no default
+                }
+                
+                return text;
+         
+            }
+
+            return "1.." + results.total + "\n" + serializeToTAP(results);
+        }
+    
+    };
+}();
+
+/**
+ * An object object containing coverage result formatting methods.
+ * @namespace YUITest
+ * @class CoverageFormat
+ * @static
+ */
+YUITest.CoverageFormat = {
+
+    /**
+     * Returns the coverage report in JSON format. This is the straight
+     * JSON representation of the native coverage report.
+     * @param {Object} coverage The coverage report object.
+     * @return {String} A JSON-formatted string of coverage data.
+     * @method JSON
+     * @namespace YUITest.CoverageFormat
+     */
+    JSON: function(coverage){
+        return YUITest.Util.JSON.stringify(coverage);
+    },
+    
+    /**
+     * Returns the coverage report in a JSON format compatible with
+     * Xdebug. See <a href="http://www.xdebug.com/docs/code_coverage">Xdebug Documentation</a>
+     * for more information. Note: function coverage is not available
+     * in this format.
+     * @param {Object} coverage The coverage report object.
+     * @return {String} A JSON-formatted string of coverage data.
+     * @method XdebugJSON
+     * @namespace YUITest.CoverageFormat
+     */    
+    XdebugJSON: function(coverage){
+    
+        var report = {};
+        for (var prop in coverage){
+            if (coverage.hasOwnProperty(prop)){
+                report[prop] = coverage[prop].lines;
+            }
+        }
+
+        return YUITest.Util.JSON.stringify(coverage);
+    }
+
+};
+
+    
+    /**
+     * Runs test suites and test cases, providing events to allowing for the
+     * interpretation of test results.
+     * @namespace YUITest
+     * @class TestRunner
+     * @static
+     */
+    YUITest.TestRunner = function(){
+
+        /*(intentionally not documented)
+         * Determines if any of the array of test groups appears
+         * in the given TestRunner filter.
+         * @param {Array} testGroups The array of test groups to
+         *      search for.
+         * @param {String} filter The TestRunner groups filter.
+         */
+        function inGroups(testGroups, filter){
+            if (!filter.length){
+                return true;
+            } else {                
+                if (testGroups){
+                    for (var i=0, len=testGroups.length; i < len; i++){
+                        if (filter.indexOf("," + testGroups[i] + ",") > -1){
+                            return true;
+                        }
+                    }
+                }
+                return false;
+            }
+        }
+    
+        /**
+         * A node in the test tree structure. May represent a TestSuite, TestCase, or
+         * test function.
+         * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function.
+         * @class TestNode
+         * @constructor
+         * @private
+         */
+        function TestNode(testObject){
+        
+            /**
+             * The TestSuite, TestCase, or test function represented by this node.
+             * @type Variant
+             * @property testObject
+             */
+            this.testObject = testObject;
+            
+            /**
+             * Pointer to this node's first child.
+             * @type TestNode
+             * @property firstChild
+             */        
+            this.firstChild = null;
+            
+            /**
+             * Pointer to this node's last child.
+             * @type TestNode
+             * @property lastChild
+             */        
+            this.lastChild = null;
+            
+            /**
+             * Pointer to this node's parent.
+             * @type TestNode
+             * @property parent
+             */        
+            this.parent = null; 
+       
+            /**
+             * Pointer to this node's next sibling.
+             * @type TestNode
+             * @property next
+             */        
+            this.next = null;
+            
+            /**
+             * Test results for this test object.
+             * @type object
+             * @property results
+             */                
+            this.results = new YUITest.Results();
+            
+            //initialize results
+            if (testObject instanceof YUITest.TestSuite){
+                this.results.type = "testsuite";
+                this.results.name = testObject.name;
+            } else if (testObject instanceof YUITest.TestCase){
+                this.results.type = "testcase";
+                this.results.name = testObject.name;
+            }
+           
+        }
+        
+        TestNode.prototype = {
+        
+            /**
+             * Appends a new test object (TestSuite, TestCase, or test function name) as a child
+             * of this node.
+             * @param {Variant} testObject A TestSuite, TestCase, or the name of a test function.
+             * @return {Void}
+             */
+            appendChild : function (testObject){
+                var node = new TestNode(testObject);
+                if (this.firstChild === null){
+                    this.firstChild = this.lastChild = node;
+                } else {
+                    this.lastChild.next = node;
+                    this.lastChild = node;
+                }
+                node.parent = this;
+                return node;
+            }       
+        };
+    
+        /**
+         * Runs test suites and test cases, providing events to allowing for the
+         * interpretation of test results.
+         * @namespace Test
+         * @class Runner
+         * @static
+         */
+        function TestRunner(){
+        
+            //inherit from EventTarget
+            YUITest.EventTarget.call(this);
+            
+            /**
+             * Suite on which to attach all TestSuites and TestCases to be run.
+             * @type YUITest.TestSuite
+             * @property masterSuite
+             * @static
+             * @private
+             */
+            this.masterSuite = new YUITest.TestSuite("yuitests" + (new Date()).getTime());        
+    
+            /**
+             * Pointer to the current node in the test tree.
+             * @type TestNode
+             * @private
+             * @property _cur
+             * @static
+             */
+            this._cur = null;
+            
+            /**
+             * Pointer to the root node in the test tree.
+             * @type TestNode
+             * @private
+             * @property _root
+             * @static
+             */
+            this._root = null;
+            
+            /**
+             * Indicates if the TestRunner will log events or not.
+             * @type Boolean
+             * @property _log
+             * @private
+             * @static
+             */
+            this._log = true;
+            
+            /**
+             * Indicates if the TestRunner is waiting as a result of
+             * wait() being called.
+             * @type Boolean
+             * @property _waiting
+             * @private
+             * @static
+             */
+            this._waiting = false;
+            
+            /**
+             * Indicates if the TestRunner is currently running tests.
+             * @type Boolean
+             * @private
+             * @property _running
+             * @static
+             */
+            this._running = false;
+            
+            /**
+             * Holds copy of the results object generated when all tests are
+             * complete.
+             * @type Object
+             * @private
+             * @property _lastResults
+             * @static
+             */
+            this._lastResults = null;       
+            
+            /**
+             * Data object that is passed around from method to method.
+             * @type Object
+             * @private
+             * @property _data
+             * @static
+             */
+            this._context = null;
+            
+            /**
+             * The list of test groups to run. The list is represented
+             * by a comma delimited string with commas at the start and
+             * end.
+             * @type String
+             * @private
+             * @property _groups
+             * @static
+             */
+            this._groups = "";
+        }
+        
+        TestRunner.prototype = YUITest.Util.mix(new YUITest.EventTarget(), {
+        
+            //restore prototype
+            constructor: YUITest.TestRunner,
+        
+            //-------------------------------------------------------------------------
+            // Constants
+            //-------------------------------------------------------------------------
+             
+            /**
+             * Fires when a test case is opened but before the first 
+             * test is executed.
+             * @event testcasebegin
+             * @static
+             */         
+            TEST_CASE_BEGIN_EVENT : "testcasebegin",
+            
+            /**
+             * Fires when all tests in a test case have been executed.
+             * @event testcasecomplete
+             * @static
+             */        
+            TEST_CASE_COMPLETE_EVENT : "testcasecomplete",
+            
+            /**
+             * Fires when a test suite is opened but before the first 
+             * test is executed.
+             * @event testsuitebegin
+             * @static
+             */        
+            TEST_SUITE_BEGIN_EVENT : "testsuitebegin",
+            
+            /**
+             * Fires when all test cases in a test suite have been
+             * completed.
+             * @event testsuitecomplete
+             * @static
+             */        
+            TEST_SUITE_COMPLETE_EVENT : "testsuitecomplete",
+            
+            /**
+             * Fires when a test has passed.
+             * @event pass
+             * @static
+             */        
+            TEST_PASS_EVENT : "pass",
+            
+            /**
+             * Fires when a test has failed.
+             * @event fail
+             * @static
+             */        
+            TEST_FAIL_EVENT : "fail",
+            
+            /**
+             * Fires when a non-test method has an error.
+             * @event error
+             * @static
+             */        
+            ERROR_EVENT : "error",
+            
+            /**
+             * Fires when a test has been ignored.
+             * @event ignore
+             * @static
+             */        
+            TEST_IGNORE_EVENT : "ignore",
+            
+            /**
+             * Fires when all test suites and test cases have been completed.
+             * @event complete
+             * @static
+             */        
+            COMPLETE_EVENT : "complete",
+            
+            /**
+             * Fires when the run() method is called.
+             * @event begin
+             * @static
+             */        
+            BEGIN_EVENT : "begin",                           
+
+            //-------------------------------------------------------------------------
+            // Test Tree-Related Methods
+            //-------------------------------------------------------------------------
+    
+            /**
+             * Adds a test case to the test tree as a child of the specified node.
+             * @param {TestNode} parentNode The node to add the test case to as a child.
+             * @param {YUITest.TestCase} testCase The test case to add.
+             * @return {Void}
+             * @static
+             * @private
+             * @method _addTestCaseToTestTree
+             */
+           _addTestCaseToTestTree : function (parentNode, testCase){
+                
+                //add the test suite
+                var node = parentNode.appendChild(testCase),
+                    prop,
+                    testName;
+                
+                //iterate over the items in the test case
+                for (prop in testCase){
+                    if ((prop.indexOf("test") === 0 || prop.indexOf(" ") > -1) && typeof testCase[prop] == "function"){
+                        node.appendChild(prop);
+                    }
+                }
+             
+            },
+            
+            /**
+             * Adds a test suite to the test tree as a child of the specified node.
+             * @param {TestNode} parentNode The node to add the test suite to as a child.
+             * @param {YUITest.TestSuite} testSuite The test suite to add.
+             * @return {Void}
+             * @static
+             * @private
+             * @method _addTestSuiteToTestTree
+             */
+            _addTestSuiteToTestTree : function (parentNode, testSuite) {
+                
+                //add the test suite
+                var node = parentNode.appendChild(testSuite);
+                
+                //iterate over the items in the master suite
+                for (var i=0; i < testSuite.items.length; i++){
+                    if (testSuite.items[i] instanceof YUITest.TestSuite) {
+                        this._addTestSuiteToTestTree(node, testSuite.items[i]);
+                    } else if (testSuite.items[i] instanceof YUITest.TestCase) {
+                        this._addTestCaseToTestTree(node, testSuite.items[i]);
+                    }                   
+                }            
+            },
+            
+            /**
+             * Builds the test tree based on items in the master suite. The tree is a hierarchical
+             * representation of the test suites, test cases, and test functions. The resulting tree
+             * is stored in _root and the pointer _cur is set to the root initially.
+             * @return {Void}
+             * @static
+             * @private
+             * @method _buildTestTree
+             */
+            _buildTestTree : function () {
+            
+                this._root = new TestNode(this.masterSuite);
+                //this._cur = this._root;
+                
+                //iterate over the items in the master suite
+                for (var i=0; i < this.masterSuite.items.length; i++){
+                    if (this.masterSuite.items[i] instanceof YUITest.TestSuite) {
+                        this._addTestSuiteToTestTree(this._root, this.masterSuite.items[i]);
+                    } else if (this.masterSuite.items[i] instanceof YUITest.TestCase) {
+                        this._addTestCaseToTestTree(this._root, this.masterSuite.items[i]);
+                    }                   
+                }            
+            
+            }, 
+        
+            //-------------------------------------------------------------------------
+            // Private Methods
+            //-------------------------------------------------------------------------
+            
+            /**
+             * Handles the completion of a test object's tests. Tallies test results 
+             * from one level up to the next.
+             * @param {TestNode} node The TestNode representing the test object.
+             * @return {Void}
+             * @method _handleTestObjectComplete
+             * @private
+             */
+            _handleTestObjectComplete : function (node) {
+                var parentNode;
+                
+                if (typeof node.testObject == "object" && node !== null){
+                    parentNode = node.parent;
+                
+                    if (parentNode){
+                        parentNode.results.include(node.results); 
+                        parentNode.results[node.testObject.name] = node.results;
+                    }
+                
+                    if (node.testObject instanceof YUITest.TestSuite){
+                        this._execNonTestMethod(node, "tearDown", false);
+                        node.results.duration = (new Date()) - node._start;
+                        this.fire({ type: this.TEST_SUITE_COMPLETE_EVENT, testSuite: node.testObject, results: node.results});
+                    } else if (node.testObject instanceof YUITest.TestCase){
+                        this._execNonTestMethod(node, "destroy", false);
+                        node.results.duration = (new Date()) - node._start;
+                        this.fire({ type: this.TEST_CASE_COMPLETE_EVENT, testCase: node.testObject, results: node.results});
+                    }      
+                } 
+            },                
+            
+            //-------------------------------------------------------------------------
+            // Navigation Methods
+            //-------------------------------------------------------------------------
+            
+            /**
+             * Retrieves the next node in the test tree.
+             * @return {TestNode} The next node in the test tree or null if the end is reached.
+             * @private
+             * @static
+             * @method _next
+             */
+            _next : function () {
+            
+                if (this._cur === null){
+                    this._cur = this._root;
+                } else if (this._cur.firstChild) {
+                    this._cur = this._cur.firstChild;
+                } else if (this._cur.next) {
+                    this._cur = this._cur.next;            
+                } else {
+                    while (this._cur && !this._cur.next && this._cur !== this._root){
+                        this._handleTestObjectComplete(this._cur);
+                        this._cur = this._cur.parent;
+                    }
+                    
+                    this._handleTestObjectComplete(this._cur);               
+                        
+                    if (this._cur == this._root){
+                        this._cur.results.type = "report";
+                        this._cur.results.timestamp = (new Date()).toLocaleString();
+                        this._cur.results.duration = (new Date()) - this._cur._start;   
+                        this._lastResults = this._cur.results;
+                        this._running = false;                         
+                        this.fire({ type: this.COMPLETE_EVENT, results: this._lastResults});
+                        this._cur = null;
+                    } else {
+                        this._cur = this._cur.next;                
+                    }
+                }
+            
+                return this._cur;
+            },
+            
+            /**
+             * Executes a non-test method (init, setUp, tearDown, destroy)
+             * and traps an errors. If an error occurs, an error event is
+             * fired.
+             * @param {Object} node The test node in the testing tree.
+             * @param {String} methodName The name of the method to execute.
+             * @param {Boolean} allowAsync Determines if the method can be called asynchronously.
+             * @return {Boolean} True if an async method was called, false if not.
+             * @method _execNonTestMethod
+             * @private
+             */
+            _execNonTestMethod: function(node, methodName, allowAsync){
+                var testObject = node.testObject,
+                    event = { type: this.ERROR_EVENT };
+                try {
+                    if (allowAsync && testObject["async:" + methodName]){
+                        testObject["async:" + methodName](this._context);
+                        return true;
+                    } else {
+                        testObject[methodName](this._context);
+                    }
+                } catch (ex){
+                    node.results.errors++;
+                    event.error = ex;
+                    event.methodName = methodName;
+                    if (testObject instanceof YUITest.TestCase){
+                        event.testCase = testObject;
+                    } else {
+                        event.testSuite = testSuite;
+                    }
+                    
+                    this.fire(event);
+                }  
+
+                return false;
+            },
+            
+            /**
+             * Runs a test case or test suite, returning the results.
+             * @param {YUITest.TestCase|YUITest.TestSuite} testObject The test case or test suite to run.
+             * @return {Object} Results of the execution with properties passed, failed, and total.
+             * @private
+             * @method _run
+             * @static
+             */
+            _run : function () {
+            
+                //flag to indicate if the TestRunner should wait before continuing
+                var shouldWait = false;
+                
+                //get the next test node
+                var node = this._next();
+                
+                if (node !== null) {
+                
+                    //set flag to say the testrunner is running
+                    this._running = true;
+                    
+                    //eliminate last results
+                    this._lastResult = null;                  
+                
+                    var testObject = node.testObject;
+                    
+                    //figure out what to do
+                    if (typeof testObject == "object" && testObject !== null){
+                        if (testObject instanceof YUITest.TestSuite){
+                            this.fire({ type: this.TEST_SUITE_BEGIN_EVENT, testSuite: testObject });
+                            node._start = new Date();
+                            this._execNonTestMethod(node, "setUp" ,false);
+                        } else if (testObject instanceof YUITest.TestCase){
+                            this.fire({ type: this.TEST_CASE_BEGIN_EVENT, testCase: testObject });
+                            node._start = new Date();
+                            
+                            //regular or async init
+                            /*try {
+                                if (testObject["async:init"]){
+                                    testObject["async:init"](this._context);
+                                    return;
+                                } else {
+                                    testObject.init(this._context);
+                                }
+                            } catch (ex){
+                                node.results.errors++;
+                                this.fire({ type: this.ERROR_EVENT, error: ex, testCase: testObject, methodName: "init" });
+                            }*/
+                            if(this._execNonTestMethod(node, "init", true)){
+                                return;
+                            }
+                        }
+                        
+                        //some environments don't support setTimeout
+                        if (typeof setTimeout != "undefined"){                    
+                            setTimeout(function(){
+                                YUITest.TestRunner._run();
+                            }, 0);
+                        } else {
+                            this._run();
+                        }
+                    } else {
+                        this._runTest(node);
+                    }
+    
+                }
+            },
+            
+            _resumeTest : function (segment) {
+            
+                //get relevant information
+                var node = this._cur;                
+                
+                //we know there's no more waiting now
+                this._waiting = false;
+                
+                //if there's no node, it probably means a wait() was called after resume()
+                if (!node){
+                    //TODO: Handle in some way?
+                    //console.log("wait() called after resume()");
+                    //this.fire("error", { testCase: "(unknown)", test: "(unknown)", error: new Error("wait() called after resume()")} );
+                    return;
+                }
+                
+                var testName = node.testObject;
+                var testCase = node.parent.testObject;
+            
+                //cancel other waits if available
+                if (testCase.__yui_wait){
+                    clearTimeout(testCase.__yui_wait);
+                    delete testCase.__yui_wait;
+                }
+
+                //get the "should" test cases
+                var shouldFail = testName.indexOf("fail:") === 0 ||
+                                    (testCase._should.fail || {})[testName];
+                var shouldError = (testCase._should.error || {})[testName];
+                
+                //variable to hold whether or not the test failed
+                var failed = false;
+                var error = null;
+                    
+                //try the test
+                try {
+                
+                    //run the test
+                    segment.call(testCase, this._context);                    
+                
+                    //if the test hasn't already failed and doesn't have any asserts...
+                    if(YUITest.Assert._getCount() == 0){
+                        throw new YUITest.AssertionError("Test has no asserts.");
+                    }                                                        
+                    //if it should fail, and it got here, then it's a fail because it didn't
+                     else if (shouldFail){
+                        error = new YUITest.ShouldFail();
+                        failed = true;
+                    } else if (shouldError){
+                        error = new YUITest.ShouldError();
+                        failed = true;
+                    }
+                               
+                } catch (thrown){
+
+                    //cancel any pending waits, the test already failed
+                    if (testCase.__yui_wait){
+                        clearTimeout(testCase.__yui_wait);
+                        delete testCase.__yui_wait;
+                    }                    
+                
+                    //figure out what type of error it was
+                    if (thrown instanceof YUITest.AssertionError) {
+                        if (!shouldFail){
+                            error = thrown;
+                            failed = true;
+                        }
+                    } else if (thrown instanceof YUITest.Wait){
+                    
+                        if (typeof thrown.segment == "function"){
+                            if (typeof thrown.delay == "number"){
+                            
+                                //some environments don't support setTimeout
+                                if (typeof setTimeout != "undefined"){
+                                    testCase.__yui_wait = setTimeout(function(){
+                                        YUITest.TestRunner._resumeTest(thrown.segment);
+                                    }, thrown.delay);
+                                    this._waiting = true;
+                                } else {
+                                    throw new Error("Asynchronous tests not supported in this environment.");
+                                }
+                            }
+                        }
+                        
+                        return;
+                    
+                    } else {
+                        //first check to see if it should error
+                        if (!shouldError) {                        
+                            error = new YUITest.UnexpectedError(thrown);
+                            failed = true;
+                        } else {
+                            //check to see what type of data we have
+                            if (typeof shouldError == "string"){
+                                
+                                //if it's a string, check the error message
+                                if (thrown.message != shouldError){
+                                    error = new YUITest.UnexpectedError(thrown);
+                                    failed = true;                                    
+                                }
+                            } else if (typeof shouldError == "function"){
+                            
+                                //if it's a function, see if the error is an instance of it
+                                if (!(thrown instanceof shouldError)){
+                                    error = new YUITest.UnexpectedError(thrown);
+                                    failed = true;
+                                }
+                            
+                            } else if (typeof shouldError == "object" && shouldError !== null){
+                            
+                                //if it's an object, check the instance and message
+                                if (!(thrown instanceof shouldError.constructor) || 
+                                        thrown.message != shouldError.message){
+                                    error = new YUITest.UnexpectedError(thrown);
+                                    failed = true;                                    
+                                }
+                            
+                            }
+                        
+                        }
+                    }
+                    
+                }
+                
+                //fire appropriate event
+                if (failed) {
+                    this.fire({ type: this.TEST_FAIL_EVENT, testCase: testCase, testName: testName, error: error });
+                } else {
+                    this.fire({ type: this.TEST_PASS_EVENT, testCase: testCase, testName: testName });
+                }
+                
+                //run the tear down
+                this._execNonTestMethod(node.parent, "tearDown", false);
+                
+                //reset the assert count
+                YUITest.Assert._reset();
+                
+                //calculate duration
+                var duration = (new Date()) - node._start;
+                
+                //update results
+                node.parent.results[testName] = { 
+                    result: failed ? "fail" : "pass",
+                    message: error ? error.getMessage() : "Test passed",
+                    type: "test",
+                    name: testName,
+                    duration: duration
+                };
+                
+                if (failed){
+                    node.parent.results.failed++;
+                } else {
+                    node.parent.results.passed++;
+                }
+                node.parent.results.total++;
+    
+                //set timeout not supported in all environments
+                if (typeof setTimeout != "undefined"){
+                    setTimeout(function(){
+                        YUITest.TestRunner._run();
+                    }, 0);
+                } else {
+                    this._run();
+                }
+            
+            },
+            
+            /**
+             * Handles an error as if it occurred within the currently executing
+             * test. This is for mock methods that may be called asynchronously
+             * and therefore out of the scope of the TestRunner. Previously, this
+             * error would bubble up to the browser. Now, this method is used
+             * to tell TestRunner about the error. This should never be called
+             * by anyplace other than the Mock object.
+             * @param {Error} error The error object.
+             * @return {Void}
+             * @method _handleError
+             * @private
+             * @static
+             */
+            _handleError: function(error){
+            
+                if (this._waiting){
+                    this._resumeTest(function(){
+                        throw error;
+                    });
+                } else {
+                    throw error;
+                }           
+            
+            },
+                    
+            /**
+             * Runs a single test based on the data provided in the node.
+             * @param {TestNode} node The TestNode representing the test to run.
+             * @return {Void}
+             * @static
+             * @private
+             * @name _runTest
+             */
+            _runTest : function (node) {
+            
+                //get relevant information
+                var testName = node.testObject,
+                    testCase = node.parent.testObject,
+                    test = testCase[testName],
+                
+                    //get the "should" test cases
+                    shouldIgnore = testName.indexOf("ignore:") === 0 ||
+                                    !inGroups(testCase.groups, this._groups) ||
+                                    (testCase._should.ignore || {})[testName];   //deprecated
+                
+                //figure out if the test should be ignored or not
+                if (shouldIgnore){
+                
+                    //update results
+                    node.parent.results[testName] = { 
+                        result: "ignore",
+                        message: "Test ignored",
+                        type: "test",
+                        name: testName.indexOf("ignore:") === 0 ? testName.substring(7) : testName
+                    };
+                    
+                    node.parent.results.ignored++;
+                    node.parent.results.total++;
+                
+                    this.fire({ type: this.TEST_IGNORE_EVENT,  testCase: testCase, testName: testName });
+                    
+                    //some environments don't support setTimeout
+                    if (typeof setTimeout != "undefined"){                    
+                        setTimeout(function(){
+                            YUITest.TestRunner._run();
+                        }, 0);              
+                    } else {
+                        this._run();
+                    }
+    
+                } else {
+                
+                    //mark the start time
+                    node._start = new Date();
+                
+                    //run the setup
+                    this._execNonTestMethod(node.parent, "setUp", false);
+                    
+                    //now call the body of the test
+                    this._resumeTest(test);                
+                }
+    
+            },            
+
+            //-------------------------------------------------------------------------
+            // Misc Methods
+            //-------------------------------------------------------------------------   
+
+            /**
+             * Retrieves the name of the current result set.
+             * @return {String} The name of the result set.
+             * @method getName
+             */
+            getName: function(){
+                return this.masterSuite.name;
+            },         
+
+            /**
+             * The name assigned to the master suite of the TestRunner. This is the name
+             * that is output as the root's name when results are retrieved.
+             * @param {String} name The name of the result set.
+             * @return {Void}
+             * @method setName
+             */
+            setName: function(name){
+                this.masterSuite.name = name;
+            },            
+            
+            //-------------------------------------------------------------------------
+            // Public Methods
+            //-------------------------------------------------------------------------   
+        
+            /**
+             * Adds a test suite or test case to the list of test objects to run.
+             * @param testObject Either a TestCase or a TestSuite that should be run.
+             * @return {Void}
+             * @method add
+             * @static
+             */
+            add : function (testObject) {
+                this.masterSuite.add(testObject);
+                return this;
+            },
+            
+            /**
+             * Removes all test objects from the runner.
+             * @return {Void}
+             * @method clear
+             * @static
+             */
+            clear : function () {
+                this.masterSuite = new YUITest.TestSuite("yuitests" + (new Date()).getTime());
+            },
+            
+            /**
+             * Indicates if the TestRunner is waiting for a test to resume
+             * @return {Boolean} True if the TestRunner is waiting, false if not.
+             * @method isWaiting
+             * @static
+             */
+            isWaiting: function() {
+                return this._waiting;
+            },
+            
+            /**
+             * Indicates that the TestRunner is busy running tests and therefore can't
+             * be stopped and results cannot be gathered.
+             * @return {Boolean} True if the TestRunner is running, false if not.
+             * @method isRunning
+             */
+            isRunning: function(){
+                return this._running;
+            },
+            
+            /**
+             * Returns the last complete results set from the TestRunner. Null is returned
+             * if the TestRunner is running or no tests have been run.
+             * @param {Function} format (Optional) A test format to return the results in.
+             * @return {Object|String} Either the results object or, if a test format is 
+             *      passed as the argument, a string representing the results in a specific
+             *      format.
+             * @method getResults
+             */
+            getResults: function(format){
+                if (!this._running && this._lastResults){
+                    if (typeof format == "function"){
+                        return format(this._lastResults);                    
+                    } else {
+                        return this._lastResults;
+                    }
+                } else {
+                    return null;
+                }
+            },            
+            
+            /**
+             * Returns the coverage report for the files that have been executed.
+             * This returns only coverage information for files that have been
+             * instrumented using YUI Test Coverage and only those that were run
+             * in the same pass.
+             * @param {Function} format (Optional) A coverage format to return results in.
+             * @return {Object|String} Either the coverage object or, if a coverage
+             *      format is specified, a string representing the results in that format.
+             * @method getCoverage
+             */
+            getCoverage: function(format){
+                if (!this._running && typeof _yuitest_coverage == "object"){
+                    if (typeof format == "function"){
+                        return format(_yuitest_coverage);                    
+                    } else {
+                        return _yuitest_coverage;
+                    }
+                } else {
+                    return null;
+                }            
+            },
+            
+            /**
+             * Used to continue processing when a method marked with
+             * "async:" is executed. This should not be used in test
+             * methods, only in init(). Each argument is a string, and
+             * when the returned function is executed, the arguments
+             * are assigned to the context data object using the string
+             * as the key name (value is the argument itself).
+             * @private
+             * @return {Function} A callback function.
+             */
+            callback: function(){
+                var names   = arguments,
+                    data    = this._context,
+                    that    = this;
+                    
+                return function(){
+                    for (var i=0; i < arguments.length; i++){
+                        data[names[i]] = arguments[i];
+                    }
+                    that._run();
+                };
+            },
+            
+            /**
+             * Resumes the TestRunner after wait() was called.
+             * @param {Function} segment The function to run as the rest
+             *      of the haulted test.
+             * @return {Void}
+             * @method resume
+             * @static
+             */
+            resume : function (segment) {
+                if (this._waiting){
+                    this._resumeTest(segment || function(){});
+                } else {
+                    throw new Error("resume() called without wait().");
+                }
+            },
+        
+            /**
+             * Runs the test suite.
+             * @param {Object|Boolean} options (Optional) Options for the runner:
+             *      <code>oldMode</code> indicates the TestRunner should work in the YUI <= 2.8 way
+             *      of internally managing test suites. <code>groups</code> is an array
+             *      of test groups indicating which tests to run.
+             * @return {Void}
+             * @method run
+             * @static
+             */
+            run : function (options) {
+
+                options = options || {};
+                
+                //pointer to runner to avoid scope issues 
+                var runner  = YUITest.TestRunner,
+                    oldMode = options.oldMode;
+                
+                
+                //if there's only one suite on the masterSuite, move it up
+                if (!oldMode && this.masterSuite.items.length == 1 && this.masterSuite.items[0] instanceof YUITest.TestSuite){
+                    this.masterSuite = this.masterSuite.items[0];
+                }                
+                
+                //determine if there are any groups to filter on
+                runner._groups = (options.groups instanceof Array) ? "," + options.groups.join(",") + "," : "";
+                
+                //initialize the runner
+                runner._buildTestTree();
+                runner._context = {};
+                runner._root._start = new Date();
+                
+                //fire the begin event
+                runner.fire(runner.BEGIN_EVENT);
+           
+                //begin the testing
+                runner._run();
+            }    
+        });
+        
+        return new TestRunner();
+        
+    }();
+
+/*!
+ * Portions of this code incorporated from CSS Lint:
+ * https://github.com/stubbornella/csslint
+ */
+ 
+importPackage(java.io);
+importPackage(java.lang);
+    
+YUITest.CLI = {
+    args: arguments,
+    
+    print: function(message){
+        System.out.print(message);
+    },
+    
+    println: print,
+    
+    warn: function(message){
+        System.err.print(message);
+    },
+    
+    quit: quit,
+    
+    isDirectory: function(name){
+        var dir = new File(name);
+        return dir.isDirectory();
+    },
+    
+    getFiles: function(dir){
+        var files = [];
+
+        function traverse(dir) {
+            var dirList = dir.listFiles();
+            dirList.forEach(function (file) {
+                if (/\.js$/.test(file)) {
+                    files.push(file.toString());
+                } else if (file.isDirectory()) {
+                    traverse(file);
+                }
+            });
+        }
+
+        traverse(new File(dir));
+
+        return files;    
+    },
+    
+    getFullPath: function(filename){
+        return (new File(filename)).getCanonicalPath();
+    },
+
+    readFile: readFile,
+    
+    processFiles: function(){
+        var files = this.files,
+            i, len, output;
+
+        if (files.length){
+            for (i=0, len=files.length; i < len; i++){
+
+                if (this.options.verbose){
+                    this.warn("[INFO] Loading " + files[i] + "\n");
+                }
+                
+                load(files[i]);
+
+            }
+        } else {
+            this.warn("[ERROR] No tests to run, exiting.\n");
+            this.quit(1);    
+        }    
+    }
+};
+
+
+
+
+
+/**
+ * Console output that mimics logger output from YUI Test for YUI 2/3.
+ * @namespace YUITest.Node.CLI
+ * @class Logger
+ * @constructor
+ */
+YUITest.CLI.Logger = function(){
+
+    var testRunner  = YUITest.TestRunner,
+        cli         = YUITest.CLI;
+
+    //handles test runner events
+    function handleEvent(event){
+    
+        var message = "";
+        switch(event.type){
+            case testRunner.BEGIN_EVENT:
+                message = "Testing began at " + (new Date()).toString() + ".";
+                messageType = "info";
+                break;
+                
+            case testRunner.COMPLETE_EVENT:
+                message = "Testing completed at " +
+                    (new Date()).toString() + ".\n" +
+                    "Passed:" + event.results.passed + " Failed:" + event.results.failed +
+                    " Total:" + event.results.total + "(" + event.results.ignored + " ignored)"; 
+                messageType = "info";
+                break;
+                
+            case testRunner.TEST_FAIL_EVENT:
+                message = event.testName + ": failed.\n" + event.error.getMessage();
+                messageType = "fail";
+                break;
+                
+            case testRunner.ERROR_EVENT:
+                message = event.methodName + ": error.\n" + event.error.message;
+                messageType = "error";
+                break;
+                
+            case testRunner.TEST_IGNORE_EVENT:
+                message = event.testName + ": ignored.";
+                messageType = "ignore";
+                break;
+                
+            case testRunner.TEST_PASS_EVENT:
+                message = event.testName + ": passed.";
+                messageType = "pass";
+                break;
+                
+            case testRunner.TEST_SUITE_BEGIN_EVENT:
+                message = "Test suite \"" + event.testSuite.name + "\" started.";
+                messageType = "info";
+                break;
+                
+            case testRunner.TEST_SUITE_COMPLETE_EVENT:
+                message = "Testing completed at " +
+                    (new Date()).toString() + ".\n" +
+                    "Passed:" + event.results.passed + " Failed:" + event.results.failed +
+                    " Total:" + event.results.total + "(" + event.results.ignored + " ignored)";
+                messageType = "info";
+                break;
+                
+            case testRunner.TEST_CASE_BEGIN_EVENT:
+                message = "Test case \"" + event.testCase.name + "\" started.";
+                messageType = "info";
+                break;
+                
+            case testRunner.TEST_CASE_COMPLETE_EVENT:
+                message = "Testing completed at " +
+                    (new Date()).toString() + ".\n" +
+                    "Passed:" + event.results.passed + " Failed:" + event.results.failed +
+                    " Total:" + event.results.total + "(" + event.results.ignored + " ignored)";
+                messageType = "info";
+                break;
+            default:
+                message = "Unexpected event " + event.type;
+                messageType = "info";
+        }    
+        
+        cli.print(message + "\n");
+    }
+
+    testRunner.subscribe(testRunner.BEGIN_EVENT, handleEvent)
+    testRunner.subscribe(testRunner.TEST_FAIL_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_PASS_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_IGNORE_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_CASE_BEGIN_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_CASE_COMPLETE_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_SUITE_BEGIN_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_SUITE_COMPLETE_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.COMPLETE_EVENT, handleEvent); 
+
+};
+
+
+
+/**
+ * Console output that mimics XUnit output.
+ * @namespace YUITest.CLI
+ * @class XUnit
+ * @constructor
+ */
+YUITest.CLI.XUnit = function(){
+
+    var testRunner  = YUITest.TestRunner,
+        cli         = YUITest.CLI,
+        errors      = [],
+        failures    = [],
+        stack       = [];
+        
+    function filterStackTrace(stackTrace){
+        if (stackTrace){
+            var lines = stackTrace.split("\n"),
+                result = [],
+                i, len;
+                
+            //skip first line, it's the error
+            for (i=1, len=lines.length; i < len; i++){
+                if (lines[i].indexOf("yuitest-node") > -1){
+                    break;
+                } else {
+                    result.push(lines[i]);
+                }
+            }
+            
+            return result.join("\n");    
+        } else {
+            return "Unavailable."
+        }
+    }
+
+    //handles test runner events
+    function handleEvent(event){
+    
+        var message = "",
+            results = event.results,
+            i, len;
+            
+        switch(event.type){
+            case testRunner.BEGIN_EVENT:
+                message = "YUITest for Node.js\n";
+                
+                if (testRunner._groups){
+                    message += "Filtering on groups '" + testRunner._groups.slice(1,-1) + "'\n";
+                }
+                break;
+                
+            case testRunner.COMPLETE_EVENT:
+                message = "\nTotal tests: " + results.total + ", Failures: " + 
+                    results.failed + ", Skipped: " + results.ignored +
+                    ", Time: " + (results.duration/1000) + " seconds\n";
+                    
+                if (failures.length){
+                    message += "\nTests failed:\n";
+                    
+                    for (i=0,len=failures.length; i < len; i++){
+                        message += "\n" + (i+1) + ") " + failures[i].name + " : " + failures[i].error.getMessage() + "\n";
+                        message += "Stack trace:\n" + filterStackTrace(failures[i].error.stack) + "\n";
+                    }
+                
+                    message += "\n";
+                }
+                
+                if (errors.length){
+                    message += "\nErrors:\n";
+                    
+                    for (i=0,len=errors.length; i < len; i++){
+                        message += "\n" + (i+1) + ") " + errors[i].name + " : " + errors[i].error.message + "\n";
+                        message += "Stack trace:\n" + filterStackTrace(errors[i].error.stack) + "\n";
+                    }
+                
+                    message += "\n";
+                }
+                
+                message += "\n\n";
+                break;
+                
+            case testRunner.TEST_FAIL_EVENT:
+                message = "F";
+                failures.push({
+                    name: stack.concat([event.testName]).join(" > "),
+                    error: event.error
+                });
+
+                break;
+                
+            case testRunner.ERROR_EVENT:
+                errors.push({
+                    name: stack.concat([event.methodName]).join(" > "),
+                    error: event.error
+                });
+
+                break;
+                
+            case testRunner.TEST_IGNORE_EVENT:
+                message = "S";
+                break;
+                
+            case testRunner.TEST_PASS_EVENT:
+                message = ".";
+                break;
+                
+            case testRunner.TEST_SUITE_BEGIN_EVENT:
+                stack.push(event.testSuite.name);
+                break;
+                
+            case testRunner.TEST_CASE_COMPLETE_EVENT:
+            case testRunner.TEST_SUITE_COMPLETE_EVENT:
+                stack.pop();
+                break;
+                
+            case testRunner.TEST_CASE_BEGIN_EVENT:
+                stack.push(event.testCase.name);
+                break;
+                
+            //no default
+        }    
+        
+        cli.print(message);
+    }
+
+    testRunner.subscribe(testRunner.BEGIN_EVENT, handleEvent)
+    testRunner.subscribe(testRunner.TEST_FAIL_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_PASS_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.ERROR_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_IGNORE_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_CASE_BEGIN_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_CASE_COMPLETE_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_SUITE_BEGIN_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.TEST_SUITE_COMPLETE_EVENT, handleEvent);
+    testRunner.subscribe(testRunner.COMPLETE_EVENT, handleEvent); 
+
+};
+
+
+
+/**
+ * Console output that uses TestFormat formats.
+ * @namespace YUITest.Node.CLI
+ * @class Format
+ * @constructor
+ */
+YUITest.CLI.Format = function(format){
+
+    var testRunner  = YUITest.TestRunner,
+        cli         = YUITest.CLI;
+
+    //handles test runner events
+    function handleEvent(event){
+    
+        var results = event.results;
+
+        cli.print(format(results));
+    }
+
+    testRunner.subscribe(testRunner.COMPLETE_EVENT, handleEvent); 
+
+};
+
+/*
+ * Augments the environment-specific CLI API with common functionality.
+ */
+YUITest.Util.mix(YUITest.CLI, {
+
+    files: [],
+
+    options: {
+        verbose: false,
+        webcompat: false,
+        help: false,
+        format: "xunit"
+    },
+    
+    outputHelp: function(){
+        this.print([
+            "\nUsage: yuitest [options] [file|dir]*",
+            " ",
+            "Global Options",
+            "  --groups groupname  Run only tests cases that are part of groupname.",
+            "  --help              Displays this information.",
+            "  --format <format>   Specifies output format (junitxml, tap, xunit).",
+            "  --verbose           Display informational messages and warnings.",
+            "  --webcompat         Load tests designed for use in browsers."   
+        ].join("\n") + "\n\n");
+    },
+    
+    processArguments: function(){
+
+        var args    = this.args,  
+            arg     = args.shift(), 
+            files   = [];  
+            
+        while(arg){
+            if (arg.indexOf("--") == 0){
+                this.options[arg.substring(2)] = true;
+                
+                //get the next argument
+                if (arg == "--groups" || arg == "--format"){
+                    this.options[arg.substring(2)] = args.shift();
+                }
+            } else {
+                
+                //see if it's a directory or a file
+                if (this.isDirectory(arg)){
+                    files = files.concat(this.getFiles(arg));
+                } else {
+                    files.push(arg);
+                }
+            }
+            arg = args.shift();
+        }
+
+        if (this.options.help || files.length === 0){
+            this.outputHelp();
+            this.quit(0);
+        }
+
+        this.files = files;
+        
+        //-----------------------------------------------------------------------------
+        // Determine output format
+        //-----------------------------------------------------------------------------
+
+        switch(this.options.format){
+            case "junitxml":
+                if (this.options.verbose){
+                    this.warn("[INFO] Using JUnitXML output format.\n");
+                }
+                YUITest.CLI.Format(YUITest.TestFormat.JUnitXML);
+                break;
+            case "tap":
+                if (this.options.verbose){
+                    this.warn("[INFO] Using TAP output format.\n");
+                }
+                YUITest.CLI.Format(YUITest.TestFormat.TAP);
+                break;
+            default:
+                if (this.options.verbose){
+                    this.warn("[INFO] Using XUnit output format.\n");
+                }
+                YUITest.CLI.XUnit();
+        }    
+    },
+    
+    start: function(){
+    
+        this.processArguments();
+        this.processFiles();
+        
+        YUITest.TestRunner.run({
+            groups: this.options.groups ? this.options.groups.split(",") : null
+        });    
+    }        
+});
+
+YUITest.CLI.start();
+