Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.
added in API level 1
Deprecated since API level 24

MoreAsserts

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(String, String, 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(Map<?, ?> map)

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

static void assertEmpty(Iterable<?> iterable)

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

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

Asserts that iterable is empty.

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

Asserts that map 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, 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(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<? extends Object> expected, Set<? extends Object> actual)

Asserts that two sets contain the same elements.

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(Set<? extends Object> expected, Set<? extends Object> actual)

Asserts that two sets contain the same elements.

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(String, String, 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(String, String, String) using a generic message.

static void assertNotEmpty(Iterable<?> iterable)

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

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

Asserts that map is not empty.

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

Asserts that iterable is not empty.

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

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

static void assertNotEqual(Object unexpected, Object actual)

Variant of assertNotEqual(String, Object, 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(Object).

static void assertNotMatchesRegex(String expectedRegex, String actual)

Variant of assertNotMatchesRegex(String, String, 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

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(String, String, 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(String).

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 (Map<?, ?> map)

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

Parameters
map Map

assertEmpty

added in API level 1
public static void assertEmpty (Iterable<?> iterable)

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

Parameters
iterable Iterable

assertEmpty

added in API level 1
public static void assertEmpty (String message, 
                Iterable<?> iterable)

Asserts that iterable is empty.

Parameters
message String

iterable Iterable

assertEmpty

added in API level 1
public static void assertEmpty (String message, 
                Map<?, ?> map)

Asserts that map is empty.

Parameters
message String

map Map

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, 
                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 (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, 
                Set<? extends Object> expected, 
                Set<? extends Object> 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, 
                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 (Set<? extends Object> expected, 
                Set<? extends Object> actual)

Asserts that two sets contain the same elements.

Parameters
expected Set

actual Set

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(String, String, 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(String).

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(String).

Parameters
message String

expectedRegex String

actual String

assertNotContainsRegex

added in API level 1
public static void assertNotContainsRegex (String expectedRegex, 
                String actual)

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

Parameters
expectedRegex String

actual String

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, 
                Map<?, ?> map)

Asserts that map is not empty.

Parameters
message String

map Map

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 (Map<?, ?> map)

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

Parameters
map Map

assertNotEqual

added in API level 1
public static void assertNotEqual (Object unexpected, 
                Object actual)

Variant of assertNotEqual(String, Object, 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(Object).

Parameters
message String

unexpected Object

actual Object

assertNotMatchesRegex

added in API level 1
public static void assertNotMatchesRegex (String expectedRegex, 
                String actual)

Variant of assertNotMatchesRegex(String, String, 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(String).

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