trait Reporter extends AnyRef
Trait whose instances collect the results of a running suite of tests and presents those results in some way to the user. Instances of this trait can be called "report functions" or "reporters."
Reporters receive test results via fifteen events. Each event is fired to pass a particular kind of information to the reporter. The events are:
DiscoveryStarting
DiscoveryCompleted
RunStarting
RunStopped
RunAborted
RunCompleted
ScopeOpened
ScopeClosed
ScopePending
TestStarting
TestSucceeded
TestFailed
TestCanceled
TestIgnored
TestPending
SuiteStarting
SuiteCompleted
SuiteAborted
InfoProvided
MarkupProvided
AlertProvided
NoteProvided
Reporters may be implemented such that they only present some of the reported events to the user. For example, you could
define a reporter class that does nothing in response to SuiteStarting
events.
Such a class would always ignore SuiteStarting
events.
The term test as used in the TestStarting
, TestSucceeded
,
and TestFailed
event names
is defined abstractly to enable a wide range of test implementations.
ScalaTest's style traits (subclasse of trait Suite
) fire
TestStarting
to indicate they are about to invoke one
of their tests, TestSucceeded
to indicate a test returned normally,
and TestFailed
to indicate a test completed abruptly with an exception.
Although the execution of a Suite
subclass's tests will likely be a common event
reported via the
TestStarting
, TestSucceeded
, and TestFailed
events, because
of the abstract definition of “test” used by the
the event classes, these events are not limited to this use. Information about any conceptual test
may be reported via the TestStarting
, TestSucceeded
, and
TestFailed
events.
Likewise, the term suite as used in the SuiteStarting
, SuiteAborted
,
and SuiteCompleted
event names
is defined abstractly to enable a wide range of suite implementations.
Object Runner
fires SuiteStarting
to indicate it is about to invoke
run
on a
Suite
, SuiteCompleted
to indicate a Suite
's
run
method returned normally,
and SuiteAborted
to indicate a Suite
's run
method completed abruptly with an exception.
Similarly, class Suite
fires SuiteStarting
to indicate it is about to invoke
run
on a
nested Suite
, SuiteCompleted
to indicate a nested Suite
's
run
method returned normally,
and SuiteAborted
to indicate a nested Suite
's run
method completed abruptly with an exception.
Although the execution of a Suite
's run
method will likely be a
common event reported via the
SuiteStarting
, SuiteAborted
, and SuiteCompleted
events, because
of the abstract definition of "suite" used by the
event classes, these events are not limited to this use. Information about any conceptual suite
may be reported via the SuiteStarting
, SuiteAborted
, and
SuiteCompleted
events.
Extensibility
You can create classes that extend Reporter
to report test results in custom ways, and to
report custom information passed as an event "payload."
Reporter
classes can handle events in any manner, including doing nothing.
- Source
- Reporter.scala
- Alphabetic
- By Inheritance
- Reporter
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Abstract Value Members
Concrete Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
clone(): AnyRef
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
def
finalize(): Unit
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
-
def
hashCode(): Int
- Definition Classes
- AnyRef → Any
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- AnyRef → Any
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )