Package org.testng

Class Assert

java.lang.Object
org.testng.Assert

public class Assert extends Object
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)).

  • Field Details

  • Constructor Details

    • Assert

      protected Assert()
      Protect constructor since it is a static only class
  • Method Details

    • assertTrue

      public static void assertTrue(boolean condition, String message)
      Asserts that a condition is true. If it isn't, an AssertionError, with the given message, is thrown.
      Parameters:
      condition - the condition to evaluate
      message - 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

      public static void assertFalse(boolean condition, String message)
      Asserts that a condition is false. If it isn't, an AssertionError, with the given message, is thrown.
      Parameters:
      condition - the condition to evaluate
      message - 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

      public static void fail(String message, Throwable realCause)
      Fails a test with the given message and wrapping the original exception.
      Parameters:
      message - the assertion error message
      realCause - the original exception
    • fail

      public static void fail(String message)
      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

      public static void assertEquals(Object actual, Object expected, String message)
      Asserts that two objects are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(byte[] actual, byte[] expected, String message)
      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 value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(short[] actual, short[] expected, String message)
      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 value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(int[] actual, int[] expected, String message)
      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 value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(boolean[] actual, boolean[] expected, String message)
      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 value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(char[] actual, char[] expected, String message)
      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 value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(float[] actual, float[] expected, String message)
      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 value
      expected - the expected value
      message - 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 value
      expected - the expected value
      delta - the absolute tolerable difference between the actual and expected values
    • assertEquals

      public static void assertEquals(float[] actual, float[] expected, float delta, String message)
      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 value
      expected - the expected value
      delta - the absolute tolerable difference between the actual and expected values
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(double[] actual, double[] expected, String message)
      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 value
      expected - the expected value
      message - 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 value
      expected - the expected value
      delta - the absolute tolerable difference between the actual and expected values
    • assertEquals

      public static void assertEquals(double[] actual, double[] expected, double delta, String message)
      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 value
      expected - the expected value
      delta - the absolute tolerable difference between the actual and expected values
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(long[] actual, long[] expected, String message)
      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 value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Object actual, Object expected)
      Asserts that two objects are equal. If they are not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(String actual, String expected, String message)
      Asserts that two Strings are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(String actual, String expected)
      Asserts that two Strings are equal. If they are not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(double actual, double expected, double delta, String message)
      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 value
      expected - the expected value
      delta - the absolute tolerable difference between the actual and expected values
      message - 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 value
      expected - the expected value
      delta - the absolute tolerable difference between the actual and expected values
    • assertEquals

      public static void assertEquals(double actual, double expected, String message)
      Asserts that two doubles are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Double actual, double expected, String message)
      Asserts that two doubles are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(double actual, Double expected, String message)
      Asserts that two doubles are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Double actual, Double expected, String message)
      Asserts that two doubles are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(float actual, float expected, float delta, String message)
      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 value
      expected - the expected value
      delta - the absolute tolerable difference between the actual and expected values
      message - 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 value
      expected - the expected value
      delta - the absolute tolerable difference between the actual and expected values
    • assertEquals

      public static void assertEquals(float actual, float expected, String message)
      Asserts that two floats are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Float actual, float expected, String message)
      Asserts that two floats are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(float actual, Float expected, String message)
      Asserts that two floats are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Float actual, Float expected, String message)
      Asserts that two floats are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(long actual, long expected, String message)
      Asserts that two longs are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Long actual, long expected, String message)
      Asserts that two longs are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Long actual, Long expected, String message)
      Asserts that two longs are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(boolean actual, boolean expected, String message)
      Asserts that two booleans are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Boolean actual, boolean expected, String message)
      Asserts that two booleans are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(boolean actual, Boolean expected, String message)
      Asserts that two booleans are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Boolean actual, Boolean expected, String message)
      Asserts that two booleans are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(byte actual, byte expected, String message)
      Asserts that two bytes are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Byte actual, byte expected, String message)
      Asserts that two bytes are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(byte actual, Byte expected, String message)
      Asserts that two bytes are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Byte actual, Byte expected, String message)
      Asserts that two bytes are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(char actual, char expected, String message)
      Asserts that two chars are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Character actual, char expected, String message)
      Asserts that two chars are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(char actual, Character expected, String message)
      Asserts that two chars are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Character actual, Character expected, String message)
      Asserts that two chars are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Character actual, char expected)
      Asserts that two chars are equal. If they are not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(char actual, Character expected)
      Asserts that two chars are equal. If they are not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Character actual, Character expected)
      Asserts that two chars are equal. If they are not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(short actual, short expected, String message)
      Asserts that two shorts are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Short actual, short expected, String message)
      Asserts that two shorts are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(short actual, Short expected, String message)
      Asserts that two shorts are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Short actual, Short expected, String message)
      Asserts that two shorts are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(int actual, int expected, String message)
      Asserts that two ints are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Integer actual, int expected, String message)
      Asserts that two ints are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(int actual, Integer expected, String message)
      Asserts that two ints are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Integer actual, Integer expected, String message)
      Asserts that two ints are equal. If they are not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Integer actual, int expected)
      Asserts that two ints are equal. If they are not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(int actual, Integer expected)
      Asserts that two ints are equal. If they are not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Integer actual, Integer expected)
      Asserts that two ints are equal. If they are not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertNotNull

      public static void assertNotNull(Object object)
      Asserts that an object isn't null. If it is, an AssertionError is thrown.
      Parameters:
      object - the assertion object
    • assertNotNull

      public static void assertNotNull(Object object, String message)
      Asserts that an object isn't null. If it is, an AssertionError, with the given message, is thrown.
      Parameters:
      object - the assertion object
      message - the assertion error message
    • assertNull

      public static void assertNull(Object object)
      Asserts that an object is null. If it is not, an AssertionError, with the given message, is thrown.
      Parameters:
      object - the assertion object
    • assertNull

      public static void assertNull(Object object, String message)
      Asserts that an object is null. If it is not, an AssertionError, with the given message, is thrown.
      Parameters:
      object - the assertion object
      message - the assertion error message
    • assertSame

      public static void assertSame(Object actual, Object expected, String message)
      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 value
      expected - the expected value
      message - the assertion error message
    • assertSame

      public static void assertSame(Object actual, Object expected)
      Asserts that two objects refer to the same object. If they do not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertNotSame

      public static void assertNotSame(Object actual, Object expected, String message)
      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 value
      expected - the expected value
      message - the assertion error message
    • assertNotSame

      public static void assertNotSame(Object actual, Object expected)
      Asserts that two objects do not refer to the same object. If they do, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Collection<?> actual, Collection<?> expected)
      Asserts that two collections contain the same elements in the same order. If they do not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Collection<?> actual, Collection<?> expected, String message)
      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 value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Iterator<?> actual, Iterator<?> expected)
      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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Iterator<?> actual, Iterator<?> expected, String message)
      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 value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Iterable<?> actual, Iterable<?> expected)
      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 value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Iterable<?> actual, Iterable<?> expected, String message)
      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 value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Object[] actual, Object[] expected, String message)
      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 value
      expected - the expected value
      message - the assertion error message
    • assertEqualsNoOrder

      public static void assertEqualsNoOrder(Object[] actual, Object[] expected, String message)
      Asserts that two arrays contain the same elements in no particular order. If they do not, an AssertionError, with the given message, is thrown. The arrays are not compared 'deeply', that means, if the elements are arrays as well their equals method is used which only checks for reference equality.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - 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, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEqualsNoOrder

      public static void assertEqualsNoOrder(Iterator<?> actual, Iterator<?> expected, String message)
      Asserts that two iterators contain the same elements in no particular order. If they do not, an AssertionError, with the given message, is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
      message - the assertion error message
    • assertEquals

      public static void assertEquals(Object[] actual, Object[] 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 value
      expected - the expected value
    • assertEqualsNoOrder

      public static void assertEqualsNoOrder(Object[] actual, Object[] expected)
      Asserts that two arrays contain the same elements in no particular order. If they do not, an AssertionError is thrown. The arrays are not compared 'deeply', that means, if the elements are arrays as well their equals method is used which only checks for reference equality.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEqualsNoOrder

      public static void assertEqualsNoOrder(Collection<?> actual, Collection<?> expected)
      Asserts that two collection contain the same elements in no particular order. If they do not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEqualsNoOrder

      public static void assertEqualsNoOrder(Iterator<?> actual, Iterator<?> expected)
      Asserts that two iterators contain the same elements in no particular order. If they do not, an AssertionError is thrown.
      Parameters:
      actual - the actual value
      expected - the expected value
    • assertEquals

      public static void assertEquals(Set<?> actual, Set<?> expected)
      Asserts that two sets are equal.
      Parameters:
      actual - The actual value
      expected - The expected value
    • assertEquals

      public static void assertEquals(Set<?> actual, Set<?> expected, String message)
      Assert set equals
      Parameters:
      actual - The actual value
      expected - The expected value
      message - The message
    • assertEqualsDeep

      public static void assertEqualsDeep(Set<?> actual, Set<?> expected, String message)
    • assertEquals

      public static void assertEquals(Map<?,?> actual, Map<?,?> expected)
    • assertEquals

      public static void assertEquals(Map<?,?> actual, Map<?,?> expected, String message)
      Asserts that two maps are equal.
      Parameters:
      actual - The actual value
      expected - The expected value
      message - The message
    • assertEqualsDeep

      public static void assertEqualsDeep(Map<?,?> actual, Map<?,?> expected)
    • assertEqualsDeep

      public static void assertEqualsDeep(Map<?,?> actual, Map<?,?> expected, String message)
    • assertNotEquals

      public static void assertNotEquals(Object actual, Object expected, String message)
    • assertNotEquals

      public static void assertNotEquals(Object[] actual, Object[] expected, String message)
    • assertNotEquals

      public static void assertNotEquals(Iterator<?> actual, Iterator<?> expected, String message)
    • assertNotEquals

      public static void assertNotEquals(Collection<?> actual, Collection<?> expected, String message)
    • assertNotEquals

      public static void assertNotEquals(Object actual, Object expected)
    • assertNotEquals

      public static void assertNotEquals(Collection<?> actual, Collection<?> expected)
    • assertNotEquals

      public static void assertNotEquals(Iterator<?> actual, Iterator<?> expected)
    • assertNotEquals

      public static void assertNotEquals(float actual, float expected, float delta, String message)
    • assertNotEquals

      public static void assertNotEquals(float actual, float expected, float delta)
    • assertNotEquals

      public static void assertNotEquals(double actual, double expected, double delta, String message)
    • assertNotEquals

      public static void assertNotEquals(Set<?> actual, Set<?> expected)
    • assertNotEquals

      public static void assertNotEquals(Set<?> actual, Set<?> expected, String message)
    • assertNotEqualsDeep

      public static void assertNotEqualsDeep(Set<?> actual, Set<?> expected)
    • assertNotEqualsDeep

      public static void assertNotEqualsDeep(Set<?> actual, Set<?> expected, String message)
    • assertNotEquals

      public static void assertNotEquals(Map<?,?> actual, Map<?,?> expected)
    • assertNotEquals

      public static void assertNotEquals(Map<?,?> actual, Map<?,?> expected, String message)
    • assertNotEqualsDeep

      public static void assertNotEqualsDeep(Map<?,?> actual, Map<?,?> expected)
    • assertNotEqualsDeep

      public static void assertNotEqualsDeep(Map<?,?> actual, Map<?,?> expected, String message)
    • assertNotEquals

      public static void assertNotEquals(double actual, double expected, double delta)
    • assertThrows

      public static void assertThrows(Assert.ThrowingRunnable runnable)
      Asserts that runnable throws an exception when invoked. If it does not, an AssertionError is 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 that 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().
      Type Parameters:
      T - the expected type of the exception
      Parameters:
      throwableClass - the expected type of the exception
      runnable - 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 that 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().
      Type Parameters:
      T - the expected type of the exception
      Parameters:
      message - fail message
      throwableClass - the expected type of the exception
      runnable - 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 that 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().
      Type Parameters:
      T - the expected type of the exception
      Parameters:
      throwableClass - the expected type of the exception
      runnable - 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 that 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().
      Type Parameters:
      T - the expected type of the exception
      Parameters:
      message - fail message
      throwableClass - the expected type of the exception
      runnable - A function that is expected to throw an exception when invoked
      Returns:
      The exception thrown by runnable
    • assertListContainsObject

      public static <T> void assertListContainsObject(List<T> list, T object, String message)
      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 in
      object - the object to search in list
      message - the fail message
    • assertListNotContainsObject

      public static <T> void assertListNotContainsObject(List<T> list, T object, String message)
      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 in
      object - to search in list
      message - the fail message
    • assertListContains

      public static <T> void assertListContains(List<T> list, Predicate<T> predicate, String message)
      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 in
      predicate - the Predicate to match object
      message - the fail message
    • assertListNotContains

      public static <T> void assertListNotContains(List<T> list, Predicate<T> predicate, String message)
      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 in
      predicate - the Predicate to match object
      message - the fail message