public class Assert
extends java.lang.Object
Modifier and Type | Class and Description |
---|---|
static interface |
Assert.ThrowingRunnable
This interface facilitates the use of
expectThrows(java.lang.Class<T>, org.testng.Assert.ThrowingRunnable) from Java 8. |
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
ARRAY_MISMATCH_TEMPLATE |
Modifier | Constructor and Description |
---|---|
protected |
Assert()
Protect constructor since it is a static only class
|
Modifier and Type | Method and Description |
---|---|
static void |
assertEquals(boolean[] actual,
boolean[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(boolean[] actual,
boolean[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(boolean actual,
boolean expected)
Asserts that two booleans are equal.
|
static void |
assertEquals(boolean actual,
boolean expected,
java.lang.String message)
Asserts that two booleans are equal.
|
static void |
assertEquals(byte[] actual,
byte[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(byte[] actual,
byte[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(byte actual,
byte expected)
Asserts that two bytes are equal.
|
static void |
assertEquals(byte actual,
byte expected,
java.lang.String message)
Asserts that two bytes are equal.
|
static void |
assertEquals(char[] actual,
char[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(char[] actual,
char[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(char actual,
char expected)
Asserts that two chars are equal.
|
static void |
assertEquals(char actual,
char expected,
java.lang.String message)
Asserts that two chars are equal.
|
static void |
assertEquals(java.util.Collection<?> actual,
java.util.Collection<?> expected)
Asserts that two collections contain the same elements in the same order.
|
static void |
assertEquals(java.util.Collection<?> actual,
java.util.Collection<?> expected,
java.lang.String message)
Asserts that two collections contain the same elements in the same order.
|
static void |
assertEquals(double[] actual,
double[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(double[] actual,
double[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(double actual,
double expected,
double delta)
Asserts that two doubles are equal concerning a delta.
|
static void |
assertEquals(double actual,
double expected,
double delta,
java.lang.String message)
Asserts that two doubles are equal concerning a delta.
|
static void |
assertEquals(float[] actual,
float[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(float[] actual,
float[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(float actual,
float expected,
float delta)
Asserts that two floats are equal concerning a delta.
|
static void |
assertEquals(float actual,
float expected,
float delta,
java.lang.String message)
Asserts that two floats are equal concerning a delta.
|
static void |
assertEquals(int[] actual,
int[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(int[] actual,
int[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(int actual,
int expected)
Asserts that two ints are equal.
|
static void |
assertEquals(int actual,
int expected,
java.lang.String message)
Asserts that two ints are equal.
|
static void |
assertEquals(java.lang.Iterable<?> actual,
java.lang.Iterable<?> expected)
Asserts that two iterables return iterators with the same elements in the same order.
|
static void |
assertEquals(java.lang.Iterable<?> actual,
java.lang.Iterable<?> expected,
java.lang.String message)
Asserts that two iterables return iterators with the same elements in the same order.
|
static void |
assertEquals(java.util.Iterator<?> actual,
java.util.Iterator<?> expected)
Asserts that two iterators return the same elements in the same order.
|
static void |
assertEquals(java.util.Iterator<?> actual,
java.util.Iterator<?> expected,
java.lang.String message)
Asserts that two iterators return the same elements in the same order.
|
static void |
assertEquals(long[] actual,
long[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(long[] actual,
long[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(long actual,
long expected)
Asserts that two longs are equal.
|
static void |
assertEquals(long actual,
long expected,
java.lang.String message)
Asserts that two longs are equal.
|
static void |
assertEquals(java.util.Map<?,?> actual,
java.util.Map<?,?> expected,
java.lang.String message)
Asserts that two maps are equal.
|
static void |
assertEquals(java.lang.Object[] actual,
java.lang.Object[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(java.lang.Object[] actual,
java.lang.Object[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(java.lang.Object actual,
java.lang.Object expected)
Asserts that two objects are equal.
|
static void |
assertEquals(java.lang.Object actual,
java.lang.Object expected,
java.lang.String message)
Asserts that two objects are equal.
|
static void |
assertEquals(java.util.Set<?> actual,
java.util.Set<?> expected)
Asserts that two sets are equal.
|
static void |
assertEquals(java.util.Set<?> actual,
java.util.Set<?> expected,
java.lang.String message)
Assert set equals
|
static void |
assertEquals(short[] actual,
short[] expected)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(short[] actual,
short[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in the same order.
|
static void |
assertEquals(short actual,
short expected)
Asserts that two shorts are equal.
|
static void |
assertEquals(short actual,
short expected,
java.lang.String message)
Asserts that two shorts are equal.
|
static void |
assertEquals(java.lang.String actual,
java.lang.String expected)
Asserts that two Strings are equal.
|
static void |
assertEquals(java.lang.String actual,
java.lang.String expected,
java.lang.String message)
Asserts that two Strings are equal.
|
static void |
assertEqualsDeep(java.util.Map<?,?> actual,
java.util.Map<?,?> expected) |
static void |
assertEqualsDeep(java.util.Map<?,?> actual,
java.util.Map<?,?> expected,
java.lang.String message) |
static void |
assertEqualsDeep(java.util.Set<?> actual,
java.util.Set<?> expected,
java.lang.String message) |
static void |
assertEqualsNoOrder(java.lang.Object[] actual,
java.lang.Object[] expected)
Asserts that two arrays contain the same elements in no particular order.
|
static void |
assertEqualsNoOrder(java.lang.Object[] actual,
java.lang.Object[] expected,
java.lang.String message)
Asserts that two arrays contain the same elements in no particular order.
|
static void |
assertFalse(boolean condition)
Asserts that a condition is false.
|
static void |
assertFalse(boolean condition,
java.lang.String message)
Asserts that a condition is false.
|
static void |
assertNotEquals(double actual1,
double actual2,
double delta) |
static void |
assertNotEquals(double actual1,
double actual2,
double delta,
java.lang.String message) |
static void |
assertNotEquals(float actual1,
float actual2,
float delta) |
static void |
assertNotEquals(float actual1,
float actual2,
float delta,
java.lang.String message) |
static void |
assertNotEquals(java.util.Map<?,?> actual,
java.util.Map<?,?> expected) |
static void |
assertNotEquals(java.util.Map<?,?> actual,
java.util.Map<?,?> expected,
java.lang.String message) |
static void |
assertNotEquals(java.lang.Object actual1,
java.lang.Object actual2) |
static void |
assertNotEquals(java.lang.Object actual1,
java.lang.Object actual2,
java.lang.String message) |
static void |
assertNotEquals(java.util.Set<?> actual,
java.util.Set<?> expected) |
static void |
assertNotEquals(java.util.Set<?> actual,
java.util.Set<?> expected,
java.lang.String message) |
static void |
assertNotEqualsDeep(java.util.Map<?,?> actual,
java.util.Map<?,?> expected) |
static void |
assertNotEqualsDeep(java.util.Map<?,?> actual,
java.util.Map<?,?> expected,
java.lang.String message) |
static void |
assertNotEqualsDeep(java.util.Set<?> actual,
java.util.Set<?> expected) |
static void |
assertNotEqualsDeep(java.util.Set<?> actual,
java.util.Set<?> expected,
java.lang.String message) |
static void |
assertNotNull(java.lang.Object object)
Asserts that an object isn't null.
|
static void |
assertNotNull(java.lang.Object object,
java.lang.String message)
Asserts that an object isn't null.
|
static void |
assertNotSame(java.lang.Object actual,
java.lang.Object expected)
Asserts that two objects do not refer to the same object.
|
static void |
assertNotSame(java.lang.Object actual,
java.lang.Object expected,
java.lang.String message)
Asserts that two objects do not refer to the same objects.
|
static void |
assertNull(java.lang.Object object)
Asserts that an object is null.
|
static void |
assertNull(java.lang.Object object,
java.lang.String message)
Asserts that an object is null.
|
static void |
assertSame(java.lang.Object actual,
java.lang.Object expected)
Asserts that two objects refer to the same object.
|
static void |
assertSame(java.lang.Object actual,
java.lang.Object expected,
java.lang.String message)
Asserts that two objects refer to the same object.
|
static void |
assertThrows(Assert.ThrowingRunnable runnable)
Asserts that
runnable throws an exception when invoked. |
static <T extends java.lang.Throwable> |
assertThrows(java.lang.Class<T> throwableClass,
Assert.ThrowingRunnable runnable)
Asserts that
runnable throws an exception of type throwableClass when
executed. |
static void |
assertTrue(boolean condition)
Asserts that a condition is true.
|
static void |
assertTrue(boolean condition,
java.lang.String message)
Asserts that a condition is true.
|
static <T extends java.lang.Throwable> |
expectThrows(java.lang.Class<T> throwableClass,
Assert.ThrowingRunnable runnable)
Asserts that
runnable throws an exception of type throwableClass when
executed and returns the exception. |
static void |
fail()
Fails a test with no message.
|
static void |
fail(java.lang.String message)
Fails a test with the given message.
|
static void |
fail(java.lang.String message,
java.lang.Throwable realCause)
Fails a test with the given message and wrapping the original exception.
|
public static final java.lang.String ARRAY_MISMATCH_TEMPLATE
public static void assertTrue(boolean condition, java.lang.String message)
condition
- the condition to evaluatemessage
- the assertion error messagepublic static void assertTrue(boolean condition)
condition
- the condition to evaluatepublic static void assertFalse(boolean condition, java.lang.String message)
condition
- the condition to evaluatemessage
- the assertion error messagepublic static void assertFalse(boolean condition)
condition
- the condition to evaluatepublic static void fail(java.lang.String message, java.lang.Throwable realCause)
message
- the assertion error messagerealCause
- the original exceptionpublic static void fail(java.lang.String message)
message
- the assertion error messagepublic static void fail()
public static void assertEquals(java.lang.Object actual, java.lang.Object expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(byte[] actual, byte[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(byte[] actual, byte[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(short[] actual, short[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(short[] actual, short[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(int[] actual, int[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(int[] actual, int[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(boolean[] actual, boolean[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(boolean[] actual, boolean[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(char[] actual, char[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(char[] actual, char[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(float[] actual, float[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(float[] actual, float[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(double[] actual, double[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(double[] actual, double[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(long[] actual, long[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(long[] actual, long[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(java.lang.Object actual, java.lang.Object expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(java.lang.String actual, java.lang.String expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(java.lang.String actual, java.lang.String expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(double actual, double expected, double delta, java.lang.String message)
actual
- the actual valueexpected
- the expected valuedelta
- the absolute tolerable difference between the actual and expected valuesmessage
- the assertion error messagepublic static void assertEquals(double actual, double expected, double delta)
actual
- the actual valueexpected
- the expected valuedelta
- the absolute tolerable difference between the actual and expected valuespublic static void assertEquals(float actual, float expected, float delta, java.lang.String message)
actual
- the actual valueexpected
- the expected valuedelta
- the absolute tolerable difference between the actual and expected valuesmessage
- the assertion error messagepublic static void assertEquals(float actual, float expected, float delta)
actual
- the actual valueexpected
- the expected valuedelta
- the absolute tolerable difference between the actual and expected valuespublic static void assertEquals(long actual, long expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(long actual, long expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(boolean actual, boolean expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(boolean actual, boolean expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(byte actual, byte expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(byte actual, byte expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(char actual, char expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(char actual, char expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(short actual, short expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(short actual, short expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(int actual, int expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(int actual, int expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertNotNull(java.lang.Object object)
object
- the assertion objectpublic static void assertNotNull(java.lang.Object object, java.lang.String message)
object
- the assertion objectmessage
- the assertion error messagepublic static void assertNull(java.lang.Object object)
object
- the assertion objectpublic static void assertNull(java.lang.Object object, java.lang.String message)
object
- the assertion objectmessage
- the assertion error messagepublic static void assertSame(java.lang.Object actual, java.lang.Object expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertSame(java.lang.Object actual, java.lang.Object expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertNotSame(java.lang.Object actual, java.lang.Object expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertNotSame(java.lang.Object actual, java.lang.Object expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(java.util.Collection<?> actual, java.util.Collection<?> expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(java.util.Collection<?> actual, java.util.Collection<?> expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(java.util.Iterator<?> actual, java.util.Iterator<?> expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(java.util.Iterator<?> actual, java.util.Iterator<?> expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(java.lang.Iterable<?> actual, java.lang.Iterable<?> expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(java.lang.Iterable<?> actual, java.lang.Iterable<?> expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(java.lang.Object[] actual, java.lang.Object[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEqualsNoOrder(java.lang.Object[] actual, java.lang.Object[] expected, java.lang.String message)
actual
- the actual valueexpected
- the expected valuemessage
- the assertion error messagepublic static void assertEquals(java.lang.Object[] actual, java.lang.Object[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEqualsNoOrder(java.lang.Object[] actual, java.lang.Object[] expected)
actual
- the actual valueexpected
- the expected valuepublic static void assertEquals(java.util.Set<?> actual, java.util.Set<?> expected)
public static void assertEquals(java.util.Set<?> actual, java.util.Set<?> expected, java.lang.String message)
public static void assertEqualsDeep(java.util.Set<?> actual, java.util.Set<?> expected, java.lang.String message)
public static void assertEquals(java.util.Map<?,?> actual, java.util.Map<?,?> expected, java.lang.String message)
public static void assertEqualsDeep(java.util.Map<?,?> actual, java.util.Map<?,?> expected)
public static void assertEqualsDeep(java.util.Map<?,?> actual, java.util.Map<?,?> expected, java.lang.String message)
public static void assertNotEquals(java.lang.Object actual1, java.lang.Object actual2, java.lang.String message)
public static void assertNotEquals(java.lang.Object actual1, java.lang.Object actual2)
public static void assertNotEquals(float actual1, float actual2, float delta, java.lang.String message)
public static void assertNotEquals(float actual1, float actual2, float delta)
public static void assertNotEquals(double actual1, double actual2, double delta, java.lang.String message)
public static void assertNotEquals(java.util.Set<?> actual, java.util.Set<?> expected)
public static void assertNotEquals(java.util.Set<?> actual, java.util.Set<?> expected, java.lang.String message)
public static void assertNotEqualsDeep(java.util.Set<?> actual, java.util.Set<?> expected)
public static void assertNotEqualsDeep(java.util.Set<?> actual, java.util.Set<?> expected, java.lang.String message)
public static void assertNotEquals(java.util.Map<?,?> actual, java.util.Map<?,?> expected)
public static void assertNotEquals(java.util.Map<?,?> actual, java.util.Map<?,?> expected, java.lang.String message)
public static void assertNotEqualsDeep(java.util.Map<?,?> actual, java.util.Map<?,?> expected)
public static void assertNotEqualsDeep(java.util.Map<?,?> actual, java.util.Map<?,?> expected, java.lang.String message)
public static void assertNotEquals(double actual1, double actual2, double delta)
public static void assertThrows(Assert.ThrowingRunnable runnable)
runnable
throws an exception when invoked. If it does not, an
AssertionError
is thrown.runnable
- A function that is expected to throw an exception when invokedpublic static <T extends java.lang.Throwable> void assertThrows(java.lang.Class<T> throwableClass, Assert.ThrowingRunnable runnable)
runnable
throws an exception of type throwableClass
when
executed. If it does not throw an exception, an AssertionError
is thrown. If it
throws the wrong type of exception, an AssertionError
is thrown describing the
mismatch; the exception that was actually thrown can be obtained by calling Throwable.getCause()
.throwableClass
- the expected type of the exceptionrunnable
- A function that is expected to throw an exception when invokedpublic static <T extends java.lang.Throwable> T expectThrows(java.lang.Class<T> throwableClass, Assert.ThrowingRunnable runnable)
runnable
throws an exception of type throwableClass
when
executed and returns the exception. If runnable
does not throw an exception, an
AssertionError
is thrown. If it throws the wrong type of exception, an AssertionError
is thrown describing the mismatch; the exception that was actually thrown can
be obtained by calling Throwable.getCause()
.throwableClass
- the expected type of the exceptionrunnable
- A function that is expected to throw an exception when invokedrunnable