Added in API level 1
Deprecated in API level 24

Summary: Methods | Inherited Methods

MoreAsserts

---

Kotlin |Java

public final class MoreAsserts
extends Object

java.lang.Object
↳	android.test.MoreAsserts

---

This class was deprecated in API level 24.
Use Hamcrest matchers instead.

Contains additional assertion methods not found in JUnit.

Summary

Public methods
static void	assertAssignableFrom(Class<?> expected, Object actual) Asserts that the class expected is assignable from the object actual.
static void	assertAssignableFrom(Class<?> expected, Class<?> actual) Asserts that class expected is assignable from the class actual.
static MatchResult	assertContainsRegex(String expectedRegex, String actual) Variant of assertContainsRegex(java.lang.String, java.lang.String, java.lang.String) using a generic message.
static MatchResult	assertContainsRegex(String message, String expectedRegex, String actual) Asserts that expectedRegex matches any substring of actual and fails with message if it does not.
static void	assertContentsInAnyOrder(String message, Iterable<?> actual, Object... expected) Asserts that actual contains precisely the elements expected, but in any order.
static void	assertContentsInAnyOrder(Iterable<?> actual, Object... expected) Variant of assertContentsInAnyOrder(String, Iterable, Object...) using a generic message.
static void	assertContentsInOrder(Iterable<?> actual, Object... expected) Variant of assertContentsInOrder(String, Iterable, Object...) using a generic message.
static void	assertContentsInOrder(String message, Iterable<?> actual, Object... expected) Asserts that actual contains precisely the elements expected, and in the same order.
static void	assertEmpty(String message, Map<?, ?> map) Asserts that map is empty.
static void	assertEmpty(Iterable<?> iterable) Variant of assertEmpty(java.lang.String, java.lang.Iterable) using a generic message.
static void	assertEmpty(Map<?, ?> map) Variant of assertEmpty(java.lang.String, java.util.Map) using a generic message.
static void	assertEmpty(String message, Iterable<?> iterable) Asserts that iterable is empty.
static void	assertEquals(String message, int[] expected, int[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(String message, Set<?> expected, Set<?> actual) Asserts that two sets contain the same elements.
static void	assertEquals(String message, Object[] expected, Object[] actual) Asserts that array actual is the same size and every element is the same as those in array expected.
static void	assertEquals(Object[] expected, Object[] actual) Asserts that array actual is the same size and every element is the same as those in array expected.
static void	assertEquals(byte[] expected, byte[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(Set<?> expected, Set<?> actual) Asserts that two sets contain the same elements.
static void	assertEquals(int[] expected, int[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(String message, double[] expected, double[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(String message, byte[] expected, byte[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static void	assertEquals(double[] expected, double[] actual) Asserts that array actual is the same size and every element equals those in array expected.
static MatchResult	assertMatchesRegex(String expectedRegex, String actual) Variant of assertMatchesRegex(java.lang.String, java.lang.String, java.lang.String) using a generic message.
static MatchResult	assertMatchesRegex(String message, String expectedRegex, String actual) Asserts that expectedRegex exactly matches actual and fails with message if it does not.
static void	assertNotContainsRegex(String message, String expectedRegex, String actual) Asserts that expectedRegex does not match any substring of actual, and fails with message if it does.
static void	assertNotContainsRegex(String expectedRegex, String actual) Variant of assertNotContainsRegex(java.lang.String, java.lang.String, java.lang.String) using a generic message.
static void	assertNotEmpty(Map<?, ?> map) Variant of assertNotEmpty(java.lang.String, java.util.Map) using a generic message.
static void	assertNotEmpty(Iterable<?> iterable) Variant of assertNotEmpty(String, Iterable) using a generic message.
static void	assertNotEmpty(String message, Iterable<?> iterable) Asserts that iterable is not empty.
static void	assertNotEmpty(String message, Map<?, ?> map) Asserts that map is not empty.
static void	assertNotEqual(Object unexpected, Object actual) Variant of assertNotEqual(java.lang.String, java.lang.Object, java.lang.Object) using a generic message.
static void	assertNotEqual(String message, Object unexpected, Object actual) Asserts that actual is not equal unexpected, according to both == and Object.equals.
static void	assertNotMatchesRegex(String expectedRegex, String actual) Variant of assertNotMatchesRegex(java.lang.String, java.lang.String, java.lang.String) using a generic message.
static void	assertNotMatchesRegex(String message, String expectedRegex, String actual) Asserts that expectedRegex does not exactly match actual, and fails with message if it does.
static void	checkEqualsAndHashCodeMethods(String message, Object lhs, Object rhs, boolean expectedResult) Utility for testing equals() and hashCode() results at once.
static void	checkEqualsAndHashCodeMethods(Object lhs, Object rhs, boolean expectedResult) Variant of checkEqualsAndHashCodeMethods(String,Object,Object,boolean...)} using a generic message.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

assertAssignableFrom

Added in API level 1

public static void assertAssignableFrom (Class<?> expected, 
                Object actual)

Asserts that the class expected is assignable from the object actual. This verifies expected is a parent class or a interface that actual implements.

Parameters
expected	Class
actual	Object

assertAssignableFrom

Added in API level 1

public static void assertAssignableFrom (Class<?> expected, 
                Class<?> actual)

Asserts that class expected is assignable from the class actual. This verifies expected is a parent class or a interface that actual implements.

Parameters
expected	Class
actual	Class

assertContainsRegex

Added in API level 1

public static MatchResult assertContainsRegex (String expectedRegex, 
                String actual)

Variant of assertContainsRegex(java.lang.String, java.lang.String, java.lang.String) using a generic message.

Parameters
expectedRegex	String
actual	String

Returns
MatchResult

assertContainsRegex

Added in API level 1

public static MatchResult assertContainsRegex (String message, 
                String expectedRegex, 
                String actual)

Asserts that expectedRegex matches any substring of actual and fails with message if it does not. The Matcher is returned in case the test needs access to any captured groups. Note that you can also use this for a literal string, by wrapping your expected string in Pattern.quote.

Parameters
message	String
expectedRegex	String
actual	String

Returns
MatchResult

assertContentsInAnyOrder

Added in API level 1

public static void assertContentsInAnyOrder (String message, 
                Iterable<?> actual, 
                Object... expected)

Asserts that actual contains precisely the elements expected, but in any order.

Parameters
message	String
actual	Iterable
expected	Object

assertContentsInAnyOrder

Added in API level 1

public static void assertContentsInAnyOrder (Iterable<?> actual, 
                Object... expected)

Variant of assertContentsInAnyOrder(String, Iterable, Object...) using a generic message.

Parameters
actual	Iterable
expected	Object

assertContentsInOrder

Added in API level 1

public static void assertContentsInOrder (Iterable<?> actual, 
                Object... expected)

Variant of assertContentsInOrder(String, Iterable, Object...) using a generic message.

Parameters
actual	Iterable
expected	Object

assertContentsInOrder

Added in API level 1

public static void assertContentsInOrder (String message, 
                Iterable<?> actual, 
                Object... expected)

Asserts that actual contains precisely the elements expected, and in the same order.

Parameters
message	String
actual	Iterable
expected	Object

assertEmpty

Added in API level 1

public static void assertEmpty (String message, 
                Map<?, ?> map)

Asserts that map is empty.

Parameters
message	String
map	Map

assertEmpty

Added in API level 1

public static void assertEmpty (Iterable<?> iterable)

Variant of assertEmpty(java.lang.String, java.lang.Iterable) using a generic message.

Parameters
iterable	Iterable

assertEmpty

Added in API level 1

public static void assertEmpty (Map<?, ?> map)

Variant of assertEmpty(java.lang.String, java.util.Map) using a generic message.

Parameters
map	Map

assertEmpty

Added in API level 1

public static void assertEmpty (String message, 
                Iterable<?> iterable)

Asserts that iterable is empty.

Parameters
message	String
iterable	Iterable

assertEquals

Added in API level 1

public static void assertEquals (String message, 
                int[] expected, 
                int[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates first specific element mismatch.

Parameters
message	String
expected	int
actual	int

assertEquals

Added in API level 1

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

Asserts that two sets contain the same elements.

Parameters
message	String
expected	Set
actual	Set

assertEquals

Added in API level 1

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

Asserts that array actual is the same size and every element is the same as those in array expected. Note that this uses equals() instead of == to compare the objects. null will be considered equal to null (unlike SQL). On failure, message indicates first specific element mismatch.

Parameters
message	String
expected	Object
actual	Object

assertEquals

Added in API level 1

public static void assertEquals (Object[] expected, 
                Object[] actual)

Asserts that array actual is the same size and every element is the same as those in array expected. Note that this uses == instead of equals() to compare the objects. On failure, message indicates first specific element mismatch.

Parameters
expected	Object
actual	Object

assertEquals

Added in API level 1

public static void assertEquals (byte[] expected, 
                byte[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates specific element mismatch.

Parameters
expected	byte
actual	byte

assertEquals

Added in API level 1

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

Asserts that two sets contain the same elements.

Parameters
expected	Set
actual	Set

assertEquals

Added in API level 1

public static void assertEquals (int[] expected, 
                int[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates first specific element mismatch.

Parameters
expected	int
actual	int

assertEquals

Added in API level 1

public static void assertEquals (String message, 
                double[] expected, 
                double[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates first specific element mismatch.

Parameters
message	String
expected	double
actual	double

assertEquals

Added in API level 1

public static void assertEquals (String message, 
                byte[] expected, 
                byte[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates specific element mismatch.

Parameters
message	String
expected	byte
actual	byte

assertEquals

Added in API level 1

public static void assertEquals (double[] expected, 
                double[] actual)

Asserts that array actual is the same size and every element equals those in array expected. On failure, message indicates first specific element mismatch.

Parameters
expected	double
actual	double

assertMatchesRegex

Added in API level 1

public static MatchResult assertMatchesRegex (String expectedRegex, 
                String actual)

Variant of assertMatchesRegex(java.lang.String, java.lang.String, java.lang.String) using a generic message.

Parameters
expectedRegex	String
actual	String

Returns
MatchResult

assertMatchesRegex

Added in API level 1

public static MatchResult assertMatchesRegex (String message, 
                String expectedRegex, 
                String actual)

Asserts that expectedRegex exactly matches actual and fails with message if it does not. The MatchResult is returned in case the test needs access to any captured groups. Note that you can also use this for a literal string, by wrapping your expected string in Pattern.quote.

Parameters
message	String
expectedRegex	String
actual	String

Returns
MatchResult

assertNotContainsRegex

Added in API level 1

public static void assertNotContainsRegex (String message, 
                String expectedRegex, 
                String actual)

Asserts that expectedRegex does not match any substring of actual, and fails with message if it does. Note that you can also use this for a literal string, by wrapping your expected string in Pattern.quote.

Parameters
message	String
expectedRegex	String
actual	String

assertNotContainsRegex

Added in API level 1

public static void assertNotContainsRegex (String expectedRegex, 
                String actual)

Variant of assertNotContainsRegex(java.lang.String, java.lang.String, java.lang.String) using a generic message.

Parameters
expectedRegex	String
actual	String

assertNotEmpty

Added in API level 1

public static void assertNotEmpty (Map<?, ?> map)

Variant of assertNotEmpty(java.lang.String, java.util.Map) using a generic message.

Parameters
map	Map

assertNotEmpty

Added in API level 1

public static void assertNotEmpty (Iterable<?> iterable)

Variant of assertNotEmpty(String, Iterable) using a generic message.

Parameters
iterable	Iterable

assertNotEmpty

Added in API level 1

public static void assertNotEmpty (String message, 
                Iterable<?> iterable)

Asserts that iterable is not empty.

Parameters
message	String
iterable	Iterable

assertNotEmpty

Added in API level 1

public static void assertNotEmpty (String message, 
                Map<?, ?> map)

Asserts that map is not empty.

Parameters
message	String
map	Map

assertNotEqual

Added in API level 1

public static void assertNotEqual (Object unexpected, 
                Object actual)

Variant of assertNotEqual(java.lang.String, java.lang.Object, java.lang.Object) using a generic message.

Parameters
unexpected	Object
actual	Object

assertNotEqual

Added in API level 1

public static void assertNotEqual (String message, 
                Object unexpected, 
                Object actual)

Asserts that actual is not equal unexpected, according to both == and Object.equals.

Parameters
message	String
unexpected	Object
actual	Object

assertNotMatchesRegex

Added in API level 1

public static void assertNotMatchesRegex (String expectedRegex, 
                String actual)

Variant of assertNotMatchesRegex(java.lang.String, java.lang.String, java.lang.String) using a generic message.

Parameters
expectedRegex	String
actual	String

assertNotMatchesRegex

Added in API level 1

public static void assertNotMatchesRegex (String message, 
                String expectedRegex, 
                String actual)

Asserts that expectedRegex does not exactly match actual, and fails with message if it does. Note that you can also use this for a literal string, by wrapping your expected string in Pattern.quote.

Parameters
message	String
expectedRegex	String
actual	String

checkEqualsAndHashCodeMethods

Added in API level 1

public static void checkEqualsAndHashCodeMethods (String message, 
                Object lhs, 
                Object rhs, 
                boolean expectedResult)

Utility for testing equals() and hashCode() results at once. Tests that lhs.equals(rhs) matches expectedResult, as well as rhs.equals(lhs). Also tests that hashCode() return values are equal if expectedResult is true. (hashCode() is not tested if expectedResult is false, as unequal objects can have equal hashCodes.)

Parameters
message	String
lhs	Object: An Object for which equals() and hashCode() are to be tested.
rhs	Object: As lhs.
expectedResult	boolean: True if the objects should compare equal, false if not.

checkEqualsAndHashCodeMethods

Added in API level 1

public static void checkEqualsAndHashCodeMethods (Object lhs, 
                Object rhs, 
                boolean expectedResult)

Variant of checkEqualsAndHashCodeMethods(String,Object,Object,boolean...)} using a generic message.

Parameters
lhs	Object
rhs	Object
expectedResult	boolean