Mac Dev Center Mac OS X Reference Library IDEs CPlusTest Reference

Overview

Abstract base class for objects that can observe the execution of tests.

Discussion

A TestObserver can be added to a TestRun to observe the execution of tests as they run and track their progress. It will be notified when tests start, stop, and fail, as well as when test suites start and stop.

Functions

testDidFail

Informs the observer that the input Test failed execution, and of information about the failure.

testDidStart

Informs the observer that the input Test started execution.

testDidStop

Informs the observer that the input Test completed execution.

TestObserver

Constructor for the TestObserver class.

testSuiteDidStart

Informs the observer that the input TestSuite started execution.

testSuiteDidStop

Informs the observer that the input TestSuite completed execution.

~TestObserver

Destructor for the TestObserver class.

Informs the observer that the input Test failed execution, and of information about the failure.

public

virtual void testDidFail(
    Test& test,
    const TestFailure& failure) = 0; 

Parameters

Discussion

Informs the observer that the input Test failed execution, and of information about the failure. This information includes source code file name and line number, as well as an informative message. A Test can either complete (stop) or fail, not both.

Informs the observer that the input Test started execution.

public

virtual void testDidStart(
    Test& test) = 0; 

Parameters

Discussion

Informs the observer that the input Test started execution.

Informs the observer that the input Test completed execution.

public

virtual void testDidStop(
    Test& test) = 0; 

Parameters

Discussion

Informs the observer that the input Test completed execution. A Test only completes if it did not fail.

Constructor for the TestObserver class.

public

TestObserver(); 

Discussion

Constructor for the TestObserver class.

Informs the observer that the input TestSuite started execution.

public

virtual void testSuiteDidStart(
    TestSuite& testSuite) = 0; 

Parameters

Discussion

Informs the observer that the input TestSuite started execution.

Informs the observer that the input TestSuite completed execution.

public

virtual void testSuiteDidStop(
    TestSuite& testSuite) = 0; 

Parameters

Discussion

Informs the observer that the input TestSuite completed execution. TestSuites always complete, regardless of whether any of their component Tests fail.

Destructor for the TestObserver class.

public

virtual ~TestObserver(); 

Discussion

Destructor for the TestObserver class.