c

org.scalatest.events

SuiteAborted

final case class SuiteAborted(ordinal: Ordinal, message: String, suiteName: String, suiteId: String, suiteClassName: Option[String], throwable: Option[Throwable] = None, duration: Option[Long] = None, formatter: Option[Formatter] = None, location: Option[Location] = None, rerunner: Option[String] = None, payload: Option[Any] = None, threadName: String = Thread.currentThread.getName, timeStamp: Long = new Date).getTime) extends Event with ExceptionalEvent with Product with Serializable

Event that indicates the execution of a suite of tests has aborted, likely because of an error, prior to completion.

For example, trait Suite and object Runner use SuiteAborted to report that the execute method of a Suite has completed abruptly with a RuntimeException.

To create instances of this class you may use the factory method. For example, given a report function named report, you could fire a SuiteAborted event like this:

report(SuiteAborted(ordinal, userFriendlyName, message, suiteName, Some(thisSuite.getClass.getName)))

The suite class name parameter is optional, because suites in ScalaTest are an abstraction that need not necessarily correspond to one class. Nevertheless, in most cases each suite will correspond to a class, and when it does, the fully qualified name of that class should be reported by passing a Some for suiteClassName. One use for this bit of information is JUnit integration, because the "name" provided to a JUnit org.junit.runner.Description appears to usually include a fully qualified class name by convention.

ordinal

an Ordinal that can be used to place this event in order in the context of other events reported during the same run suite name, suitable for presenting to the user

message

a localized message suitable for presenting to the user

suiteName

a localized name identifying the suite that has aborted, suitable for presenting to the user

suiteId

a string ID for the suite that has aborted, intended to be unique across all suites in a run

suiteClassName

  an optional fully qualifed Suite class name containing the suite that has aborted

throwable

an optional Throwable that, if a Some, indicates why the suite has aborted, or a Throwable created to capture stack trace information about the problem.

duration

an optional amount of time, in milliseconds, that was required to execute the suite that has aborted

formatter

an optional Formatter that provides extra information that can be used by reporters in determining how to present this event to the user

location

an optional Location that provides information indicating where in the source code an event originated.

rerunner

an optional String giving the fully qualified name of the class that can be used to rerun the suite that has aborted. (If None is passed, the suite cannot be rerun.)

payload

an optional object that can be used to pass custom information to the reporter about the SuiteAborted event

threadName

a name for the Thread about whose activity this event was reported

timeStamp

a Long indicating the time this event was reported, expressed in terms of the number of milliseconds since the standard base time known as "the epoch": January 1, 1970, 00:00:00 GMT

Source
Event.scala
Linear Supertypes
ExceptionalEvent, Event, Serializable, Serializable, Product, Equals, Ordered[Event], Comparable[Event], AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. SuiteAborted
  2. ExceptionalEvent
  3. Event
  4. Serializable
  5. Serializable
  6. Product
  7. Equals
  8. Ordered
  9. Comparable
  10. AnyRef
  11. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new SuiteAborted(ordinal: Ordinal, message: String, suiteName: String, suiteId: String, suiteClassName: Option[String], throwable: Option[Throwable] = None, duration: Option[Long] = None, formatter: Option[Formatter] = None, location: Option[Location] = None, rerunner: Option[String] = None, payload: Option[Any] = None, threadName: String = Thread.currentThread.getName, timeStamp: Long = new Date).getTime)

    ordinal

    an Ordinal that can be used to place this event in order in the context of other events reported during the same run suite name, suitable for presenting to the user

    message

    a localized message suitable for presenting to the user

    suiteName

    a localized name identifying the suite that has aborted, suitable for presenting to the user

    suiteId

    a string ID for the suite that has aborted, intended to be unique across all suites in a run

    suiteClassName

      an optional fully qualifed Suite class name containing the suite that has aborted

    throwable

    an optional Throwable that, if a Some, indicates why the suite has aborted, or a Throwable created to capture stack trace information about the problem.

    duration

    an optional amount of time, in milliseconds, that was required to execute the suite that has aborted

    formatter

    an optional Formatter that provides extra information that can be used by reporters in determining how to present this event to the user

    location

    an optional Location that provides information indicating where in the source code an event originated.

    rerunner

    an optional String giving the fully qualified name of the class that can be used to rerun the suite that has aborted. (If None is passed, the suite cannot be rerun.)

    payload

    an optional object that can be used to pass custom information to the reporter about the SuiteAborted event

    threadName

    a name for the Thread about whose activity this event was reported

    timeStamp

    a Long indicating the time this event was reported, expressed in terms of the number of milliseconds since the standard base time known as "the epoch": January 1, 1970, 00:00:00 GMT

Value Members

  1. def <(that: Event): Boolean
    Definition Classes
    Ordered
  2. def <=(that: Event): Boolean
    Definition Classes
    Ordered
  3. def >(that: Event): Boolean
    Definition Classes
    Ordered
  4. def >=(that: Event): Boolean
    Definition Classes
    Ordered
  5. def compare(that: Event): Int

    Comparing this event with the event passed as that.

    Comparing this event with the event passed as that. Returns x, where x < 0 iff this < that, x == 0 iff this == that, x > 0 iff this > that.

    that

    the event to compare to this event

    Definition Classes
    Event → Ordered
  6. def compareTo(that: Event): Int
    Definition Classes
    Ordered → Comparable
  7. val duration: Option[Long]
  8. val formatter: Option[Formatter]
    Definition Classes
    SuiteAborted → Event
  9. val location: Option[Location]
    Definition Classes
    SuiteAborted → Event
  10. val message: String
  11. val ordinal: Ordinal
    Definition Classes
    SuiteAborted → Event
  12. val payload: Option[Any]
    Definition Classes
    SuiteAborted → Event
  13. val rerunner: Option[String]
  14. val suiteClassName: Option[String]
  15. val suiteId: String
  16. val suiteName: String
  17. val threadName: String
    Definition Classes
    SuiteAborted → Event
  18. val throwable: Option[Throwable]
  19. val timeStamp: Long
    Definition Classes
    SuiteAborted → Event