{% setvar book_path %}/reference/kotlin/androidx/_book.yaml{% endsetvar %} {% include "_shared/_reference-head-tags.html" %}
class PositionAssertions
A collection of ViewAssertions for checking relative position of elements on the screen.
These comparisons are on the x,y plane; they ignore the z plane.
Public constructors |
|
|---|---|
Public functions |
|
|---|---|
java-static ViewAssertion! |
This function is deprecated. Use |
java-static ViewAssertion! |
This function is deprecated. Use |
java-static ViewAssertion! |
isBottomAlignedWith(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isCompletelyAbove(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isCompletelyBelow(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isCompletelyLeftOf(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isCompletelyRightOf(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isLeftAlignedWith(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
This function is deprecated. Use |
java-static ViewAssertion! |
isPartiallyAbove(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isPartiallyBelow(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isPartiallyLeftOf(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isPartiallyRightOf(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
isRightAlignedWith(matcher: Matcher<View!>!)Returns a |
java-static ViewAssertion! |
This function is deprecated. Use |
java-static ViewAssertion! |
isTopAlignedWith(matcher: Matcher<View!>!)Returns a |
java-static funisAbove(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is completely above the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is any vertical overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static funisBelow(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is completely below the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there any vertical overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isBottomAlignedWith(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is bottom aligned with the view matching the given matcher.
The bottom 'y' coordinate of the view displayed must equal the bottom 'y' coordinate of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if the views are not aligned bottom. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isCompletelyAbove(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is completely above the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is any vertical overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isCompletelyBelow(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is completely below the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is any vertical overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isCompletelyLeftOf(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is completely left of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is any horizontal overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isCompletelyRightOf(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is completely right of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is any horizontal overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isLeftAlignedWith(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is left aligned with the view matching the given matcher.
The left 'x' coordinate of the view displayed must equal the left 'x' coordinate of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if the views are not aligned to the left. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static funisLeftOf(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is completely left of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is any horizontal overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isPartiallyAbove(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is partially above the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is no vertical overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isPartiallyBelow(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is partially below the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is no vertical overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isPartiallyLeftOf(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is partially left of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is no horizontal overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isPartiallyRightOf(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is partially right of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is no horizontal overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isRightAlignedWith(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is right aligned with the view matching the given matcher.
The right 'x' coordinate of the view displayed must equal the right 'x' coordinate of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if the views are not aligned to the right. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static funisRightOf(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is completely right of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if there is any horizontal overlap. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |
java-static fun isTopAlignedWith(matcher: Matcher<View!>!): ViewAssertion!
Returns a ViewAssertion that asserts that view displayed is top aligned with the view matching the given matcher.
The top 'y' coordinate of the view displayed must equal the top 'y' coordinate of the view matching the given matcher.
| Throws | |
|---|---|
junit.framework.AssertionFailedError: junit.framework.AssertionFailedError |
if the views are not aligned top. |
androidx.test.espresso.AmbiguousViewMatcherException: androidx.test.espresso.AmbiguousViewMatcherException |
if more than one view matches the given matcher. |
androidx.test.espresso.NoMatchingViewException: androidx.test.espresso.NoMatchingViewException |
if no views match the given matcher. |