Package org.testng
Class Assert
java.lang.Object
org.testng.Assert
Assertion tool class. Presents assertion methods with a more natural parameter order. The order
is always actualValue, expectedValue [, message].
Important: Assertion methods comparing two values for equality, such as
assertEquals, are only intended to test equality for an actual and an (un-)expected
result value. They are not designed for testing whether a class correctly implements
equals(Object). For example assertEquals might return fast when provided with the same
object as actual and expected value without calling equals(Object) at all. Such tests
trying to verify the equals(Object) implementation should instead be written explicitly
and assertTrue or assertFalse should
be used to verify the result, e.g.: assertTrue(var.equals(var)),
assertFalse(var.equals(null)).
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic interfaceThis interface facilitates the use ofexpectThrows(java.lang.Class<T>, org.testng.Assert.ThrowingRunnable)from Java 8. -
Field Summary
Fields -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedAssert()Protect constructor since it is a static only class -
Method Summary
Modifier and TypeMethodDescriptionprivate static booleanareArraysEqual(Object actual, Object expected) private static booleanareEqual(double actual, double expected, double delta) private static booleanareEqual(float actual, float expected, float delta) private static booleanprivate static booleanareEqualImpl(Object actual, Object expected) private static booleanareNotEqualImpl(Object actual, Object expected) private static voidassertArrayEquals(Object actual, Object expected, String message) private static voidassertArrayNotEquals(Object actual, Object expected, String message) static voidassertEquals(boolean[] actual, boolean[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(boolean[] actual, boolean[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(boolean actual, boolean expected) Asserts that two booleans are equal.static voidassertEquals(boolean actual, boolean expected, String message) Asserts that two booleans are equal.static voidassertEquals(boolean actual, Boolean expected) Asserts that two booleans are equal.static voidassertEquals(boolean actual, Boolean expected, String message) Asserts that two booleans are equal.static voidassertEquals(byte[] actual, byte[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(byte[] actual, byte[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(byte actual, byte expected) Asserts that two bytes are equal.static voidassertEquals(byte actual, byte expected, String message) Asserts that two bytes are equal.static voidassertEquals(byte actual, Byte expected) Asserts that two bytes are equal.static voidassertEquals(byte actual, Byte expected, String message) Asserts that two bytes are equal.static voidassertEquals(char[] actual, char[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(char[] actual, char[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(char actual, char expected) Asserts that two chars are equal.static voidassertEquals(char actual, char expected, String message) Asserts that two chars are equal.static voidassertEquals(char actual, Character expected) Asserts that two chars are equal.static voidassertEquals(char actual, Character expected, String message) Asserts that two chars are equal.static voidassertEquals(double[] actual, double[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(double[] actual, double[] expected, double delta) Asserts that two arrays contain the equal elements concerning a delta in the same order.static voidassertEquals(double[] actual, double[] expected, double delta, String message) Asserts that two arrays contain the equal elements concerning a delta in the same order.static voidassertEquals(double[] actual, double[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(double actual, double expected) Asserts that two doubles are equal.static voidassertEquals(double actual, double expected, double delta) Asserts that two doubles are equal concerning a delta.static voidassertEquals(double actual, double expected, double delta, String message) Asserts that two doubles are equal concerning a delta.static voidassertEquals(double actual, double expected, String message) Asserts that two doubles are equal.static voidassertEquals(double actual, Double expected) Asserts that two doubles are equal.static voidassertEquals(double actual, Double expected, String message) Asserts that two doubles are equal.static voidassertEquals(float[] actual, float[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(float[] actual, float[] expected, float delta) Asserts that two arrays contain the equal elements concerning a delta in the same order.static voidassertEquals(float[] actual, float[] expected, float delta, String message) Asserts that two arrays contain the equal elements concerning a delta in the same order.static voidassertEquals(float[] actual, float[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(float actual, float expected) Asserts that two floats are equal.static voidassertEquals(float actual, float expected, float delta) Asserts that two floats are equal concerning a delta.static voidassertEquals(float actual, float expected, float delta, String message) Asserts that two floats are equal concerning a delta.static voidassertEquals(float actual, float expected, String message) Asserts that two floats are equal.static voidassertEquals(float actual, Float expected) Asserts that two floats are equal.static voidassertEquals(float actual, Float expected, String message) Asserts that two floats are equal.static voidassertEquals(int[] actual, int[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(int[] actual, int[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(int actual, int expected) Asserts that two ints are equal.static voidassertEquals(int actual, int expected, String message) Asserts that two ints are equal.static voidassertEquals(int actual, Integer expected) Asserts that two ints are equal.static voidassertEquals(int actual, Integer expected, String message) Asserts that two ints are equal.static voidassertEquals(long[] actual, long[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(long[] actual, long[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(long actual, long expected) Asserts that two longs are equal.static voidassertEquals(long actual, long expected, String message) Asserts that two longs are equal.static voidassertEquals(long actual, Long expected) Asserts that two longs are equal.static voidassertEquals(short[] actual, short[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(short[] actual, short[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(short actual, short expected) Asserts that two shorts are equal.static voidassertEquals(short actual, short expected, String message) Asserts that two shorts are equal.static voidassertEquals(short actual, Short expected) Asserts that two shorts are equal.static voidassertEquals(short actual, Short expected, String message) Asserts that two shorts are equal.static voidassertEquals(Boolean actual, boolean expected) Asserts that two booleans are equal.static voidassertEquals(Boolean actual, boolean expected, String message) Asserts that two booleans are equal.static voidassertEquals(Boolean actual, Boolean expected) Asserts that two booleans are equal.static voidassertEquals(Boolean actual, Boolean expected, String message) Asserts that two booleans are equal.static voidassertEquals(Byte actual, byte expected) Asserts that two bytes are equal.static voidassertEquals(Byte actual, byte expected, String message) Asserts that two bytes are equal.static voidassertEquals(Byte actual, Byte expected) Asserts that two bytes are equal.static voidassertEquals(Byte actual, Byte expected, String message) Asserts that two bytes are equal.static voidassertEquals(Character actual, char expected) Asserts that two chars are equal.static voidassertEquals(Character actual, char expected, String message) Asserts that two chars are equal.static voidassertEquals(Character actual, Character expected) Asserts that two chars are equal.static voidassertEquals(Character actual, Character expected, String message) Asserts that two chars are equal.static voidassertEquals(Double actual, double expected) Asserts that two doubles are equal.static voidassertEquals(Double actual, double expected, String message) Asserts that two doubles are equal.static voidassertEquals(Double actual, Double expected) Asserts that two doubles are equal.static voidassertEquals(Double actual, Double expected, String message) Asserts that two doubles are equal.static voidassertEquals(Float actual, float expected) Asserts that two floats are equal.static voidassertEquals(Float actual, float expected, String message) Asserts that two floats are equal.static voidassertEquals(Float actual, Float expected) Asserts that two floats are equal.static voidassertEquals(Float actual, Float expected, String message) Asserts that two floats are equal.static voidassertEquals(Integer actual, int expected) Asserts that two ints are equal.static voidassertEquals(Integer actual, int expected, String message) Asserts that two ints are equal.static voidassertEquals(Integer actual, Integer expected) Asserts that two ints are equal.static voidassertEquals(Integer actual, Integer expected, String message) Asserts that two ints are equal.static voidassertEquals(Iterable<?> actual, Iterable<?> expected) Asserts that two iterables return iterators with the same elements in the same order.static voidassertEquals(Iterable<?> actual, Iterable<?> expected, String message) Asserts that two iterables return iterators with the same elements in the same order.static voidassertEquals(Long actual, long expected) Asserts that two longs are equal.static voidassertEquals(Long actual, long expected, String message) Asserts that two longs are equal.static voidassertEquals(Long actual, Long expected) Asserts that two longs are equal.static voidassertEquals(Long actual, Long expected, String message) Asserts that two longs are equal.static voidassertEquals(Object[] actual, Object[] expected) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(Object[] actual, Object[] expected, String message) Asserts that two arrays contain the same elements in the same order.static voidassertEquals(Object actual, Object expected) Asserts that two objects are equal.static voidassertEquals(Object actual, Object expected, String message) Asserts that two objects are equal.static voidassertEquals(Short actual, short expected) Asserts that two shorts are equal.static voidassertEquals(Short actual, short expected, String message) Asserts that two shorts are equal.static voidassertEquals(Short actual, Short expected) Asserts that two shorts are equal.static voidassertEquals(Short actual, Short expected, String message) Asserts that two shorts are equal.static voidassertEquals(String actual, String expected) Asserts that two Strings are equal.static voidassertEquals(String actual, String expected, String message) Asserts that two Strings are equal.static voidassertEquals(Collection<?> actual, Collection<?> expected) Asserts that two collections contain the same elements in the same order.static voidassertEquals(Collection<?> actual, Collection<?> expected, String message) Asserts that two collections contain the same elements in the same order.static voidassertEquals(Iterator<?> actual, Iterator<?> expected) Asserts that two iterators return the same elements in the same order.static voidassertEquals(Iterator<?> actual, Iterator<?> expected, String message) Asserts that two iterators return the same elements in the same order.static voidassertEquals(Map<?, ?> actual, Map<?, ?> expected) static voidassertEquals(Map<?, ?> actual, Map<?, ?> expected, String message) Asserts that two maps are equal.static voidassertEquals(Set<?> actual, Set<?> expected) Asserts that two sets are equal.static voidassertEquals(Set<?> actual, Set<?> expected, String message) Assert set equalsstatic voidassertEqualsDeep(Map<?, ?> actual, Map<?, ?> expected) static voidassertEqualsDeep(Map<?, ?> actual, Map<?, ?> expected, String message) static voidassertEqualsDeep(Set<?> actual, Set<?> expected, String message) private static voidassertEqualsImpl(Object actual, Object expected, String message) Differs fromassertEquals(Object, Object, String)by not taking arrays into special consideration hence comparing them by reference.static voidassertEqualsNoOrder(Object[] actual, Object[] expected) Asserts that two arrays contain the same elements in no particular order.static voidassertEqualsNoOrder(Object[] actual, Object[] expected, String message) Asserts that two arrays contain the same elements in no particular order.static voidassertEqualsNoOrder(Collection<?> actual, Collection<?> expected) Asserts that two collection contain the same elements in no particular order.static voidassertEqualsNoOrder(Collection<?> actual, Collection<?> expected, String message) Asserts that two collection contain the same elements in no particular order.static voidassertEqualsNoOrder(Iterator<?> actual, Iterator<?> expected) Asserts that two iterators contain the same elements in no particular order.static voidassertEqualsNoOrder(Iterator<?> actual, Iterator<?> expected, String message) Asserts that two iterators contain the same elements in no particular order.static voidassertFalse(boolean condition) Asserts that a condition is false.static voidassertFalse(boolean condition, String message) Asserts that a condition is false.static <T> voidassertListContains(List<T> list, Predicate<T> predicate, String message) Asserts that List contains object by specific Predicate.static <T> voidassertListContainsObject(List<T> list, T object, String message) Asserts that List contains object.static <T> voidassertListNotContains(List<T> list, Predicate<T> predicate, String message) Asserts that List not contains object by specific Predicate.static <T> voidassertListNotContainsObject(List<T> list, T object, String message) Asserts that List not contains object.(package private) static voidassertNotEquals(boolean actual, boolean expected) (package private) static voidassertNotEquals(boolean actual, boolean expected, String message) (package private) static voidassertNotEquals(byte actual, byte expected) (package private) static voidassertNotEquals(byte actual, byte expected, String message) (package private) static voidassertNotEquals(char actual, char expected) (package private) static voidassertNotEquals(char actual, char expected, String message) static voidassertNotEquals(double actual, double expected, double delta) static voidassertNotEquals(double actual, double expected, double delta, String message) static voidassertNotEquals(float actual, float expected, float delta) static voidassertNotEquals(float actual, float expected, float delta, String message) (package private) static voidassertNotEquals(int actual, int expected) (package private) static voidassertNotEquals(int actual, int expected, String message) (package private) static voidassertNotEquals(long actual, long expected) (package private) static voidassertNotEquals(long actual, long expected, String message) (package private) static voidassertNotEquals(short actual, short expected) (package private) static voidassertNotEquals(short actual, short expected, String message) static voidassertNotEquals(Object[] actual, Object[] expected, String message) static voidassertNotEquals(Object actual, Object expected) static voidassertNotEquals(Object actual, Object expected, String message) (package private) static voidassertNotEquals(String actual, String expectec) (package private) static voidassertNotEquals(String actual, String expected, String message) static voidassertNotEquals(Collection<?> actual, Collection<?> expected) static voidassertNotEquals(Collection<?> actual, Collection<?> expected, String message) static voidassertNotEquals(Iterator<?> actual, Iterator<?> expected) static voidassertNotEquals(Iterator<?> actual, Iterator<?> expected, String message) static voidassertNotEquals(Map<?, ?> actual, Map<?, ?> expected) static voidassertNotEquals(Map<?, ?> actual, Map<?, ?> expected, String message) static voidassertNotEquals(Set<?> actual, Set<?> expected) static voidassertNotEquals(Set<?> actual, Set<?> expected, String message) static voidassertNotEqualsDeep(Map<?, ?> actual, Map<?, ?> expected) static voidassertNotEqualsDeep(Map<?, ?> actual, Map<?, ?> expected, String message) static voidassertNotEqualsDeep(Set<?> actual, Set<?> expected) static voidassertNotEqualsDeep(Set<?> actual, Set<?> expected, String message) private static voidassertNotEqualsImpl(Object actual, Object expected, String message) static voidassertNotNull(Object object) Asserts that an object isn't null.static voidassertNotNull(Object object, String message) Asserts that an object isn't null.static voidassertNotSame(Object actual, Object expected) Asserts that two objects do not refer to the same object.static voidassertNotSame(Object actual, Object expected, String message) Asserts that two objects do not refer to the same objects.static voidassertNull(Object object) Asserts that an object is null.static voidassertNull(Object object, String message) Asserts that an object is null.static voidassertSame(Object actual, Object expected) Asserts that two objects refer to the same object.static voidassertSame(Object actual, Object expected, String message) Asserts that two objects refer to the same object.static <T extends Throwable>
voidassertThrows(Class<T> throwableClass, Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception of typethrowableClasswhen executed.static <T extends Throwable>
voidassertThrows(String message, Class<T> throwableClass, Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception of typethrowableClasswhen executed.static voidassertThrows(Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception when invoked.static voidassertTrue(boolean condition) Asserts that a condition is true.static voidassertTrue(boolean condition, String message) Asserts that a condition is true.private static booleancheckRefEqualityAndLength(Object actualArray, Object expectedArray, String message) This methods check referential equality of given arguments as well as references length (assuming they are arrays).static <T extends Throwable>
TexpectThrows(Class<T> throwableClass, Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception of typethrowableClasswhen executed and returns the exception.static <T extends Throwable>
TexpectThrows(String message, Class<T> throwableClass, Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception of typethrowableClasswhen executed and returns the exception.static voidfail()Fails a test with no message.static voidFails a test with the given message.static voidFails a test with the given message and wrapping the original exception.private static voidfailAssertNoEqual(String defaultMessage, String message) private static voidfailEquals(Object actual, Object expected, String message) private static voidfailNotEquals(Object actual, Object expected, String message) private static voidfailNotSame(Object actual, Object expected, String message) private static void(package private) static Stringprivate static StringgetArrayNotEqualReason(Object actual, Object expected) returns not equal reason or null if equalprivate static StringgetNotEqualDeepReason(Map<?, ?> actual, Map<?, ?> expected) returns not equal deep reason or null if equalprivate static StringgetNotEqualDeepReason(Set<?> actual, Set<?> expected) returns not equal deep reason or null if equalprivate static StringgetNotEqualReason(Collection<?> actual, Collection<?> expected) returns not equal reason or null if equalprivate static StringgetNotEqualReason(Iterator<?> actual, Iterator<?> expected) private static StringgetNotEqualReason(Map<?, ?> actual, Map<?, ?> expected) private static StringgetNotEqualReason(Set<?> actual, Set<?> expected) private static String
-
Field Details
-
ARRAY_MISMATCH_TEMPLATE
- See Also:
-
-
Constructor Details
-
Assert
protected Assert()Protect constructor since it is a static only class
-
-
Method Details
-
assertTrue
Asserts that a condition is true. If it isn't, an AssertionError, with the given message, is thrown.- Parameters:
condition- the condition to evaluatemessage- the assertion error message
-
assertTrue
public static void assertTrue(boolean condition) Asserts that a condition is true. If it isn't, an AssertionError is thrown.- Parameters:
condition- the condition to evaluate
-
assertFalse
Asserts that a condition is false. If it isn't, an AssertionError, with the given message, is thrown.- Parameters:
condition- the condition to evaluatemessage- the assertion error message
-
assertFalse
public static void assertFalse(boolean condition) Asserts that a condition is false. If it isn't, an AssertionError is thrown.- Parameters:
condition- the condition to evaluate
-
fail
Fails a test with the given message and wrapping the original exception.- Parameters:
message- the assertion error messagerealCause- the original exception
-
fail
Fails a test with the given message.- Parameters:
message- the assertion error message
-
fail
public static void fail()Fails a test with no message. -
assertEquals
Asserts that two objects are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
areEqual
-
assertEqualsImpl
Differs fromassertEquals(Object, Object, String)by not taking arrays into special consideration hence comparing them by reference. Intended to be called directly to test equality of collections content. -
assertNotEqualsImpl
-
areNotEqualImpl
-
areEqualImpl
-
getArrayNotEqualReason
returns not equal reason or null if equal -
areArraysEqual
-
assertArrayEquals
-
assertArrayNotEquals
-
assertEquals
public static void assertEquals(byte[] actual, byte[] expected) Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(short[] actual, short[] expected) Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(int[] actual, int[] expected) Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(boolean[] actual, boolean[] expected) Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(char[] actual, char[] expected) Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(float[] actual, float[] expected) Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(float[] actual, float[] expected, float delta) Asserts that two arrays contain the equal elements concerning a delta in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected valuedelta- the absolute tolerable difference between the actual and expected values
-
assertEquals
Asserts that two arrays contain the equal elements concerning a delta in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected valuedelta- the absolute tolerable difference between the actual and expected valuesmessage- the assertion error message
-
assertEquals
public static void assertEquals(double[] actual, double[] expected) Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(double[] actual, double[] expected, double delta) Asserts that two arrays contain the equal elements concerning a delta in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected valuedelta- the absolute tolerable difference between the actual and expected values
-
assertEquals
Asserts that two arrays contain the equal elements concerning a delta in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuedelta- the absolute tolerable difference between the actual and expected valuesmessage- the assertion error message
-
assertEquals
public static void assertEquals(long[] actual, long[] expected) Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
checkRefEqualityAndLength
private static boolean checkRefEqualityAndLength(Object actualArray, Object expectedArray, String message) This methods check referential equality of given arguments as well as references length (assuming they are arrays). Successful execution of this method guaranties arrays length equality.- Parameters:
actualArray- array of elementsexpectedArray- array of elementsmessage- the assertion error message- Returns:
trueifactualArrayandexpectedArrayare the same,falseotherwise. If references are different and arrays length are differentAssertionErroris thrown.
-
assertEquals
Asserts that two objects are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two Strings are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two Strings are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
areEqual
private static boolean areEqual(double actual, double expected, double delta) -
assertEquals
Asserts that two doubles are equal concerning a delta. If they are not, an AssertionError, with the given message, is thrown. If the expected value is infinity then the delta value is ignored.- Parameters:
actual- the actual valueexpected- the expected valuedelta- the absolute tolerable difference between the actual and expected valuesmessage- the assertion error message
-
assertEquals
public static void assertEquals(double actual, double expected, double delta) Asserts that two doubles are equal concerning a delta. If they are not, an AssertionError is thrown. If the expected value is infinity then the delta value is ignored.- Parameters:
actual- the actual valueexpected- the expected valuedelta- the absolute tolerable difference between the actual and expected values
-
assertEquals
Asserts that two doubles are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two doubles are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two doubles are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two doubles are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(double actual, double expected) Asserts that two doubles are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two doubles are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two doubles are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two doubles are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
areEqual
private static boolean areEqual(float actual, float expected, float delta) -
assertEquals
Asserts that two floats are equal concerning a delta. If they are not, an AssertionError, with the given message, is thrown. If the expected value is infinity then the delta value is ignored.- Parameters:
actual- the actual valueexpected- the expected valuedelta- the absolute tolerable difference between the actual and expected valuesmessage- the assertion error message
-
assertEquals
public static void assertEquals(float actual, float expected, float delta) Asserts that two floats are equal concerning a delta. If they are not, an AssertionError is thrown. If the expected value is infinity then the delta value is ignored.- Parameters:
actual- the actual valueexpected- the expected valuedelta- the absolute tolerable difference between the actual and expected values
-
assertEquals
Asserts that two floats are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two floats are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two floats are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two floats are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(float actual, float expected) Asserts that two floats are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two floats are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two floats are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two floats are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two longs are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two longs are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two longs are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(long actual, long expected) Asserts that two longs are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two longs are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two longs are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two longs are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two booleans are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two booleans are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two booleans are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two booleans are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(boolean actual, boolean expected) Asserts that two booleans are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two booleans are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two booleans are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two booleans are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two bytes are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two bytes are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two bytes are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two bytes are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(byte actual, byte expected) Asserts that two bytes are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two bytes are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two bytes are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two bytes are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two chars are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two chars are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two chars are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two chars are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(char actual, char expected) Asserts that two chars are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two chars are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two chars are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two chars are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two shorts are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two shorts are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two shorts are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two shorts are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(short actual, short expected) Asserts that two shorts are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two shorts are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two shorts are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two shorts are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two ints are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two ints are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two ints are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two ints are equal. If they are not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
public static void assertEquals(int actual, int expected) Asserts that two ints are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two ints are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two ints are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two ints are equal. If they are not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertNotNull
Asserts that an object isn't null. If it is, an AssertionError is thrown.- Parameters:
object- the assertion object
-
assertNotNull
Asserts that an object isn't null. If it is, an AssertionError, with the given message, is thrown.- Parameters:
object- the assertion objectmessage- the assertion error message
-
assertNull
Asserts that an object is null. If it is not, an AssertionError, with the given message, is thrown.- Parameters:
object- the assertion object
-
assertNull
Asserts that an object is null. If it is not, an AssertionError, with the given message, is thrown.- Parameters:
object- the assertion objectmessage- the assertion error message
-
assertSame
Asserts that two objects refer to the same object. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertSame
Asserts that two objects refer to the same object. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertNotSame
Asserts that two objects do not refer to the same objects. If they do, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertNotSame
Asserts that two objects do not refer to the same object. If they do, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
failSame
-
failNotSame
-
failNotEquals
-
failEquals
-
format
-
assertEquals
Asserts that two collections contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two collections contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two iterators return the same elements in the same order. If they do not, an AssertionError is thrown. Please note that this assert iterates over the elements and modifies the state of the iterators.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two iterators return the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown. Please note that this assert iterates over the elements and modifies the state of the iterators.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two iterables return iterators with the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two iterables return iterators with the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEqualsNoOrder
Asserts that two arrays contain the same elements in no particular order. If they do not, anAssertionError, with the given message, is thrown. The arrays are not compared 'deeply', that means, if the elements are arrays as well theirequalsmethod is used which only checks for reference equality.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEqualsNoOrder
public static void assertEqualsNoOrder(Collection<?> actual, Collection<?> expected, String message) Asserts that two collection contain the same elements in no particular order. If they do not, anAssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
assertEqualsNoOrder
Asserts that two iterators contain the same elements in no particular order. If they do not, anAssertionError, with the given message, is thrown.- Parameters:
actual- the actual valueexpected- the expected valuemessage- the assertion error message
-
toString
-
failAssertNoEqual
-
assertEquals
Asserts that two arrays contain the same elements in the same order. If they do not, an AssertionError is thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEqualsNoOrder
Asserts that two arrays contain the same elements in no particular order. If they do not, anAssertionErroris thrown. The arrays are not compared 'deeply', that means, if the elements are arrays as well theirequalsmethod is used which only checks for reference equality.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEqualsNoOrder
Asserts that two collection contain the same elements in no particular order. If they do not, anAssertionErroris thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEqualsNoOrder
Asserts that two iterators contain the same elements in no particular order. If they do not, anAssertionErroris thrown.- Parameters:
actual- the actual valueexpected- the expected value
-
assertEquals
Asserts that two sets are equal.- Parameters:
actual- The actual valueexpected- The expected value
-
getNotEqualReason
returns not equal reason or null if equal -
getNotEqualReason
-
getNotEqualReason
-
assertEquals
Assert set equals- Parameters:
actual- The actual valueexpected- The expected valuemessage- The message
-
getNotEqualDeepReason
returns not equal deep reason or null if equal -
assertEqualsDeep
-
assertEquals
-
getNotEqualReason
-
assertEquals
Asserts that two maps are equal.- Parameters:
actual- The actual valueexpected- The expected valuemessage- The message
-
assertEqualsDeep
-
getNotEqualDeepReason
returns not equal deep reason or null if equal -
assertEqualsDeep
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEquals
static void assertNotEquals(long actual, long expected) -
assertNotEquals
-
assertNotEquals
static void assertNotEquals(boolean actual, boolean expected) -
assertNotEquals
-
assertNotEquals
static void assertNotEquals(byte actual, byte expected) -
assertNotEquals
-
assertNotEquals
static void assertNotEquals(char actual, char expected) -
assertNotEquals
-
assertNotEquals
static void assertNotEquals(short actual, short expected) -
assertNotEquals
-
assertNotEquals
static void assertNotEquals(int actual, int expected) -
assertNotEquals
-
assertNotEquals
public static void assertNotEquals(float actual, float expected, float delta) -
assertNotEquals
-
assertNotEquals
-
assertNotEquals
-
assertNotEqualsDeep
-
assertNotEqualsDeep
-
assertNotEquals
-
assertNotEquals
-
assertNotEqualsDeep
-
assertNotEqualsDeep
-
assertNotEquals
public static void assertNotEquals(double actual, double expected, double delta) -
assertThrows
Asserts thatrunnablethrows an exception when invoked. If it does not, anAssertionErroris thrown.- Parameters:
runnable- A function that is expected to throw an exception when invoked- Since:
- 6.9.5
-
assertThrows
public static <T extends Throwable> void assertThrows(Class<T> throwableClass, Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception of typethrowableClasswhen executed. If it does not throw an exception, anAssertionErroris thrown. If it throws the wrong type of exception, anAssertionErroris thrown describing the mismatch; the exception that was actually thrown can be obtained by callingThrowable.getCause().- Type Parameters:
T- the expected type of the exception- Parameters:
throwableClass- the expected type of the exceptionrunnable- A function that is expected to throw an exception when invoked- Since:
- 6.9.5
-
assertThrows
public static <T extends Throwable> void assertThrows(String message, Class<T> throwableClass, Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception of typethrowableClasswhen executed. If it does not throw an exception, anAssertionErroris thrown. If it throws the wrong type of exception, anAssertionErroris thrown describing the mismatch; the exception that was actually thrown can be obtained by callingThrowable.getCause().- Type Parameters:
T- the expected type of the exception- Parameters:
message- fail messagethrowableClass- the expected type of the exceptionrunnable- A function that is expected to throw an exception when invoked
-
expectThrows
public static <T extends Throwable> T expectThrows(Class<T> throwableClass, Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception of typethrowableClasswhen executed and returns the exception. Ifrunnabledoes not throw an exception, anAssertionErroris thrown. If it throws the wrong type of exception, anAssertionErroris thrown describing the mismatch; the exception that was actually thrown can be obtained by callingThrowable.getCause().- Type Parameters:
T- the expected type of the exception- Parameters:
throwableClass- the expected type of the exceptionrunnable- A function that is expected to throw an exception when invoked- Returns:
- The exception thrown by
runnable - Since:
- 6.9.5
-
expectThrows
public static <T extends Throwable> T expectThrows(String message, Class<T> throwableClass, Assert.ThrowingRunnable runnable) Asserts thatrunnablethrows an exception of typethrowableClasswhen executed and returns the exception. Ifrunnabledoes not throw an exception, anAssertionErroris thrown. If it throws the wrong type of exception, anAssertionErroris thrown describing the mismatch; the exception that was actually thrown can be obtained by callingThrowable.getCause().- Type Parameters:
T- the expected type of the exception- Parameters:
message- fail messagethrowableClass- the expected type of the exceptionrunnable- A function that is expected to throw an exception when invoked- Returns:
- The exception thrown by
runnable
-
assertListContainsObject
Asserts that List contains object. Uses java.util.List#contains method, be sure that equals and hashCode of tested object are overridden.- Type Parameters:
T- type of object- Parameters:
list- the list to search inobject- the object to search in listmessage- the fail message
-
assertListNotContainsObject
Asserts that List not contains object. Opposite to assertListContainsObject() Uses java.util.List#contains method, be sure that equals and hashCode of tested object are overridden.- Type Parameters:
T- type of object- Parameters:
list- the list to search inobject- to search in listmessage- the fail message
-
assertListContains
Asserts that List contains object by specific Predicate. Uses java.util.stream.Stream#anyMatch(java.util.function.Predicate) method.- Type Parameters:
T- type of object- Parameters:
list- the list to search inpredicate- the Predicate to match objectmessage- the fail message
-
assertListNotContains
Asserts that List not contains object by specific Predicate. Opposite to assertListContains() method. Uses java.util.stream.Stream#noneMatch(java.util.function.Predicate) method.- Type Parameters:
T- type of object- Parameters:
list- the list to search inpredicate- the Predicate to match objectmessage- the fail message
-