org.scalatest

class TestFailedException

[source: org/scalatest/TestFailedException.scala]

class TestFailedException(val message : scala.Option[java.lang.String], val cause : scala.Option[java.lang.Throwable], val failedTestCodeStackDepth : Int)
extends java.lang.RuntimeException with AnyRef
Exception that indicates a test failed. The purpose of this exception is to encapsulate information about the stack depth at which the line of test code that failed resides, so that information can be presented to the user that makes it quick to find the failing line of test code. (I.e., the user need not scan through the stack trace to find the correct filename and line number of the failing test.)
Parameters
message - an optional detail message for this TestFailedException.
cause - an optional cause, the Throwable that caused this TestFailedException to be thrown.
failedTestCodeStackDepth - the depth in the stack trace of this exception at which the line of test code that failed resides.
Throws
NullPointerException - if message is null, or Some(null).
NullPointerException - if cause is null, or Some(null).
Author
Bill Venners
Direct Known Subclasses:
PropertyTestFailedException

Additional Constructor Summary
def this (message : java.lang.String, failedTestCodeStackDepth : Int) : TestFailedException
Create a TestFailedException with a specified stack depth and detail message.
def this (message : java.lang.String, cause : java.lang.Throwable, failedTestCodeStackDepth : Int) : TestFailedException
Create a TestFailedException with the specified stack depth, detail message, and cause.
def this (failedTestCodeStackDepth : Int) : TestFailedException
Create a TestFailedException with specified stack depth and no detail message or cause.
def this (cause : java.lang.Throwable, failedTestCodeStackDepth : Int) : TestFailedException
Create a TestFailedException with the specified stack depth and cause. The message field of this exception object will be initialized to if (cause.getMessage == null) "" else cause.getMessage.
Value Summary
val failedTestCodeFileNameAndLineNumberString : scala.Option[java.lang.String]
A string that provides the filename and line number of the line of test code that failed, suitable for presenting to a user, which is taken from this exception's StackTraceElement at the depth specified by failedTestCodeStackDepth.
Method Summary
override def initCause (throwable : java.lang.Throwable) : java.lang.Throwable
Methods inherited from java.lang.Throwable
java.lang.Throwable.getMessage, java.lang.Throwable.getLocalizedMessage, java.lang.Throwable.getCause, java.lang.Throwable.toString, java.lang.Throwable.printStackTrace, java.lang.Throwable.printStackTrace, java.lang.Throwable.printStackTrace, java.lang.Throwable.fillInStackTrace, java.lang.Throwable.getStackTrace, java.lang.Throwable.setStackTrace
Methods inherited from AnyRef
getClass, hashCode, equals, clone, notify, notifyAll, wait, wait, wait, finalize, ==, !=, eq, ne, synchronized
Methods inherited from Any
==, !=, isInstanceOf, asInstanceOf
Additional Constructor Details
def this(failedTestCodeStackDepth : Int) : TestFailedException
Create a TestFailedException with specified stack depth and no detail message or cause.
Parameters
failedTestCodeStackDepth - the depth in the stack trace of this exception at which the line of test code that failed resides.

def this(message : java.lang.String, failedTestCodeStackDepth : Int) : TestFailedException
Create a TestFailedException with a specified stack depth and detail message.
Parameters
message - A detail message for this TestFailedException.
failedTestCodeStackDepth - the depth in the stack trace of this exception at which the line of test code that failed resides.
Throws
NullPointerException - if message is null.

def this(cause : java.lang.Throwable, failedTestCodeStackDepth : Int) : TestFailedException
Create a TestFailedException with the specified stack depth and cause. The message field of this exception object will be initialized to if (cause.getMessage == null) "" else cause.getMessage.
Parameters
cause - the cause, the Throwable that caused this TestFailedException to be thrown.
failedTestCodeStackDepth - the depth in the stack trace of this exception at which the line of test code that failed resides.
Throws
NullPointerException - if cause is null.

def this(message : java.lang.String, cause : java.lang.Throwable, failedTestCodeStackDepth : Int) : TestFailedException
Create a TestFailedException with the specified stack depth, detail message, and cause.

Note that the detail message associated with cause is not automatically incorporated in this throwable's detail message.

Parameters
message - A detail message for this TestFailedException.
cause - the cause, the Throwable that caused this TestFailedException to be thrown.
failedTestCodeStackDepth - the depth in the stack trace of this exception at which the line of test code that failed resides.
Throws
NullPointerException - if message is null.
NullPointerException - if cause is null.

Value Details
val failedTestCodeFileNameAndLineNumberString : scala.Option[java.lang.String]
A string that provides the filename and line number of the line of test code that failed, suitable for presenting to a user, which is taken from this exception's StackTraceElement at the depth specified by failedTestCodeStackDepth.
Returns
a user-presentable string containing the filename and line number that caused the failed test

Method Details
override def initCause(throwable : java.lang.Throwable) : java.lang.Throwable


Copyright (C) 2001-2009 Artima, Inc. All rights reserved.