XCTestObservationCenter Class Reference
Inherits from | NSObject |
---|---|
Declared in | XCTestObservationCenter.h |
Overview
@class XCTestObservationCenter
The XCTestObservationCenter distributes information about the progress of test runs to registered observers. Observers can be any object conforming to the XCTestObservation protocol.
If an NSPrincipalClass is declared in the test bundle’s Info.plist, XCTest automatically creates a single instance of that class when the test bundle is loaded. This instance provides a means to register observers or do other pretesting global set up.
Observers must be registered manually. The NSPrincipalClass instance is not automatically registered as an observer even if the class conforms to XCTestObservation.
+ sharedTestObservationCenter
@method +sharedTestObservationCenter
+ (XCTestObservationCenter *)sharedTestObservationCenter
Return Value
The shared XCTestObservationCenter singleton instance.
Declared In
XCTestObservationCenter.h
– addTestObserver:
@method -addTestObserver:
- (void)addTestObserver:(id<XCTestObservation>)testObserver
Discussion
Register an object conforming to XCTestObservation as an observer for the current test session. Observers may be added at any time, but will not receive events that occurred before they were registered. The observation center maintains a strong reference to observers.
Events may be delivered to observers in any order - given observers A and B, A may be notified of a test failure before or after B. Any ordering dependencies or serialization requirements must be managed by clients.
Declared In
XCTestObservationCenter.h
– removeTestObserver:
@method -removeTestObserver:
- (void)removeTestObserver:(id<XCTestObservation>)testObserver
Discussion
Unregister an object conforming to XCTestObservation as an observer for the current test session.
Declared In
XCTestObservationCenter.h