android espresso web,Espresso Web
Espresso-Web 是一个与 Android WebView 界面组件一起使用的入口点。Espresso-Web 重复使用常用 WebDriver API 中的 Atom 来检查和控制 WebView 的行为。
注意：如果您不熟悉 Espresso，应先阅读主要 Espresso 文档。
何时使用 Espresso-Web
您可以使用 Espresso-Web 来测试混合应用，尤其是应用的原生界面组件与其 WebView 对象内的网页元素进行全面互动。
如果您只需要测试 WebView 与应用中的原生组件之间的互动，可以考虑使用诸如 WebDriver 之类的框架来编写常规网页测试。如果您使用网页测试框架，就不需要使用 Android 设备或 Java 虚拟机，这样可使测试运行更快且更可靠。话虽如此，但 Espresso-Web 允许您重复使用自定义 WebDriver Atom，这会给您带来很大的灵活性，尤其是在编写计划同时针对独立 Web 应用和包含 Android 界面的应用运行的测试时。
工作方式
与 Espresso 的 onData() 方法类似，WebView 互动结合使用 Java 编程语言和 JavaScript 桥接来完成其工作。由于没有机会通过提供 JavaScript 环境中的数据来引入竞态条件(Espresso 在基于 Java 的一端看到的一切都是孤立的副本)，因此完全支持从 Web.WebInteraction 对象返回数据，从而允许您验证从请求返回的所有数据。
什么是 WebDriver Atom？
WebDriver 框架使用 Atom 以编程方式查找和操纵网页元素。Atom 由 WebDriver 用来进行浏览器操纵。Atom 在概念上类似于 ViewAction，它是在界面中执行操作的独立单元。您可以使用 findElement() 和 getElement() 等已定义方法的列表来提供 Atom，以从用户的角度驱动浏览器。不过，如果您直接使用 WebDriver 框架，Atom 需要经过适当编排，这需要非常详细的逻辑。
在 Espresso 中，Web 和 Web.WebInteraction 类封装此样板，并且使得与 WebView 对象的互动给人一种 Espresso 般的感觉。因此，在 ViewMatchers 和 ViewActions。
于是，API 看起来非常简单：
Kotlin
onWebView()
.withElement(Atom)
.perform(Atom)
.check(WebAssertion)Java
onWebView()
.withElement(Atom)
.perform(Atom)
.check(WebAssertion);
实现 WebView
请按照以下部分中显示的指南，在应用的测试中使用WebView。
软件包
如需在项目中添加 Espresso-Web，请完成以下步骤：
打开应用的 build.gradle 文件。这通常不是顶级 build.gradle 文件，而是 app/build.gradle。
在依赖项内添加以下代码行：
androidTestImplementation 'androidx.test.espresso:espresso-web:3.1.0'
Espresso-Web 只与 Espresso 2.2 或更高版本以及测试库 0.3 或更高版本兼容，因此请务必也更新以下代码行：
androidTestImplementation 'androidx.test:runner:1.1.0'
androidTestImplementation 'androidx.test:rules:1.1.0'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.0'
常见 API 用法
通过 Espresso 在 Android 上使用 WebView 时，onWebView() 方法是主入口点。您可以使用此方法来执行 Espresso-Web 测试，例如：
Kotlin
onWebView()
.withElement(findElement(Locator.ID, "link_2")) // similar to onView(withId(...))
.perform(webClick()) // Similar to perform(click())
// Similar to check(matches(...))
.check(webMatches(getCurrentUrl(), containsString("navigation_2.html")))Java
onWebView()
.withElement(findElement(Locator.ID, "link_2")) // similar to onView(withId(...))
.perform(webClick()) // Similar to perform(click())
// Similar to check(matches(...))
.check(webMatches(getCurrentUrl(), containsString("navigation_2.html")));
在本例中，Espresso-Web 首先找到一个 ID 为 "link_2" 的 DOM 元素并点击该元素。然后，该工具验证 WebView 是否发送包含 "navigation_2.html" 字符串的 GET 请求。
JavaScript 支持
执行测试时，系统会使用 JavaScript 执行所有 WebView 交互。因此，为了支持 JavaScript 求值，被测 WebView 必须启用 JavaScript。
注意：启用 JavaScript 可能会导致重新加载被测 WebView。为了确保 AndroidJUnitRunner 加载需要的所有测试基础架构(包括 JavaScript 互动)，必须执行此操作。
@RunWith(AndroidJUnit4::class)
class MyTestSuite {
@get:Rule val activityScenarioRule =
activityScenarioRule()
@Test fun testWebViewInteraction() {
onWebView().forceJavascriptEnabled()
}
}
常见的网页互动
与 Web.WebInteraction 对象的常见互动包括：
示例：
Kotlin
onWebView().withElement(findElement(Locator.ID, "teacher"))Java
onWebView().withElement(findElement(Locator.ID, "teacher"));
withContextualElement() 相对于另一个 DOM 元素引用 WebView 中的一个限定范围的 DOM 元素。您应先调用withElement()以建立引用Web.WebInteraction对象(DOM 元素)。
示例：
Kotlin
.withElement(findElement(Locator.ID, "teacher"))
.withContextualElement(findElement(Locator.ID, "person_name"))Java
.withElement(findElement(Locator.ID, "teacher"))
.withContextualElement(findElement(Locator.ID, "person_name"));
check() 对条件进行评估，并确保它解析为 true。
示例：
Kotlin
onWebView()
.withElement(findElement(Locator.ID, "teacher"))
.withContextualElement(findElement(Locator.ID, "person_name"))
.check(webMatches(getText(), containsString("Socrates")))Java
onWebView()
.withElement(findElement(Locator.ID, "teacher"))
.withContextualElement(findElement(Locator.ID, "person_name"))
.check(webMatches(getText(), containsString("Socrates")));
perform()在 WebView 中执行操作，例如点击元素。
示例：
Kotlin
onWebView()
.withElement(findElement(Locator.ID, "teacher"))
.perform(webClick())Java
onWebView()
.withElement(findElement(Locator.ID, "teacher"))
.perform(webClick());
注意：虽然在针对多页工作流(如表单提交)提出断言时使用 reset() 很有用，但您的测试通常应在范围上加以限制而集中在单个页面上。
示例：
Kotlin
onWebView()
.withElement(...)
.perform(...)
.reset()Java
onWebView()
.withElement(...)
.perform(...)
.reset();
示例
以下示例测试在将文本输入 WebView 并选择 Submit 按钮后，同一文本是否会出现在同一 WebView 的不同元素中：
Kotlin
const val MACCHIATO = "Macchiato"
@RunWith(AndroidJUnit4::class)
class MyEspressoWebTestSuite {
@Test fun typeTextInInput_clickButton_SubmitsForm() {
// Create an intent that displays a web form.
val webFormIntent = Intent()
// ...
// Lazily launch the Activity with a custom start Intent per test.
ActivityScenario.launchActivity(webFormIntent)
// Selects the WebView in your layout. If you have multiple WebView
// objects, you can also use a matcher to select a given WebView,
// onWebView(withId(R.id.web_view)).
onWebView()
// Find the input element by ID.
.withElement(findElement(Locator.ID, "text_input"))
// Clear previous input and enter new text into the input element.
.perform(clearElement())
.perform(DriverAtoms.webKeys(MACCHIATO))
// Find the "Submit" button and simulate a click using JavaScript.
.withElement(findElement(Locator.ID, "submitBtn"))
.perform(webClick())
// Find the response element by ID, and verify that it contains the
// entered text.
.withElement(findElement(Locator.ID, "response"))
.check(webMatches(getText(), containsString(MACCHIATO)))
}
}Java
public static final String MACCHIATO = "Macchiato";
@Test
public void typeTextInInput_clickButton_SubmitsForm() {
// Create an intent that displays a web form.
Intent webFormIntent = new Intent();
// ...
// Lazily launch the Activity with a custom start Intent per test.
ActivityScenario.launchActivity(webFormIntent);
// Selects the WebView in your layout. If you have multiple WebView objects,
// you can also use a matcher to select a given WebView,
// onWebView(withId(R.id.web_view)).
onWebView()
// Find the input element by ID.
.withElement(findElement(Locator.ID, "text_input"))
// Clear previous input and enter new text into the input element.
.perform(clearElement())
.perform(DriverAtoms.webKeys(MACCHIATO))
// Find the "Submit" button and simulate a click using JavaScript.
.withElement(findElement(Locator.ID, "submitBtn"))
.perform(webClick())
// Find the response element by ID, and verify that it contains the
// entered text.
.withElement(findElement(Locator.ID, "response"))
.check(webMatches(getText(), containsString(MACCHIATO)));
}
其他资源
如需详细了解如何在 Android 测试中使用 Espresso-Web，请参阅以下资源。
示例
WebBasicSample：使用 Espresso-Web 与 WebView 对象互动。