Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public final class

MoreAsserts

extends Object
java.lang.Object
   ↳ android.test.MoreAsserts

Class Overview

Contains additional assertion methods not found in JUnit.

Summary

Public Methods
static void , java.lang.Class )">assertAssignableFrom ( Class <?> expected, Class <?> actual)
Asserts that class expected is assignable from the class actual .
static void , java.lang.Object)">assertAssignableFrom ( Class <?> expected, Object actual)
Asserts that the class expected is assignable from the object 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 , java.lang.Object...)">assertContentsInAnyOrder ( Iterable <?> actual, Object... expected)
Variant of assertContentsInAnyOrder(String, Iterable , Object...) using a generic message.
static void , java.lang.Object...)">assertContentsInAnyOrder ( String message, Iterable <?> actual, Object... expected)
Asserts that actual contains precisely the elements expected , but in any order.
static void , java.lang.Object...)">assertContentsInOrder ( Iterable <?> actual, Object... expected)
Variant of assertContentsInOrder(String, Iterable , Object...) using a generic message.
static void , java.lang.Object...)">assertContentsInOrder ( String message, Iterable <?> actual, Object... expected)
Asserts that actual contains precisely the elements expected , and in the same order.
static void )">assertEmpty ( Iterable <?> iterable)
Variant of )">assertEmpty(String, Iterable) using a generic message.
static void )">assertEmpty ( String message, Map <?, ?> map)
Asserts that map is empty.
static void )">assertEmpty ( String message, Iterable <?> iterable)
Asserts that iterable is empty.
static void )">assertEmpty ( Map <?, ?> map)
Variant of )">assertEmpty(String, Map) using a generic message.
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 , java.util.Set )">assertEquals ( Set <? extends  Object > expected, Set <? extends  Object > actual)
Asserts that two sets contain the same elements.
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 , java.util.Set )">assertEquals ( String message, Set <? extends  Object > expected, Set <? extends  Object > 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 (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, 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 MatchResult assertMatchesRegex ( String message, String expectedRegex, String actual)
Asserts that expectedRegex exactly matches actual and fails with message if it does not.
static MatchResult assertMatchesRegex ( String expectedRegex, String actual)
Variant of assertMatchesRegex(String, String, String) using a generic message.
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 ( Map <?, ?> map)
Variant of )">assertNotEmpty(String, Map) 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 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 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.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

, java.lang.Class )">

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

Added in API level 1

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

, java.lang.Object)">

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

Added in API level 1

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

public static MatchResult assertContainsRegex ( String expectedRegex, String actual)

Added in API level 1

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

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

Added in API level 1

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

, java.lang.Object...)">

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

Added in API level 1

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

, java.lang.Object...)">

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

Added in API level 1

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

, java.lang.Object...)">

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

Added in API level 1

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

, java.lang.Object...)">

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

Added in API level 1

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

)">

public static void assertEmpty ( Iterable <?> iterable)

Added in API level 1

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

)">

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

Added in API level 1

Asserts that map is empty.

)">

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

Added in API level 1

Asserts that iterable is empty.

)">

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

Added in API level 1

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

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

Added in API level 1

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

, java.util.Set )">

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

Added in API level 1

Asserts that two sets contain the same elements.

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

Added in API level 1

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

, java.util.Set )">

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

Added in API level 1

Asserts that two sets contain the same elements.

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

Added in API level 1

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.

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

Added in API level 1

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.

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

Added in API level 1

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

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

Added in API level 1

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

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

Added in API level 1

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

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

Added in API level 1

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

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

Added in API level 1

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

public static MatchResult assertMatchesRegex ( String expectedRegex, String actual)

Added in API level 1

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

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

Added in API level 1

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

public static void assertNotContainsRegex ( String expectedRegex, String actual)

Added in API level 1

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

)">

public static void assertNotEmpty ( Iterable <?> iterable)

Added in API level 1

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

)">

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

Added in API level 1

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

)">

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

Added in API level 1

Asserts that map is not empty.

)">

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

Added in API level 1

Asserts that iterable is not empty.

public static void assertNotEqual ( Object unexpected, Object actual)

Added in API level 1

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

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

Added in API level 1

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

public static void assertNotMatchesRegex ( String expectedRegex, String actual)

Added in API level 1

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

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

Added in API level 1

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

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

Added in API level 1

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
lhs An Object for which equals() and hashCode() are to be tested.
rhs As lhs.
expectedResult True if the objects should compare equal, false if not.

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

Added in API level 1

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