Esta página foi traduzida pela API Cloud Translation.

Espresso Web

Espresso-Web é um ponto de entrada para trabalhar com componentes de IU do Android WebView. O Espresso-Web reutiliza Atoms da conhecida API WebDriver (em inglês) para examinar e controlar o comportamento de um WebView.

Quando usar o Espresso-Web

Use o Espresso-Web para testar seus aplicativos híbridos, especialmente a integração dos seus os componentes da interface nativa do app com os WebView componentes de IU. É possível usar a API do Espresso-Web com outras APIs do Espresso para interagir completamente com elementos da Web em objetos WebView.

Se você precisar testar apenas o WebView, e não o interações entre WebView e componentes nativos no seu app, considere criar um teste geral da Web usando um framework como o WebDriver. Se você usa um framework de teste da Web, usar um dispositivo Android ou uma máquina virtual Java, o que facilita os testes para que sejam executados com mais rapidez e confiança. Com isso em mente, o Espresso-Web permite reutilizar seus átomos personalizados do WebDriver, o que proporciona muita flexibilidade, ao escrever testes que você planeja executar em aplicativos da Web autônomos e apps que incluem uma interface do Android.

Como funciona

Da mesma forma que o onData() do Espresso uma interação WebView compreende vários Atoms. As interações WebView usam uma combinação da linguagem de programação Java e uma JavaScript para fazer seu trabalho. Como não há chance de introduzir condições de corrida ao expor dados do ambiente JavaScript, O Espresso vê no lado baseado em Java uma cópia isolada que retorna dados do Web.WebInteraction é totalmente compatível, o que permite verificar todos os dados retornados de uma solicitação.

O que é um Atom do WebDriver?

O framework do WebDriver usa Atoms para localizar e manipular elementos da Web programaticamente. Os Atoms são usados pelo WebDriver para permitir a manipulação do navegador. Um Conceitualmente, o Atom é semelhante a um O ViewAction, uma plataforma que executa uma ação na interface. Você expõe Atoms usando uma lista de métodos definidos, como findElement() e getElement(), para direcionar o do navegador do ponto de vista do usuário. No entanto, se você usar o WebDriver diretamente o framework, os Atoms precisam ser devidamente orquestrados, exigindo lógica que é bem prolixo.

No Espresso, as classes Web e Web.WebInteraction unir esse código clichê e proporcionar uma experiência semelhante à do Expresso para interagir com a WebView. objetos. Portanto, no contexto de uma WebView, os Atoms são usados como Uma substituição para as ViewMatchers e ViewActions do Espresso.

A API é bastante simples:

Kotlin

onWebView()
    .withElement(Atom)
    .perform(Atom)
    .check(WebAssertion)

Java

onWebView()
    .withElement(Atom)
    .perform(Atom)
    .check(WebAssertion);

Para saber mais, leia a documentação do Selenium sobre Atoms (em inglês).

Implementar o WebView

Siga as orientações mostradas nas seções a seguir para trabalhar WebView nos testes do app.

Pacotes

Para incluir o Espresso-Web no projeto, siga estas etapas:

Abra o arquivo build.gradle do seu app. Geralmente, não é a no arquivo build.gradle de nível superior, app/build.gradle.

Adicione a seguinte linha nas dependências:

Groovy

    androidTestImplementation 'androidx.test.espresso:espresso-web:3.6.1'

Kotlin

    androidTestImplementation('androidx.test.espresso:espresso-web:3.6.1')

O Espresso-Web é compatível somente com o Espresso 2.2 ou posterior e para a versão 0.3 ou superior da biblioteca de teste. com as seguintes linhas:

Groovy

    androidTestImplementation 'androidx.test:runner:1.6.1'
    androidTestImplementation 'androidx.test:rules:1.6.1'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.6.1'

Kotlin

    androidTestImplementation('androidx.test:runner:1.6.1')
    androidTestImplementation('androidx.test:rules:1.6.1')
    androidTestImplementation('androidx.test.espresso:espresso-core:3.6.1')

Uso comum da API

O onWebView() é o principal ponto de entrada ao trabalhar com a WebView no Android usando Use esse método para realizar testes do Espresso-Web, como o seguintes:

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")));

Neste exemplo, o Espresso-Web localiza um elemento DOM com ID "link_2" e clicar nela. A ferramenta verifica se o WebView envia uma solicitação GET que contém a string "navigation_2.html".

Compatibilidade com JavaScript

Ao executar seus testes, o sistema realiza todas as interações do WebView usando JavaScript. Portanto, para oferecer suporte à avaliação do JavaScript, o WebView em teste o JavaScript precisa estar ativado.

É possível forçar a ativação do JavaScript chamando forceJavascriptEnabled() como uma ação em sua atividade em teste, conforme mostrado no snippet de código a seguir.

@RunWith(AndroidJUnit4::class)
class MyTestSuite {
    @get:Rule val activityScenarioRule =
        activityScenarioRule<MyWebViewActivity>()

    @Test fun testWebViewInteraction() {
        onWebView().forceJavascriptEnabled()
    }
}

Interações comuns na Web

As interações comuns com objetos Web.WebInteraction incluem o seguinte:

withElement() faz referência a um elemento DOM na WebView.

Exemplo:

Kotlin

onWebView().withElement(findElement(Locator.ID, "teacher"))

Java

onWebView().withElement(findElement(Locator.ID, "teacher"));

withContextualElement() faz referência a um elemento DOM com escopo na WebView, em relação a outro elemento DOM. Você deve chamar withElement() primeiro para estabelecer a referência Web.WebInteraction (elemento DOM).

Exemplo:
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() avalia uma condição para garantir que ela seja resolvida para true.

Exemplo:

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")));

O perform() executa uma ação dentro de um WebView, como clicando em um elemento.

Exemplo:

Kotlin

onWebView()
    .withElement(findElement(Locator.ID, "teacher"))
    .perform(webClick())

Java

onWebView()
    .withElement(findElement(Locator.ID, "teacher"))
    .perform(webClick());

reset() reverte o WebView ao estado inicial. Isso é necessário quando uma uma ação, como um clique, introduz uma mudança na navegação que facilita Objetos ElementReference e WindowReference inacessíveis.

Observação:embora o uso de reset() seja útil quando fazer declarações em relação a fluxos de trabalho de várias páginas, como envios de formulário, Em geral, os testes precisam ter escopo limitado e foco em uma única página.

Exemplo:
Kotlin
```
onWebView()
    .withElement(...)
    .perform(...)
    .reset()
```
Java
```
onWebView()
    .withElement(...)
    .perform(...)
    .reset();
```

Exemplo

O exemplo a seguir testa se, depois de inserir texto em um WebView, selecionando um botão Enviar, o mesmo texto aparecerá em um elemento diferente no a mesma 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)));
}

Outros recursos

Para mais informações sobre o uso do Espresso-Web em testes do Android, consulte a recursos a seguir.

Amostras

WebBasicSample (em inglês): Usar o Espresso-Web para interagir com objetos WebView.

Espresso Web Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Quando usar o Espresso-Web

Como funciona

O que é um Atom do WebDriver?

Kotlin

Java

Implementar o WebView

Pacotes

Groovy

Kotlin

Groovy

Kotlin

Uso comum da API

Kotlin

Java

Compatibilidade com JavaScript

Interações comuns na Web

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Exemplo

Kotlin

Java

Outros recursos

Amostras

Espresso Web