Assertions
is a collection of utility methods that support asserting
conditions in tests.
Unless otherwise noted, a failed assertion will throw an
AssertionFailedError
or a subclass thereof.
Object Equality
Assertion methods comparing two objects for equality, such as the
assertEquals(expected, actual)
and assertNotEquals(unexpected, actual)
variants, are only intended to test equality for an (un-)expected value
and an actual value. They are not designed for testing whether a class correctly
implements Object.equals(Object)
. For example, assertEquals()
might immediately return true
when provided the same object for the
expected and actual values, without calling equals(Object)
at all.
Tests that aim to verify the equals(Object)
implementation should instead
be written to explicitly verify the Object.equals(Object)
contract by
using assertTrue()
or assertFalse()
— for example, assertTrue(expected.equals(actual))
,
assertTrue(actual.equals(expected))
, assertFalse(expected.equals(null))
,
etc.
Kotlin Support
Additional Kotlin assertions can be
found as top-level functions in the org.junit.jupiter.api
package.
Preemptive Timeouts
The various assertTimeoutPreemptively()
methods in this class
execute the provided executable
or supplier
in a different
thread than that of the calling code. This behavior can lead to undesirable
side effects if the code that is executed within the executable
or
supplier
relies on ThreadLocal
storage.
One common example of this is the transactional testing support in the Spring
Framework. Specifically, Spring's testing support binds transaction state to
the current thread (via a ThreadLocal
) before a test method is invoked.
Consequently, if an executable
or supplier
provided to
assertTimeoutPreemptively()
invokes Spring-managed components that
participate in transactions, any actions taken by those components will not be
rolled back with the test-managed transaction. On the contrary, such actions
will be committed to the persistent store (e.g., relational database) even
though the test-managed transaction is rolled back.
Similar side effects may be encountered with other frameworks that rely on
ThreadLocal
storage.
Extensibility
Although it is technically possible to extend this class, extension is strongly discouraged. The JUnit Team highly recommends that the methods defined in this class be used via static imports.
- Since:
- 5.0
- See Also:
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic interface
Assertions.TimeoutFailureFactory<T extends Throwable>
Factory for timeout failures. -
Constructor Summary
ModifierConstructorDescriptionprotected
Protected constructor allowing subclassing but not direct instantiation. -
Method Summary
Modifier and TypeMethodDescriptionstatic void
assertAll
(String heading, Collection<Executable> executables) Assert that all suppliedexecutables
do not throw exceptions.static void
assertAll
(String heading, Stream<Executable> executables) Assert that all suppliedexecutables
do not throw exceptions.static void
assertAll
(String heading, Executable... executables) Assert that all suppliedexecutables
do not throw exceptions.static void
assertAll
(Collection<Executable> executables) Assert that all suppliedexecutables
do not throw exceptions.static void
assertAll
(Stream<Executable> executables) Assert that all suppliedexecutables
do not throw exceptions.static void
assertAll
(Executable... executables) Assert that all suppliedexecutables
do not throw exceptions.static void
assertArrayEquals
(boolean[] expected, boolean[] actual) Assert thatexpected
andactual
boolean arrays are equal.static void
assertArrayEquals
(boolean[] expected, boolean[] actual, String message) Assert thatexpected
andactual
boolean arrays are equal.static void
assertArrayEquals
(boolean[] expected, boolean[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
boolean arrays are equal.static void
assertArrayEquals
(byte[] expected, byte[] actual) Assert thatexpected
andactual
byte arrays are equal.static void
assertArrayEquals
(byte[] expected, byte[] actual, String message) Assert thatexpected
andactual
byte arrays are equal.static void
assertArrayEquals
(byte[] expected, byte[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
byte arrays are equal.static void
assertArrayEquals
(char[] expected, char[] actual) Assert thatexpected
andactual
char arrays are equal.static void
assertArrayEquals
(char[] expected, char[] actual, String message) Assert thatexpected
andactual
char arrays are equal.static void
assertArrayEquals
(char[] expected, char[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
char arrays are equal.static void
assertArrayEquals
(double[] expected, double[] actual) Assert thatexpected
andactual
double arrays are equal.static void
assertArrayEquals
(double[] expected, double[] actual, double delta) Assert thatexpected
andactual
double arrays are equal within the given non-negativedelta
.static void
assertArrayEquals
(double[] expected, double[] actual, double delta, String message) Assert thatexpected
andactual
double arrays are equal within the given non-negativedelta
.static void
assertArrayEquals
(double[] expected, double[] actual, double delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
double arrays are equal within the given non-negativedelta
.static void
assertArrayEquals
(double[] expected, double[] actual, String message) Assert thatexpected
andactual
double arrays are equal.static void
assertArrayEquals
(double[] expected, double[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
double arrays are equal.static void
assertArrayEquals
(float[] expected, float[] actual) Assert thatexpected
andactual
float arrays are equal.static void
assertArrayEquals
(float[] expected, float[] actual, float delta) Assert thatexpected
andactual
float arrays are equal within the given non-negativedelta
.static void
assertArrayEquals
(float[] expected, float[] actual, float delta, String message) Assert thatexpected
andactual
float arrays are equal within the given non-negativedelta
.static void
assertArrayEquals
(float[] expected, float[] actual, float delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
float arrays are equal within the given non-negativedelta
.static void
assertArrayEquals
(float[] expected, float[] actual, String message) Assert thatexpected
andactual
float arrays are equal.static void
assertArrayEquals
(float[] expected, float[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
float arrays are equal.static void
assertArrayEquals
(int[] expected, int[] actual) Assert thatexpected
andactual
int arrays are equal.static void
assertArrayEquals
(int[] expected, int[] actual, String message) Assert thatexpected
andactual
int arrays are equal.static void
assertArrayEquals
(int[] expected, int[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
int arrays are equal.static void
assertArrayEquals
(long[] expected, long[] actual) Assert thatexpected
andactual
long arrays are equal.static void
assertArrayEquals
(long[] expected, long[] actual, String message) Assert thatexpected
andactual
long arrays are equal.static void
assertArrayEquals
(long[] expected, long[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
long arrays are equal.static void
assertArrayEquals
(short[] expected, short[] actual) Assert thatexpected
andactual
short arrays are equal.static void
assertArrayEquals
(short[] expected, short[] actual, String message) Assert thatexpected
andactual
short arrays are equal.static void
assertArrayEquals
(short[] expected, short[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
short arrays are equal.static void
assertArrayEquals
(Object[] expected, Object[] actual) Assert thatexpected
andactual
object arrays are deeply equal.static void
assertArrayEquals
(Object[] expected, Object[] actual, String message) Assert thatexpected
andactual
object arrays are deeply equal.static void
assertArrayEquals
(Object[] expected, Object[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
object arrays are deeply equal.static void
assertDoesNotThrow
(Executable executable) Assert that execution of the suppliedexecutable
does not throw any kind of exception.static void
assertDoesNotThrow
(Executable executable, String message) Assert that execution of the suppliedexecutable
does not throw any kind of exception.static void
assertDoesNotThrow
(Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
does not throw any kind of exception.static <T> T
assertDoesNotThrow
(ThrowingSupplier<T> supplier) Assert that execution of the suppliedsupplier
does not throw any kind of exception.static <T> T
assertDoesNotThrow
(ThrowingSupplier<T> supplier, String message) Assert that execution of the suppliedsupplier
does not throw any kind of exception.static <T> T
assertDoesNotThrow
(ThrowingSupplier<T> supplier, Supplier<String> messageSupplier) Assert that execution of the suppliedsupplier
does not throw any kind of exception.static void
assertEquals
(byte expected, byte actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(byte expected, byte actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(byte expected, byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(byte expected, Byte actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(byte expected, Byte actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(byte expected, Byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(char expected, char actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(char expected, char actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(char expected, char actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(char expected, Character actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(char expected, Character actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(char expected, Character actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(double expected, double actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(double expected, double actual, double delta) Assert thatexpected
andactual
are equal within the given non-negativedelta
.static void
assertEquals
(double expected, double actual, double delta, String message) Assert thatexpected
andactual
are equal within the given non-negativedelta
.static void
assertEquals
(double expected, double actual, double delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal within the given non-negativedelta
.static void
assertEquals
(double expected, double actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(double expected, double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(double expected, Double actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(double expected, Double actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(double expected, Double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(float expected, float actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(float expected, float actual, float delta) Assert thatexpected
andactual
are equal within the given non-negativedelta
.static void
assertEquals
(float expected, float actual, float delta, String message) Assert thatexpected
andactual
are equal within the given non-negativedelta
.static void
assertEquals
(float expected, float actual, float delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal within the given non-negativedelta
.static void
assertEquals
(float expected, float actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(float expected, float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(float expected, Float actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(float expected, Float actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(float expected, Float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(int expected, int actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(int expected, int actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(int expected, int actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(int expected, Integer actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(int expected, Integer actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(int expected, Integer actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(long expected, long actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(long expected, long actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(long expected, long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(long expected, Long actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(long expected, Long actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(long expected, Long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(short expected, short actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(short expected, short actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(short expected, short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(short expected, Short actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(short expected, Short actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(short expected, Short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Byte expected, byte actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Byte expected, byte actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Byte expected, byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Byte expected, Byte actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Byte expected, Byte actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Byte expected, Byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Character expected, char actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Character expected, char actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Character expected, char actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Character expected, Character actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Character expected, Character actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Character expected, Character actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Double expected, double actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Double expected, double actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Double expected, double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Double expected, Double actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Double expected, Double actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Double expected, Double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Float expected, float actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Float expected, float actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Float expected, float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Float expected, Float actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Float expected, Float actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Float expected, Float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Integer expected, int actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Integer expected, int actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Integer expected, int actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Integer expected, Integer actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Integer expected, Integer actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Integer expected, Integer actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Long expected, long actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Long expected, long actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Long expected, long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Long expected, Long actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Long expected, Long actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Long expected, Long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Object expected, Object actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Object expected, Object actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Object expected, Object actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Short expected, short actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Short expected, short actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Short expected, short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertEquals
(Short expected, Short actual) Assert thatexpected
andactual
are equal.static void
assertEquals
(Short expected, Short actual, String message) Assert thatexpected
andactual
are equal.static void
assertEquals
(Short expected, Short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.static void
assertFalse
(boolean condition) Assert that the suppliedcondition
isfalse
.static void
assertFalse
(boolean condition, String message) Assert that the suppliedcondition
isfalse
.static void
assertFalse
(boolean condition, Supplier<String> messageSupplier) Assert that the suppliedcondition
isfalse
.static void
assertFalse
(BooleanSupplier booleanSupplier) Assert that the boolean condition supplied bybooleanSupplier
isfalse
.static void
assertFalse
(BooleanSupplier booleanSupplier, String message) Assert that the boolean condition supplied bybooleanSupplier
isfalse
.static void
assertFalse
(BooleanSupplier booleanSupplier, Supplier<String> messageSupplier) Assert that the boolean condition supplied bybooleanSupplier
isfalse
.static <T> T
assertInstanceOf
(Class<T> expectedType, Object actualValue) Assert that the suppliedactualValue
is an instance of theexpectedType
.static <T> T
assertInstanceOf
(Class<T> expectedType, Object actualValue, String message) Assert that the suppliedactualValue
is an instance of theexpectedType
.static <T> T
assertInstanceOf
(Class<T> expectedType, Object actualValue, Supplier<String> messageSupplier) Assert that the suppliedactualValue
is an instance of theexpectedType
.static void
assertIterableEquals
(Iterable<?> expected, Iterable<?> actual) Assert thatexpected
andactual
iterables are deeply equal.static void
assertIterableEquals
(Iterable<?> expected, Iterable<?> actual, String message) Assert thatexpected
andactual
iterables are deeply equal.static void
assertIterableEquals
(Iterable<?> expected, Iterable<?> actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
iterables are deeply equal.static void
assertLinesMatch
(List<String> expectedLines, List<String> actualLines) static void
static void
assertLinesMatch
(List<String> expectedLines, List<String> actualLines, Supplier<String> messageSupplier) static void
assertLinesMatch
(Stream<String> expectedLines, Stream<String> actualLines) static void
static void
assertLinesMatch
(Stream<String> expectedLines, Stream<String> actualLines, Supplier<String> messageSupplier) static void
assertNotEquals
(byte unexpected, byte actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(byte unexpected, byte actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(byte unexpected, byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(byte unexpected, Byte actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(byte unexpected, Byte actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(byte unexpected, Byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(char unexpected, char actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(char unexpected, char actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(char unexpected, char actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(char unexpected, Character actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(char unexpected, Character actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(char unexpected, Character actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(double unexpected, double actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(double unexpected, double actual, double delta) Assert thatexpected
andactual
are not equal within the givendelta
.static void
assertNotEquals
(double unexpected, double actual, double delta, String message) Assert thatexpected
andactual
are not equal within the givendelta
.static void
assertNotEquals
(double unexpected, double actual, double delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal within the givendelta
.static void
assertNotEquals
(double unexpected, double actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(double unexpected, double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(double unexpected, Double actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(double unexpected, Double actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(double unexpected, Double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(float unexpected, float actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(float unexpected, float actual, float delta) Assert thatexpected
andactual
are not equal within the givendelta
.static void
assertNotEquals
(float unexpected, float actual, float delta, String message) Assert thatexpected
andactual
are not equal within the givendelta
.static void
assertNotEquals
(float unexpected, float actual, float delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal within the givendelta
.static void
assertNotEquals
(float unexpected, float actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(float unexpected, float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(float unexpected, Float actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(float unexpected, Float actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(float unexpected, Float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(int unexpected, int actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(int unexpected, int actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(int unexpected, int actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(int unexpected, Integer actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(int unexpected, Integer actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(int unexpected, Integer actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(long unexpected, long actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(long unexpected, long actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(long unexpected, long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(long unexpected, Long actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(long unexpected, Long actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(long unexpected, Long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(short unexpected, short actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(short unexpected, short actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(short unexpected, short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(short unexpected, Short actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(short unexpected, Short actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(short unexpected, Short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Byte unexpected, byte actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Byte unexpected, byte actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Byte unexpected, byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Byte unexpected, Byte actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Byte unexpected, Byte actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Byte unexpected, Byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Character unexpected, char actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Character unexpected, char actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Character unexpected, char actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Character unexpected, Character actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Character unexpected, Character actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Character unexpected, Character actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Double unexpected, double actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Double unexpected, double actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Double unexpected, double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Double unexpected, Double actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Double unexpected, Double actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Double unexpected, Double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Float unexpected, float actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Float unexpected, float actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Float unexpected, float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Float unexpected, Float actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Float unexpected, Float actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Float unexpected, Float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Integer unexpected, int actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Integer unexpected, int actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Integer unexpected, int actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Integer unexpected, Integer actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Integer unexpected, Integer actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Integer unexpected, Integer actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Long unexpected, long actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Long unexpected, long actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Long unexpected, long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Long unexpected, Long actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Long unexpected, Long actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Long unexpected, Long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Object unexpected, Object actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Object unexpected, Object actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Object unexpected, Object actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Short unexpected, short actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Short unexpected, short actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Short unexpected, short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Short unexpected, Short actual) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Short unexpected, Short actual, String message) Assert thatexpected
andactual
are not equal.static void
assertNotEquals
(Short unexpected, Short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.static void
assertNotNull
(Object actual) Assert thatactual
is notnull
.static void
assertNotNull
(Object actual, String message) Assert thatactual
is notnull
.static void
assertNotNull
(Object actual, Supplier<String> messageSupplier) Assert thatactual
is notnull
.static void
assertNotSame
(Object unexpected, Object actual) Assert thatexpected
andactual
do not refer to the same object.static void
assertNotSame
(Object unexpected, Object actual, String message) Assert thatexpected
andactual
do not refer to the same object.static void
assertNotSame
(Object unexpected, Object actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
do not refer to the same object.static void
assertNull
(Object actual) Assert thatactual
isnull
.static void
assertNull
(Object actual, String message) Assert thatactual
isnull
.static void
assertNull
(Object actual, Supplier<String> messageSupplier) Assert thatactual
isnull
.static void
assertSame
(Object expected, Object actual) Assert thatexpected
andactual
refer to the same object.static void
assertSame
(Object expected, Object actual, String message) Assert thatexpected
andactual
refer to the same object.static void
assertSame
(Object expected, Object actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
refer to the same object.static <T extends Throwable>
TassertThrows
(Class<T> expectedType, Executable executable) Assert that execution of the suppliedexecutable
throws an exception of theexpectedType
and return the exception.static <T extends Throwable>
TassertThrows
(Class<T> expectedType, Executable executable, String message) Assert that execution of the suppliedexecutable
throws an exception of theexpectedType
and return the exception.static <T extends Throwable>
TassertThrows
(Class<T> expectedType, Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
throws an exception of theexpectedType
and return the exception.static <T extends Throwable>
TassertThrowsExactly
(Class<T> expectedType, Executable executable) Assert that execution of the suppliedexecutable
throws an exception of exactly theexpectedType
and return the exception.static <T extends Throwable>
TassertThrowsExactly
(Class<T> expectedType, Executable executable, String message) Assert that execution of the suppliedexecutable
throws an exception of exactly theexpectedType
and return the exception.static <T extends Throwable>
TassertThrowsExactly
(Class<T> expectedType, Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
throws an exception of exactly theexpectedType
and return the exception.static void
assertTimeout
(Duration timeout, Executable executable) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.static void
assertTimeout
(Duration timeout, Executable executable, String message) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.static void
assertTimeout
(Duration timeout, Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.static <T> T
assertTimeout
(Duration timeout, ThrowingSupplier<T> supplier) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.static <T> T
assertTimeout
(Duration timeout, ThrowingSupplier<T> supplier, String message) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.static <T> T
assertTimeout
(Duration timeout, ThrowingSupplier<T> supplier, Supplier<String> messageSupplier) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.static void
assertTimeoutPreemptively
(Duration timeout, Executable executable) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.static void
assertTimeoutPreemptively
(Duration timeout, Executable executable, String message) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.static void
assertTimeoutPreemptively
(Duration timeout, Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.static <T> T
assertTimeoutPreemptively
(Duration timeout, ThrowingSupplier<T> supplier) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.static <T> T
assertTimeoutPreemptively
(Duration timeout, ThrowingSupplier<T> supplier, String message) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.static <T> T
assertTimeoutPreemptively
(Duration timeout, ThrowingSupplier<T> supplier, Supplier<String> messageSupplier) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.static <T,
E extends Throwable>
TassertTimeoutPreemptively
(Duration timeout, ThrowingSupplier<T> supplier, Supplier<String> messageSupplier, Assertions.TimeoutFailureFactory<E> failureFactory) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.static void
assertTrue
(boolean condition) Assert that the suppliedcondition
istrue
.static void
assertTrue
(boolean condition, String message) Assert that the suppliedcondition
istrue
.static void
assertTrue
(boolean condition, Supplier<String> messageSupplier) Assert that the suppliedcondition
istrue
.static void
assertTrue
(BooleanSupplier booleanSupplier) Assert that the boolean condition supplied bybooleanSupplier
istrue
.static void
assertTrue
(BooleanSupplier booleanSupplier, String message) Assert that the boolean condition supplied bybooleanSupplier
istrue
.static void
assertTrue
(BooleanSupplier booleanSupplier, Supplier<String> messageSupplier) Assert that the boolean condition supplied bybooleanSupplier
istrue
.static <V> V
fail()
Fail the test without a failure message.static <V> V
Fail the test with the given failuremessage
.static <V> V
Fail the test with the given failuremessage
as well as the underlyingcause
.static <V> V
Fail the test with the given underlyingcause
.static <V> V
Fail the test with the failure message retrieved from the givenmessageSupplier
.
-
Constructor Details
-
Assertions
Protected constructor allowing subclassing but not direct instantiation.- Since:
- 5.3
-
-
Method Details
-
fail
public static <V> V fail()Fail the test without a failure message.Although failing with an explicit failure message is recommended, this method may be useful when maintaining legacy code.
See Javadoc for
fail(String)
for an explanation of this method's generic return typeV
. -
fail
Fail the test with the given failuremessage
.The generic return type
V
allows this method to be used directly as a single-statement lambda expression, thereby avoiding the need to implement a code block with an explicit return value. Since this method throws anAssertionFailedError
before its return statement, this method never actually returns a value to its caller. The following example demonstrates how this may be used in practice.Stream.of().map(entry -> fail("should not be called"));
-
fail
Fail the test with the given failuremessage
as well as the underlyingcause
.See Javadoc for
fail(String)
for an explanation of this method's generic return typeV
. -
fail
Fail the test with the given underlyingcause
.See Javadoc for
fail(String)
for an explanation of this method's generic return typeV
. -
fail
Fail the test with the failure message retrieved from the givenmessageSupplier
.See Javadoc for
fail(String)
for an explanation of this method's generic return typeV
. -
assertTrue
public static void assertTrue(boolean condition) Assert that the suppliedcondition
istrue
. -
assertTrue
Assert that the suppliedcondition
istrue
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertTrue
Assert that the boolean condition supplied bybooleanSupplier
istrue
. -
assertTrue
Assert that the boolean condition supplied bybooleanSupplier
istrue
.Fails with the supplied failure
message
. -
assertTrue
Assert that the suppliedcondition
istrue
.Fails with the supplied failure
message
. -
assertTrue
Assert that the boolean condition supplied bybooleanSupplier
istrue
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertFalse
public static void assertFalse(boolean condition) Assert that the suppliedcondition
isfalse
. -
assertFalse
Assert that the suppliedcondition
isfalse
.Fails with the supplied failure
message
. -
assertFalse
Assert that the suppliedcondition
isfalse
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertFalse
Assert that the boolean condition supplied bybooleanSupplier
isfalse
. -
assertFalse
Assert that the boolean condition supplied bybooleanSupplier
isfalse
.Fails with the supplied failure
message
. -
assertFalse
Assert that the boolean condition supplied bybooleanSupplier
isfalse
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertNull
Assert thatactual
isnull
. -
assertNull
Assert thatactual
isnull
.Fails with the supplied failure
message
. -
assertNull
Assert thatactual
isnull
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertNotNull
Assert thatactual
is notnull
. -
assertNotNull
Assert thatactual
is notnull
.Fails with the supplied failure
message
. -
assertNotNull
Assert thatactual
is notnull
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
public static void assertEquals(short expected, short actual) Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Short expected, Short actual, String message) Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Short expected, Short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertEquals
public static void assertEquals(byte expected, byte actual) Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Byte expected, Byte actual, String message) Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Byte expected, Byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertEquals
public static void assertEquals(int expected, int actual) Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Integer expected, Integer actual, String message) Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Integer expected, Integer actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertEquals
public static void assertEquals(long expected, long actual) Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Long expected, Long actual, String message) Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Long expected, Long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertEquals
public static void assertEquals(float expected, float actual) Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Float expected, Float actual, String message) Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Float expected, Float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertEquals
public static void assertEquals(float expected, float actual, float delta) Assert thatexpected
andactual
are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
. -
assertEquals
Assert thatexpected
andactual
are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
. -
assertEquals
public static void assertEquals(float expected, float actual, float delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
public static void assertEquals(double expected, double actual) Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Double expected, Double actual, String message) Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Double expected, Double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertEquals
public static void assertEquals(double expected, double actual, double delta) Assert thatexpected
andactual
are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
. -
assertEquals
Assert thatexpected
andactual
are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
. -
assertEquals
public static void assertEquals(double expected, double actual, double delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
public static void assertEquals(char expected, char actual) Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
Assert thatexpected
andactual
are equal. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Character expected, Character actual) Assert thatexpected
andactual
are equal.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Character expected, Character actual, String message) Assert thatexpected
andactual
are equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertEquals
@API(status=STABLE, since="5.4") public static void assertEquals(Character expected, Character actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertEquals
Assert thatexpected
andactual
are equal.If both are
null
, they are considered equal.- See Also:
-
assertEquals
Assert thatexpected
andactual
are equal.If both are
null
, they are considered equal.Fails with the supplied failure
message
.- See Also:
-
assertEquals
Assert thatexpected
andactual
are equal.If both are
null
, they are considered equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- See Also:
-
assertArrayEquals
public static void assertArrayEquals(boolean[] expected, boolean[] actual) Assert thatexpected
andactual
boolean arrays are equal.If both are
null
, they are considered equal. -
assertArrayEquals
Assert thatexpected
andactual
boolean arrays are equal.If both are
null
, they are considered equal.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(boolean[] expected, boolean[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
boolean arrays are equal.If both are
null
, they are considered equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(char[] expected, char[] actual) Assert thatexpected
andactual
char arrays are equal.If both are
null
, they are considered equal. -
assertArrayEquals
Assert thatexpected
andactual
char arrays are equal.If both are
null
, they are considered equal.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(char[] expected, char[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
char arrays are equal.If both are
null
, they are considered equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(byte[] expected, byte[] actual) Assert thatexpected
andactual
byte arrays are equal.If both are
null
, they are considered equal. -
assertArrayEquals
Assert thatexpected
andactual
byte arrays are equal.If both are
null
, they are considered equal.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(byte[] expected, byte[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
byte arrays are equal.If both are
null
, they are considered equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(short[] expected, short[] actual) Assert thatexpected
andactual
short arrays are equal.If both are
null
, they are considered equal. -
assertArrayEquals
Assert thatexpected
andactual
short arrays are equal.If both are
null
, they are considered equal.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(short[] expected, short[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
short arrays are equal.If both are
null
, they are considered equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(int[] expected, int[] actual) Assert thatexpected
andactual
int arrays are equal.If both are
null
, they are considered equal. -
assertArrayEquals
Assert thatexpected
andactual
int arrays are equal.If both are
null
, they are considered equal.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(int[] expected, int[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
int arrays are equal.If both are
null
, they are considered equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(long[] expected, long[] actual) Assert thatexpected
andactual
long arrays are equal.If both are
null
, they are considered equal. -
assertArrayEquals
Assert thatexpected
andactual
long arrays are equal.If both are
null
, they are considered equal.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(long[] expected, long[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
long arrays are equal.If both are
null
, they are considered equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(float[] expected, float[] actual) Assert thatexpected
andactual
float arrays are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
. -
assertArrayEquals
Assert thatexpected
andactual
float arrays are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(float[] expected, float[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
float arrays are equal.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(float[] expected, float[] actual, float delta) Assert thatexpected
andactual
float arrays are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
. -
assertArrayEquals
Assert thatexpected
andactual
float arrays are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(float[] expected, float[] actual, float delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
float arrays are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(double[] expected, double[] actual) Assert thatexpected
andactual
double arrays are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
. -
assertArrayEquals
Assert thatexpected
andactual
double arrays are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(double[] expected, double[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
double arrays are equal.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
public static void assertArrayEquals(double[] expected, double[] actual, double delta) Assert thatexpected
andactual
double arrays are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
. -
assertArrayEquals
public static void assertArrayEquals(double[] expected, double[] actual, double delta, String message) Assert thatexpected
andactual
double arrays are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(double[] expected, double[] actual, double delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
double arrays are equal within the given non-negativedelta
.Equality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertArrayEquals
Assert thatexpected
andactual
object arrays are deeply equal.If both are
null
, they are considered equal.Nested float arrays are checked as in
assertEquals(float, float)
.Nested double arrays are checked as in
assertEquals(double, double)
. -
assertArrayEquals
Assert thatexpected
andactual
object arrays are deeply equal.If both are
null
, they are considered equal.Nested float arrays are checked as in
assertEquals(float, float)
.Nested double arrays are checked as in
assertEquals(double, double)
.Fails with the supplied failure
message
. -
assertArrayEquals
public static void assertArrayEquals(Object[] expected, Object[] actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
object arrays are deeply equal.If both are
null
, they are considered equal.Nested float arrays are checked as in
assertEquals(float, float)
.Nested double arrays are checked as in
assertEquals(double, double)
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertIterableEquals
Assert thatexpected
andactual
iterables are deeply equal.Similarly to the check for deep equality in
assertArrayEquals(Object[], Object[])
, if two iterables are encountered (includingexpected
andactual
) then their iterators must return equal elements in the same order as each other. Note: this means that the iterables do not need to be of the same type. Example:import static java.util.Arrays.asList; . . . Iterable<Integer> i0 = new ArrayList<>(asList(1, 2, 3)); Iterable<Integer> i1 = new LinkedList<>(asList(1, 2, 3)); assertIterableEquals(i0, i1); // Passes
If both
expected
andactual
arenull
, they are considered equal. -
assertIterableEquals
Assert thatexpected
andactual
iterables are deeply equal.Similarly to the check for deep equality in
assertArrayEquals(Object[], Object[], String)
, if two iterables are encountered (includingexpected
andactual
) then their iterators must return equal elements in the same order as each other. Note: this means that the iterables do not need to be of the same type. Example:import static java.util.Arrays.asList; . . . Iterable<Integer> i0 = new ArrayList<>(asList(1, 2, 3)); Iterable<Integer> i1 = new LinkedList<>(asList(1, 2, 3)); assertIterableEquals(i0, i1); // Passes
If both
expected
andactual
arenull
, they are considered equal.Fails with the supplied failure
message
. -
assertIterableEquals
public static void assertIterableEquals(Iterable<?> expected, Iterable<?> actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
iterables are deeply equal.Similarly to the check for deep equality in
assertArrayEquals(Object[], Object[], Supplier)
, if two iterables are encountered (includingexpected
andactual
) then their iterators must return equal elements in the same order as each other. Note: this means that the iterables do not need to be of the same type. Example:import static java.util.Arrays.asList; . . . Iterable<Integer> i0 = new ArrayList<>(asList(1, 2, 3)); Iterable<Integer> i1 = new LinkedList<>(asList(1, 2, 3)); assertIterableEquals(i0, i1); // Passes
If both
expected
andactual
arenull
, they are considered equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertLinesMatch
Assert thatexpected
list of Strings matchesactual
list.This method differs from other assertions that effectively only check
String.equals(Object)
, in that it uses the following staged matching algorithm:For each pair of expected and actual lines do
- check if
expected.equals(actual)
- if yes, continue with next pair - otherwise treat
expected
as a regular expression and check viaString.matches(String)
- if yes, continue with next pair - otherwise check if
expected
line is a fast-forward marker, if yes apply fast-forward actual lines accordingly (see below) and goto 1.
A valid fast-forward marker is an expected line that starts and ends with the literal
>>
and contains at least 4 characters. Examples:>>>>
>> stacktrace >>
>> single line, non Integer.parse()-able comment >>
Skip arbitrary number of actual lines, until first matching subsequent expected line is found. Any character between the fast-forward literals are discarded.">> 21 >>"
Skip strictly 21 lines. If they can't be skipped for any reason, an assertion error is raised.
Here is an example showing all three kinds of expected line formats:
ls -la / total [\d]+ drwxr-xr-x 0 root root 512 Jan 1 1970 . drwxr-xr-x 0 root root 512 Jan 1 1970 .. drwxr-xr-x 0 root root 512 Apr 5 07:45 bin >> 4 >> -rwxr-xr-x 1 root root [\d]+ Jan 1 1970 init >> M A N Y M O R E E N T R I E S >> drwxr-xr-x 0 root root 512 Sep 22 2017 var
Fails with a generated failure message describing the difference.
- check if
-
assertLinesMatch
public static void assertLinesMatch(List<String> expectedLines, List<String> actualLines, String message) Assert thatexpected
list of Strings matchesactual
list.Find a detailed description of the matching algorithm in
assertLinesMatch(List, List)
.Fails with the supplied failure
message
and the generated message.- See Also:
-
assertLinesMatch
public static void assertLinesMatch(List<String> expectedLines, List<String> actualLines, Supplier<String> messageSupplier) Assert thatexpected
list of Strings matchesactual
list.Find a detailed description of the matching algorithm in
assertLinesMatch(List, List)
.If necessary, a custom failure message will be retrieved lazily from the supplied
messageSupplier
. Fails with the custom failure message prepended to a generated failure message describing the difference.- See Also:
-
assertLinesMatch
Assert thatexpected
stream of Strings matchesactual
stream.Find a detailed description of the matching algorithm in
assertLinesMatch(List, List)
.Note: An implementation of this method may consume all lines of both streams eagerly and delegate the evaluation to
assertLinesMatch(List, List)
.- Since:
- 5.7
- See Also:
-
assertLinesMatch
public static void assertLinesMatch(Stream<String> expectedLines, Stream<String> actualLines, String message) Assert thatexpected
stream of Strings matchesactual
stream.Find a detailed description of the matching algorithm in
assertLinesMatch(List, List)
.Fails with the supplied failure
message
and the generated message.Note: An implementation of this method may consume all lines of both streams eagerly and delegate the evaluation to
assertLinesMatch(List, List)
.- Since:
- 5.7
- See Also:
-
assertLinesMatch
public static void assertLinesMatch(Stream<String> expectedLines, Stream<String> actualLines, Supplier<String> messageSupplier) Assert thatexpected
stream of Strings matchesactual
stream.Find a detailed description of the matching algorithm in
assertLinesMatch(List, List)
.If necessary, a custom failure message will be retrieved lazily from the supplied
messageSupplier
. Fails with the custom failure message prepended to a generated failure message describing the difference.Note: An implementation of this method may consume all lines of both streams eagerly and delegate the evaluation to
assertLinesMatch(List, List)
.- Since:
- 5.7
- See Also:
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(byte unexpected, byte actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(byte unexpected, Byte actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Byte unexpected, byte actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Byte unexpected, Byte actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(byte unexpected, byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(byte unexpected, Byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Byte unexpected, byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Byte unexpected, Byte actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(short unexpected, short actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(short unexpected, Short actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Short unexpected, short actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Short unexpected, Short actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(short unexpected, short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(short unexpected, Short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Short unexpected, short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Short unexpected, Short actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Integer unexpected, Integer actual) Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(int unexpected, int actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(int unexpected, Integer actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Integer unexpected, int actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Integer unexpected, Integer actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(int unexpected, int actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(int unexpected, Integer actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Integer unexpected, int actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Integer unexpected, Integer actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(long unexpected, long actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(long unexpected, Long actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Long unexpected, long actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Long unexpected, Long actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(long unexpected, long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(long unexpected, Long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Long unexpected, long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Long unexpected, Long actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(float unexpected, float actual, String message) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(float unexpected, Float actual, String message) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Float unexpected, float actual, String message) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Float unexpected, Float actual, String message) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(float unexpected, float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(float unexpected, Float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Float unexpected, float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Float unexpected, Float actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(float unexpected, float actual, float delta) Assert thatexpected
andactual
are not equal within the givendelta
.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(float unexpected, float actual, float delta, String message) Assert thatexpected
andactual
are not equal within the givendelta
.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(float unexpected, float actual, float delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal within the givendelta
.Inequality imposed by this method is consistent with
Float.equals(Object)
andFloat.compare(float, float)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, double actual) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, Double actual) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Double unexpected, double actual) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Double unexpected, Double actual) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, double actual, String message) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, Double actual, String message) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Double unexpected, double actual, String message) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Double unexpected, Double actual, String message) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, Double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Double unexpected, double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Double unexpected, Double actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, double actual, double delta) Assert thatexpected
andactual
are not equal within the givendelta
.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, double actual, double delta, String message) Assert thatexpected
andactual
are not equal within the givendelta
.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(double unexpected, double actual, double delta, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal within the givendelta
.Inequality imposed by this method is consistent with
Double.equals(Object)
andDouble.compare(double, double)
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(char unexpected, Character actual) Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Character unexpected, char actual) Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Character unexpected, Character actual) Assert thatexpected
andactual
are not equal.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(char unexpected, char actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(char unexpected, Character actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Character unexpected, char actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Character unexpected, Character actual, String message) Assert thatexpected
andactual
are not equal.Fails with the supplied failure
message
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(char unexpected, char actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(char unexpected, Character actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Character unexpected, char actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
@API(status=STABLE, since="5.4") public static void assertNotEquals(Character unexpected, Character actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.4
-
assertNotEquals
Assert thatexpected
andactual
are not equal.Fails if both are
null
.- See Also:
-
assertNotEquals
Assert thatexpected
andactual
are not equal.Fails if both are
null
.Fails with the supplied failure
message
.- See Also:
-
assertNotEquals
public static void assertNotEquals(Object unexpected, Object actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
are not equal.Fails if both are
null
.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- See Also:
-
assertSame
Assert thatexpected
andactual
refer to the same object. -
assertSame
Assert thatexpected
andactual
refer to the same object.Fails with the supplied failure
message
. -
assertSame
Assert thatexpected
andactual
refer to the same object.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertNotSame
Assert thatexpected
andactual
do not refer to the same object. -
assertNotSame
Assert thatexpected
andactual
do not refer to the same object.Fails with the supplied failure
message
. -
assertNotSame
public static void assertNotSame(Object unexpected, Object actual, Supplier<String> messageSupplier) Assert thatexpected
andactual
do not refer to the same object.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertAll
Assert that all suppliedexecutables
do not throw exceptions.See Javadoc for
assertAll(String, Stream)
for an explanation of this method's exception handling semantics. -
assertAll
public static void assertAll(String heading, Executable... executables) throws MultipleFailuresError Assert that all suppliedexecutables
do not throw exceptions.See Javadoc for
assertAll(String, Stream)
for an explanation of this method's exception handling semantics. -
assertAll
Assert that all suppliedexecutables
do not throw exceptions.See Javadoc for
assertAll(String, Stream)
for an explanation of this method's exception handling semantics. -
assertAll
public static void assertAll(String heading, Collection<Executable> executables) throws MultipleFailuresError Assert that all suppliedexecutables
do not throw exceptions.See Javadoc for
assertAll(String, Stream)
for an explanation of this method's exception handling semantics. -
assertAll
Assert that all suppliedexecutables
do not throw exceptions.See Javadoc for
assertAll(String, Stream)
for an explanation of this method's exception handling semantics. -
assertAll
public static void assertAll(String heading, Stream<Executable> executables) throws MultipleFailuresError Assert that all suppliedexecutables
do not throw exceptions.If any supplied
Executable
throws an exception (i.e., aThrowable
or any subclass thereof), all remainingexecutables
will still be executed, and all exceptions will be aggregated and reported in aMultipleFailuresError
. In addition, all aggregated exceptions will be added as suppressed exceptions to theMultipleFailuresError
. However, if anexecutable
throws an unrecoverable exception — for example, anOutOfMemoryError
— execution will halt immediately, and the unrecoverable exception will be rethrown as is but masked as an unchecked exception.The supplied
heading
will be included in the message string for theMultipleFailuresError
. -
assertThrowsExactly
@API(status=EXPERIMENTAL, since="5.8") public static <T extends Throwable> T assertThrowsExactly(Class<T> expectedType, Executable executable) Assert that execution of the suppliedexecutable
throws an exception of exactly theexpectedType
and return the exception.If no exception is thrown, or if an exception of a different type is thrown, this method will fail.
If you do not want to perform additional checks on the exception instance, ignore the return value.
- Since:
- 5.8
-
assertThrowsExactly
@API(status=EXPERIMENTAL, since="5.8") public static <T extends Throwable> T assertThrowsExactly(Class<T> expectedType, Executable executable, String message) Assert that execution of the suppliedexecutable
throws an exception of exactly theexpectedType
and return the exception.If no exception is thrown, or if an exception of a different type is thrown, this method will fail.
If you do not want to perform additional checks on the exception instance, ignore the return value.
Fails with the supplied failure
message
.- Since:
- 5.8
-
assertThrowsExactly
@API(status=EXPERIMENTAL, since="5.8") public static <T extends Throwable> T assertThrowsExactly(Class<T> expectedType, Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
throws an exception of exactly theexpectedType
and return the exception.If no exception is thrown, or if an exception of a different type is thrown, this method will fail.
If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.If you do not want to perform additional checks on the exception instance, ignore the return value.
- Since:
- 5.8
-
assertThrows
Assert that execution of the suppliedexecutable
throws an exception of theexpectedType
and return the exception.If no exception is thrown, or if an exception of a different type is thrown, this method will fail.
If you do not want to perform additional checks on the exception instance, ignore the return value.
-
assertThrows
public static <T extends Throwable> T assertThrows(Class<T> expectedType, Executable executable, String message) Assert that execution of the suppliedexecutable
throws an exception of theexpectedType
and return the exception.If no exception is thrown, or if an exception of a different type is thrown, this method will fail.
If you do not want to perform additional checks on the exception instance, ignore the return value.
Fails with the supplied failure
message
. -
assertThrows
public static <T extends Throwable> T assertThrows(Class<T> expectedType, Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
throws an exception of theexpectedType
and return the exception.If no exception is thrown, or if an exception of a different type is thrown, this method will fail.
If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.If you do not want to perform additional checks on the exception instance, ignore the return value.
-
assertDoesNotThrow
Assert that execution of the suppliedexecutable
does not throw any kind of exception.Usage Note
Although any exception thrown from a test method will cause the test to fail, there are certain use cases where it can be beneficial to explicitly assert that an exception is not thrown for a given code block within a test method.
- Since:
- 5.2
-
assertDoesNotThrow
@API(status=STABLE, since="5.2") public static void assertDoesNotThrow(Executable executable, String message) Assert that execution of the suppliedexecutable
does not throw any kind of exception.Usage Note
Although any exception thrown from a test method will cause the test to fail, there are certain use cases where it can be beneficial to explicitly assert that an exception is not thrown for a given code block within a test method.
Fails with the supplied failure
message
.- Since:
- 5.2
-
assertDoesNotThrow
@API(status=STABLE, since="5.2") public static void assertDoesNotThrow(Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
does not throw any kind of exception.Usage Note
Although any exception thrown from a test method will cause the test to fail, there are certain use cases where it can be beneficial to explicitly assert that an exception is not thrown for a given code block within a test method.
If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.2
-
assertDoesNotThrow
@API(status=STABLE, since="5.2") public static <T> T assertDoesNotThrow(ThrowingSupplier<T> supplier) Assert that execution of the suppliedsupplier
does not throw any kind of exception.If the assertion passes, the
supplier
's result will be returned.Usage Note
Although any exception thrown from a test method will cause the test to fail, there are certain use cases where it can be beneficial to explicitly assert that an exception is not thrown for a given code block within a test method.
- Since:
- 5.2
-
assertDoesNotThrow
@API(status=STABLE, since="5.2") public static <T> T assertDoesNotThrow(ThrowingSupplier<T> supplier, String message) Assert that execution of the suppliedsupplier
does not throw any kind of exception.If the assertion passes, the
supplier
's result will be returned.Fails with the supplied failure
message
.Usage Note
Although any exception thrown from a test method will cause the test to fail, there are certain use cases where it can be beneficial to explicitly assert that an exception is not thrown for a given code block within a test method.
- Since:
- 5.2
-
assertDoesNotThrow
@API(status=STABLE, since="5.2") public static <T> T assertDoesNotThrow(ThrowingSupplier<T> supplier, Supplier<String> messageSupplier) Assert that execution of the suppliedsupplier
does not throw any kind of exception.If the assertion passes, the
supplier
's result will be returned.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.Usage Note
Although any exception thrown from a test method will cause the test to fail, there are certain use cases where it can be beneficial to explicitly assert that an exception is not thrown for a given code block within a test method.
- Since:
- 5.2
-
assertTimeout
Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.Note: the
executable
will be executed in the same thread as that of the calling code. Consequently, execution of theexecutable
will not be preemptively aborted if the timeout is exceeded. -
assertTimeout
Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.Note: the
executable
will be executed in the same thread as that of the calling code. Consequently, execution of theexecutable
will not be preemptively aborted if the timeout is exceeded.Fails with the supplied failure
message
. -
assertTimeout
public static void assertTimeout(Duration timeout, Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.Note: the
executable
will be executed in the same thread as that of the calling code. Consequently, execution of theexecutable
will not be preemptively aborted if the timeout is exceeded.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertTimeout
Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.If the assertion passes then the
supplier
's result is returned.Note: the
supplier
will be executed in the same thread as that of the calling code. Consequently, execution of thesupplier
will not be preemptively aborted if the timeout is exceeded. -
assertTimeout
Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.If the assertion passes then the
supplier
's result is returned.Note: the
supplier
will be executed in the same thread as that of the calling code. Consequently, execution of thesupplier
will not be preemptively aborted if the timeout is exceeded.Fails with the supplied failure
message
. -
assertTimeout
public static <T> T assertTimeout(Duration timeout, ThrowingSupplier<T> supplier, Supplier<String> messageSupplier) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.If the assertion passes then the
supplier
's result is returned.Note: the
supplier
will be executed in the same thread as that of the calling code. Consequently, execution of thesupplier
will not be preemptively aborted if the timeout is exceeded.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
. -
assertTimeoutPreemptively
Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.Note: the
executable
will be executed in a different thread than that of the calling code. Furthermore, execution of theexecutable
will be preemptively aborted if the timeout is exceeded. See the Preemptive Timeouts section of the class-level Javadoc for a discussion of possible undesirable side effects.- See Also:
-
assertTimeoutPreemptively(Duration, Executable, String)
assertTimeoutPreemptively(Duration, Executable, Supplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier, String)
assertTimeoutPreemptively(Duration, ThrowingSupplier, Supplier)
assertTimeout(Duration, Executable)
-
assertTimeoutPreemptively
public static void assertTimeoutPreemptively(Duration timeout, Executable executable, String message) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.Note: the
executable
will be executed in a different thread than that of the calling code. Furthermore, execution of theexecutable
will be preemptively aborted if the timeout is exceeded. See the Preemptive Timeouts section of the class-level Javadoc for a discussion of possible undesirable side effects.Fails with the supplied failure
message
.- See Also:
-
assertTimeoutPreemptively(Duration, Executable)
assertTimeoutPreemptively(Duration, Executable, Supplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier, String)
assertTimeoutPreemptively(Duration, ThrowingSupplier, Supplier)
assertTimeout(Duration, Executable, String)
-
assertTimeoutPreemptively
public static void assertTimeoutPreemptively(Duration timeout, Executable executable, Supplier<String> messageSupplier) Assert that execution of the suppliedexecutable
completes before the giventimeout
is exceeded.Note: the
executable
will be executed in a different thread than that of the calling code. Furthermore, execution of theexecutable
will be preemptively aborted if the timeout is exceeded. See the Preemptive Timeouts section of the class-level Javadoc for a discussion of possible undesirable side effects.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- See Also:
-
assertTimeoutPreemptively(Duration, Executable)
assertTimeoutPreemptively(Duration, Executable, String)
assertTimeoutPreemptively(Duration, ThrowingSupplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier, String)
assertTimeoutPreemptively(Duration, ThrowingSupplier, Supplier)
assertTimeout(Duration, Executable, Supplier)
-
assertTimeoutPreemptively
Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.If the assertion passes then the
supplier
's result is returned.Note: the
supplier
will be executed in a different thread than that of the calling code. Furthermore, execution of thesupplier
will be preemptively aborted if the timeout is exceeded. See the Preemptive Timeouts section of the class-level Javadoc for a discussion of possible undesirable side effects.- See Also:
-
assertTimeoutPreemptively(Duration, Executable)
assertTimeoutPreemptively(Duration, Executable, String)
assertTimeoutPreemptively(Duration, Executable, Supplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier, String)
assertTimeoutPreemptively(Duration, ThrowingSupplier, Supplier)
assertTimeout(Duration, Executable)
-
assertTimeoutPreemptively
public static <T> T assertTimeoutPreemptively(Duration timeout, ThrowingSupplier<T> supplier, String message) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.If the assertion passes then the
supplier
's result is returned.Note: the
supplier
will be executed in a different thread than that of the calling code. Furthermore, execution of thesupplier
will be preemptively aborted if the timeout is exceeded. See the Preemptive Timeouts section of the class-level Javadoc for a discussion of possible undesirable side effects.Fails with the supplied failure
message
.- See Also:
-
assertTimeoutPreemptively(Duration, Executable)
assertTimeoutPreemptively(Duration, Executable, String)
assertTimeoutPreemptively(Duration, Executable, Supplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier, Supplier)
assertTimeout(Duration, Executable, String)
-
assertTimeoutPreemptively
public static <T> T assertTimeoutPreemptively(Duration timeout, ThrowingSupplier<T> supplier, Supplier<String> messageSupplier) Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.If the assertion passes then the
supplier
's result is returned.Note: the
supplier
will be executed in a different thread than that of the calling code. Furthermore, execution of thesupplier
will be preemptively aborted if the timeout is exceeded. See the Preemptive Timeouts section of the class-level Javadoc for a discussion of possible undesirable side effects.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- See Also:
-
assertTimeoutPreemptively(Duration, Executable)
assertTimeoutPreemptively(Duration, Executable, String)
assertTimeoutPreemptively(Duration, Executable, Supplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier, String)
assertTimeout(Duration, Executable, Supplier)
-
assertTimeoutPreemptively
@API(status=INTERNAL, since="5.9.1") public static <T,E extends Throwable> T assertTimeoutPreemptively(Duration timeout, ThrowingSupplier<T> supplier, Supplier<String> messageSupplier, Assertions.TimeoutFailureFactory<E> failureFactory) throws E Assert that execution of the suppliedsupplier
completes before the giventimeout
is exceeded.If the assertion passes then the
supplier
's result is returned.In the case the assertion does not pass, the supplied
Assertions.TimeoutFailureFactory
is invoked to create an exception which is then thrown.Note: the
supplier
will be executed in a different thread than that of the calling code. Furthermore, execution of thesupplier
will be preemptively aborted if the timeout is exceeded. See the Preemptive Timeouts section of the class-level Javadoc for a discussion of possible undesirable side effects.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Throws:
E extends Throwable
- See Also:
-
assertTimeoutPreemptively(Duration, Executable)
assertTimeoutPreemptively(Duration, Executable, String)
assertTimeoutPreemptively(Duration, Executable, Supplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier)
assertTimeoutPreemptively(Duration, ThrowingSupplier, String)
assertTimeout(Duration, Executable, Supplier)
-
assertInstanceOf
@API(status=EXPERIMENTAL, since="5.8") public static <T> T assertInstanceOf(Class<T> expectedType, Object actualValue) Assert that the suppliedactualValue
is an instance of theexpectedType
.Like the
instanceof
operator anull
value is not considered to be of theexpectedType
and does not pass the assertion.- Since:
- 5.8
-
assertInstanceOf
@API(status=EXPERIMENTAL, since="5.8") public static <T> T assertInstanceOf(Class<T> expectedType, Object actualValue, String message) Assert that the suppliedactualValue
is an instance of theexpectedType
.Like the
instanceof
operator anull
value is not considered to be of theexpectedType
and does not pass the assertion.Fails with the supplied failure
message
.- Since:
- 5.8
-
assertInstanceOf
@API(status=EXPERIMENTAL, since="5.8") public static <T> T assertInstanceOf(Class<T> expectedType, Object actualValue, Supplier<String> messageSupplier) Assert that the suppliedactualValue
is an instance of theexpectedType
.Like the
instanceof
operator anull
value is not considered to be of theexpectedType
and does not pass the assertion.If necessary, the failure message will be retrieved lazily from the supplied
messageSupplier
.- Since:
- 5.8
-