Runs test suites and test cases, providing events to allowing for the interpretation of test results.
_addTestCaseToTestTreeparentNode
testCase
Adds a test case to the test tree as a child of the specified node.
parentNode
TestNode
The node to add the test case to as a child.
testCase
Test.TestCase
The test case to add.
_addTestSuiteToTestTreeparentNode
testSuite
Adds a test suite to the test tree as a child of the specified node.
parentNode
TestNode
The node to add the test suite to as a child.
testSuite
Test.TestSuite
The test suite to add.
_buildTestTreeBuilds 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.
_execNonTestMethodnode
methodName
allowAsync
Executes a non-test method (init, setUp, tearDown, destroy) and traps an errors. If an error occurs, an error event is fired.
True if an async method was called, false if not.
_handleErrorerror
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.
error
Error
The error object.
_handleTestObjectCompletenode
Handles the completion of a test object's tests. Tallies test results from one level up to the next.
node
TestNode
The TestNode representing the test object.
_nextRetrieves the next node in the test tree.
The next node in the test tree or null if the end is reached.
_runtestObject
Runs a test case or test suite, returning the results.
testObject
Test.TestCase | YUITest.TestSuite
The test case or test suite to run.
Results of the execution with properties passed, failed, and total.
_runTestnode
Runs a single test based on the data provided in the node.
node
TestNode
The TestNode representing the test to run.
addtestObject
Adds a test suite or test case to the list of test objects to run.
testObject
Object
Either a TestCase or a TestSuite that should be run.
callbackUsed 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).
A callback function.
clearRemoves all test objects from the runner.
getCoverageformat
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.
format
Function
(Optional) A coverage format to return results in.
getNameRetrieves the name of the current result set.
The name of the result set.
getResultsformat
Returns the last complete results set from the TestRunner. Null is returned if the TestRunner is running or no tests have been run.
format
Function
(Optional) A test format to return the results in.
isRunningIndicates that the TestRunner is busy running tests and therefore can't be stopped and results cannot be gathered.
True if the TestRunner is running, false if not.
isWaitingIndicates if the TestRunner is waiting for a test to resume
True if the TestRunner is waiting, false if not.
resumesegment
Resumes the TestRunner after wait() was called.
segment
Function
The function to run as the rest of the haulted test.
runoptions
Runs the test suite.
setNamename
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.
name
String
The name of the result set.
_curPointer to the current node in the test tree.
_groupsThe list of test groups to run. The list is represented by a comma delimited string with commas at the start and end.
_ignoreEmptyIf true, YUITest will not fire an error for tests with no Asserts.
_lastResultsHolds copy of the results object generated when all tests are complete.
_rootPointer to the root node in the test tree.
_waitingIndicates if the TestRunner is waiting as a result of wait() being called.
masterSuiteSuite on which to attach all TestSuites and TestCases to be run.
beginFires when the run() method is called.
completeFires when all test suites and test cases have been completed.
errorFires when a non-test method has an error.
failFires when a test has failed.
ignoreFires when a test has been ignored.
passFires when a test has passed.
testcasebeginFires when a test case is opened but before the first test is executed.
testcasecompleteFires when all tests in a test case have been executed.
testsuitebeginFires when a test suite is opened but before the first test is executed.
testsuitecompleteFires when all test cases in a test suite have been completed.