379 lines
16 KiB
Kotlin
379 lines
16 KiB
Kotlin
/* This Source Code Form is subject to the terms of the Mozilla Public
|
||
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
||
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
||
|
||
@file:Suppress("TooManyFunctions")
|
||
|
||
package org.mozilla.fenix.ui.robots
|
||
|
||
import androidx.recyclerview.widget.RecyclerView
|
||
import androidx.test.espresso.Espresso.onView
|
||
import androidx.test.espresso.action.ViewActions
|
||
import androidx.test.espresso.action.ViewActions.click
|
||
import androidx.test.espresso.assertion.ViewAssertions.doesNotExist
|
||
import androidx.test.espresso.assertion.ViewAssertions.matches
|
||
import androidx.test.espresso.contrib.RecyclerViewActions
|
||
import androidx.test.espresso.matcher.ViewMatchers
|
||
import androidx.test.espresso.matcher.ViewMatchers.Visibility
|
||
import androidx.test.espresso.matcher.ViewMatchers.isDisplayed
|
||
import androidx.test.espresso.matcher.ViewMatchers.withEffectiveVisibility
|
||
import androidx.test.espresso.matcher.ViewMatchers.withText
|
||
import androidx.test.espresso.matcher.ViewMatchers.withId
|
||
import androidx.test.platform.app.InstrumentationRegistry
|
||
import androidx.test.uiautomator.Until
|
||
import androidx.test.uiautomator.By
|
||
import androidx.test.uiautomator.UiDevice
|
||
import androidx.test.uiautomator.UiScrollable
|
||
import androidx.test.uiautomator.UiSelector
|
||
import org.hamcrest.CoreMatchers
|
||
import org.hamcrest.Matchers.allOf
|
||
import org.hamcrest.Matchers.containsString
|
||
import org.mozilla.fenix.R
|
||
import org.mozilla.fenix.helpers.click
|
||
import org.mozilla.fenix.helpers.TestAssetHelper.waitingTime
|
||
import org.mozilla.fenix.helpers.ext.waitNotNull
|
||
|
||
/**
|
||
* Implementation of Robot Pattern for the home screen menu.
|
||
*/
|
||
class HomeScreenRobot {
|
||
fun verifyNavigationToolbar() = assertNavigationToolbar()
|
||
fun verifyHomeScreen() = assertHomeScreen()
|
||
fun verifyHomePrivateBrowsingButton() = assertHomePrivateBrowsingButton()
|
||
fun verifyHomeMenu() = assertHomeMenu()
|
||
fun verifyOpenTabsHeader() = assertOpenTabsHeader()
|
||
fun verifyAddTabButton() = assertAddTabButton()
|
||
fun verifyNoTabsOpenedText() = assertNoTabsOpenedText()
|
||
fun verifyCollectionsHeader() = assertCollectionsHeader()
|
||
fun verifyNoCollectionsHeader() = assertNoCollectionsHeader()
|
||
fun verifyNoCollectionsText() = assertNoCollectionsText()
|
||
fun verifyNoTabsOpenedHeader() = assertNoTabsOpenedHeader()
|
||
fun verifyHomeWordmark() = assertHomeWordmark()
|
||
fun verifyHomeToolbar() = assertHomeToolbar()
|
||
fun verifyHomeComponent() = assertHomeComponent()
|
||
|
||
// First Run elements
|
||
fun verifyWelcomeHeader() = assertWelcomeHeader()
|
||
|
||
fun verifyGetTheMostHeader() = assertGetTheMostHeader()
|
||
fun verifyAccountsSignInButton() = assertAccountsSignInButton()
|
||
fun verifyGetToKnowHeader() = assertGetToKnowHeader()
|
||
fun verifyChooseThemeHeader() = assertChooseThemeHeader()
|
||
fun verifyChooseThemeText() = assertChooseThemeText()
|
||
fun verifyLightThemeToggle() = assertLightThemeToggle()
|
||
fun verifyLightThemeDescription() = assertLightThemeDescription()
|
||
fun verifyDarkThemeToggle() = assertDarkThemeToggle()
|
||
fun verifyDarkThemeDescription() = assertDarkThemeDescription()
|
||
fun verifyAutomaticThemeToggle() = assertAutomaticThemeToggle()
|
||
fun verifyAutomaticThemeDescription() = assertAutomaticThemeDescription()
|
||
fun verifyProtectYourselfHeader() = assertProtectYourselfHeader()
|
||
fun verifyTrackingProtectionToggle() = assertTrackingProtectionToggle()
|
||
fun verifyProtectYourselfText() = assertProtectYourselfText()
|
||
|
||
fun verifyBrowsePrivatelyHeader() = assertBrowsePrivatelyHeader()
|
||
fun verifyBrowsePrivatelyText() = assertBrowsePrivatelyText()
|
||
fun verifyYourPrivacyHeader() = assertYourPrivacyHeader()
|
||
fun verifyYourPrivacyText() = assertYourPrivacyText()
|
||
fun verifyPrivacyNoticeButton() = assertPrivacyNoticeButton()
|
||
fun verifyStartBrowsingButton() = assertStartBrowsingButton()
|
||
|
||
// Private mode elements
|
||
fun verifyPrivateSessionHeader() = assertPrivateSessionHeader()
|
||
fun verifyPrivateSessionMessage(visible: Boolean = true) = assertPrivateSessionMessage(visible)
|
||
fun verifyShareTabsButton(visible: Boolean = true) = assertShareTabsButton(visible)
|
||
fun verifyCloseTabsButton(visible: Boolean = true) = assertCloseTabsButton(visible)
|
||
|
||
fun verifyExistingTabList() = assertExistingTabList()
|
||
fun verifyExistingOpenTabs(title: String) = assertExistingOpenTabs(title)
|
||
|
||
// Collections element
|
||
fun clickCollectionThreeDotButton() {
|
||
collectionThreeDotButton().click()
|
||
mDevice.waitNotNull(Until.findObject(By.text("Delete collection")), waitingTime)
|
||
}
|
||
fun selectRenameCollection() {
|
||
onView(allOf(ViewMatchers.withText("Rename collection"))).click()
|
||
mDevice.waitNotNull(Until.findObject(By.res("name_collection_edittext")))
|
||
}
|
||
fun selectDeleteCollection() {
|
||
onView(allOf(ViewMatchers.withText("Delete collection"))).click()
|
||
mDevice.waitNotNull(Until.findObject(By.res("message")), waitingTime)
|
||
}
|
||
fun confirmDeleteCollection() {
|
||
onView(allOf(ViewMatchers.withText("DELETE"))).click()
|
||
mDevice.waitNotNull(Until.findObject(By.res("collections_header")), waitingTime)
|
||
}
|
||
fun typeCollectionName(name: String) {
|
||
mDevice.wait(Until.findObject(By.res("name_collection_edittext")), waitingTime)
|
||
|
||
collectionNameTextField().perform(ViewActions.replaceText(name))
|
||
collectionNameTextField().perform(ViewActions.pressImeActionButton())
|
||
}
|
||
fun scrollToElementByText(text: String): UiScrollable {
|
||
val appView = UiScrollable(UiSelector().scrollable(true))
|
||
appView.scrollTextIntoView(text)
|
||
return appView
|
||
}
|
||
fun swipeUpToDismissFirstRun() {
|
||
scrollToElementByText("Start browsing")
|
||
}
|
||
|
||
fun closeTab() {
|
||
closeTabButton().click()
|
||
}
|
||
|
||
fun togglePrivateBrowsingModeOnOff() {
|
||
onView(ViewMatchers.withResourceName("privateBrowsingButton"))
|
||
.perform(click())
|
||
}
|
||
|
||
fun swipeToBottom() = onView(ViewMatchers.withId(R.id.home_component)).perform(ViewActions.swipeUp())
|
||
|
||
fun swipeToTop() = onView(ViewMatchers.withId(R.id.home_component)).perform(ViewActions.swipeDown())
|
||
|
||
class Transition {
|
||
val mDevice = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())
|
||
|
||
fun openThreeDotMenu(interact: ThreeDotMenuMainRobot.() -> Unit): ThreeDotMenuMainRobot.Transition {
|
||
threeDotButton().perform(click())
|
||
|
||
ThreeDotMenuMainRobot().interact()
|
||
return ThreeDotMenuMainRobot.Transition()
|
||
}
|
||
|
||
fun openSearch(interact: SearchRobot.() -> Unit): SearchRobot.Transition {
|
||
navigationToolbar().perform(click())
|
||
|
||
SearchRobot().interact()
|
||
return SearchRobot.Transition()
|
||
}
|
||
|
||
fun dismissOnboarding() {
|
||
openThreeDotMenu { }.openSettings { }.goBack { }
|
||
}
|
||
|
||
fun addNewTab() {
|
||
openSearch { }.openBrowser { }.openHomeScreen { }
|
||
}
|
||
|
||
fun togglePrivateBrowsingMode() {
|
||
onView(ViewMatchers.withResourceName("privateBrowsingButton"))
|
||
.perform(click())
|
||
}
|
||
|
||
fun openTabsListThreeDotMenu(interact: ThreeDotMenuMainRobot.() -> Unit): ThreeDotMenuMainRobot.Transition {
|
||
tabsListThreeDotButton().perform(click())
|
||
|
||
ThreeDotMenuMainRobot().interact()
|
||
return ThreeDotMenuMainRobot.Transition()
|
||
}
|
||
}
|
||
}
|
||
|
||
fun homeScreen(interact: HomeScreenRobot.() -> Unit): HomeScreenRobot.Transition {
|
||
HomeScreenRobot().interact()
|
||
return HomeScreenRobot.Transition()
|
||
}
|
||
|
||
val mDevice = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())
|
||
|
||
private fun navigationToolbar() =
|
||
onView(CoreMatchers.allOf(withText("Search or enter address")))
|
||
|
||
private fun closeTabButton() = onView(withId(R.id.close_tab_button))
|
||
|
||
private fun assertNavigationToolbar() =
|
||
onView(CoreMatchers.allOf(withText("Search or enter address")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertHomeScreen() = onView(ViewMatchers.withResourceName("homeLayout"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertHomeMenu() = onView(ViewMatchers.withResourceName("menuButton"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertHomePrivateBrowsingButton() =
|
||
onView(ViewMatchers.withResourceName("privateBrowsingButton"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertHomeWordmark() = onView(ViewMatchers.withResourceName("wordmark"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertHomeToolbar() = onView(ViewMatchers.withResourceName("toolbar"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertOpenTabsHeader() =
|
||
onView(CoreMatchers.allOf(withText("Open tabs")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertAddTabButton() =
|
||
onView(CoreMatchers.allOf(withId(R.id.add_tab_button), isDisplayed()))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertNoTabsOpenedHeader() =
|
||
onView(CoreMatchers.allOf(withText("No open tabs")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertNoTabsOpenedText() {
|
||
onView(CoreMatchers.allOf(withText("Your open tabs will be shown here.")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
}
|
||
|
||
private fun assertCollectionsHeader() =
|
||
onView(CoreMatchers.allOf(withText("Collections")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertNoCollectionsHeader() =
|
||
onView(CoreMatchers.allOf(withText("No collections")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertNoCollectionsText() =
|
||
onView(
|
||
CoreMatchers.allOf(
|
||
withText("Collect the things that matter to you. To start, save open tabs to a new collection.")
|
||
)
|
||
)
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertHomeComponent() = onView(ViewMatchers.withResourceName("home_component"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun threeDotButton() = onView(allOf(withId(R.id.menuButton)))
|
||
|
||
// First Run elements
|
||
private fun assertWelcomeHeader() =
|
||
onView(CoreMatchers.allOf(withText("Welcome to Firefox Preview!")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertGetTheMostHeader() =
|
||
onView(CoreMatchers.allOf(withText("Get the most out of Firefox Preview.")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertAccountsSignInButton() =
|
||
onView(ViewMatchers.withResourceName("turn_on_sync_button"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertGetToKnowHeader() =
|
||
onView(CoreMatchers.allOf(withText("Get to know Firefox Preview")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertChooseThemeHeader() =
|
||
onView(CoreMatchers.allOf(withText("Choose your theme")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertChooseThemeText() =
|
||
onView(CoreMatchers.allOf(withText("Try dark theme: easier on your battery and your eyes.")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertLightThemeToggle() =
|
||
onView(ViewMatchers.withResourceName("theme_light_radio_button"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertLightThemeDescription() =
|
||
onView(CoreMatchers.allOf(withText("Light theme")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertDarkThemeToggle() =
|
||
onView(ViewMatchers.withResourceName("theme_dark_radio_button"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertDarkThemeDescription() =
|
||
onView(CoreMatchers.allOf(withText("Dark theme")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertAutomaticThemeToggle() =
|
||
onView(ViewMatchers.withResourceName("theme_automatic_radio_button"))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertAutomaticThemeDescription() =
|
||
onView(CoreMatchers.allOf(withText("Automatic")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertProtectYourselfHeader() =
|
||
onView(CoreMatchers.allOf(withText("Protect yourself")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertTrackingProtectionToggle() = onView(
|
||
CoreMatchers.allOf(ViewMatchers.withResourceName("tracking_protection_toggle"))
|
||
)
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertProtectYourselfText() {
|
||
onView(
|
||
CoreMatchers.allOf(
|
||
withText(
|
||
"Firefox Preview blocks ad trackers that follow you around the web."
|
||
)
|
||
)
|
||
)
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
}
|
||
|
||
private fun assertBrowsePrivatelyHeader() =
|
||
onView(CoreMatchers.allOf(withText("Browse privately")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertBrowsePrivatelyText() =
|
||
onView(CoreMatchers.allOf(withText(containsString("private browsing is just a tap away."))))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertYourPrivacyHeader() =
|
||
onView(CoreMatchers.allOf(withText("Your privacy")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertYourPrivacyText() =
|
||
onView(CoreMatchers.allOf(withText(
|
||
"We’ve designed Firefox Preview to give you control over what you share online and what you share with us.")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertPrivacyNoticeButton() =
|
||
onView(CoreMatchers.allOf(withText("Read our privacy notice")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertStartBrowsingButton() =
|
||
onView(CoreMatchers.allOf(withText("Start browsing")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
// Private mode elements
|
||
private fun assertPrivateSessionHeader() =
|
||
onView(CoreMatchers.allOf(withText("Private tabs")))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
const val PRIVATE_SESSION_MESSAGE = "Firefox Preview clears your search and browsing history " +
|
||
"when you quit the app or close all private tabs. While this doesn’t make you anonymous to websites or " +
|
||
"your internet service provider, it makes it easier to keep what you do online private from anyone else " +
|
||
"who uses this device."
|
||
|
||
private fun assertPrivateSessionMessage(visible: Boolean) =
|
||
onView(CoreMatchers.allOf(withText(PRIVATE_SESSION_MESSAGE)))
|
||
.check(
|
||
if (visible) matches(withEffectiveVisibility(Visibility.VISIBLE)) else doesNotExist()
|
||
)
|
||
|
||
private fun assertShareTabsButton(visible: Boolean) =
|
||
onView(CoreMatchers.allOf(withId(R.id.share_tabs_button), isDisplayed()))
|
||
.check(matches(withEffectiveVisibility(visibleOrGone(visible))))
|
||
|
||
private fun assertCloseTabsButton(visible: Boolean) =
|
||
onView(CoreMatchers.allOf(withId(R.id.close_tab_button), isDisplayed()))
|
||
.check(matches(withEffectiveVisibility(visibleOrGone(visible))))
|
||
|
||
private fun visibleOrGone(visibility: Boolean) = if (visibility) Visibility.VISIBLE else Visibility.GONE
|
||
|
||
private fun assertExistingTabList() =
|
||
onView(CoreMatchers.allOf(withId(R.id.item_tab)))
|
||
.check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun assertExistingOpenTabs(title: String) =
|
||
onView(withId(R.id.home_component)).perform(
|
||
RecyclerViewActions.scrollTo<RecyclerView.ViewHolder>(
|
||
ViewMatchers.hasDescendant(withText(title))
|
||
)
|
||
).check(matches(withEffectiveVisibility(Visibility.VISIBLE)))
|
||
|
||
private fun tabsListThreeDotButton() = onView(allOf(withId(R.id.tabs_overflow_button)))
|
||
|
||
private fun collectionThreeDotButton() = onView(allOf(withId(R.id.collection_overflow_button)))
|
||
|
||
private fun collectionNameTextField() = onView(allOf(ViewMatchers.withResourceName("name_collection_edittext")))
|