Testing with Playwright

Avaa ChatGPT:ssä

Tämä dokumentaatio kuvaa prosessin webforJ-sovellusten testaamiseksi Playwrightilla, erityisesti keskittyen HelloWorldView:iin webforj-archetype-hello-world-projektista.

Sovelluksen perusasiat

Lisätietoja webforj-archetype-hello-world:ista löytyy Sovelluksen perusasiat -esittely -osiosta.

Edellytykset

Ennen Playwright-testien kirjoittamista ja suorittamista varmista seuraavat asiat:

• webforJ-sovellus on oikein asetettu ja käynnissä paikallisella palvelimellasi.
• Olet asentanut:
  • Playwright Java -siteet.
  • Yhteensopivan selaimen (Playwright voi automaattisesti asentaa selaimia asetusten aikana).
  • Maven-projektiriippuvuuksille.

Maven-konfiguraatio

Lisää tarvittavat riippuvuudet pom.xml:ään Playwrightia varten:

pom.xml

<dependencies>
  <dependency>
    <groupId>com.microsoft.playwright</groupId>
    <artifactId>playwright</artifactId>
    <version>1.49.0</version>
    <scope>test</scope>
  </dependency>
  <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <scope>test</scope>
  </dependency>
</dependencies>

Testiesimerkki: HelloWorldView

Seuraava koodi näyttää Playwright-pohjaisen testin HelloWorldView-komponentille.

HelloWorldViewTest.java

package com.example.views;

import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

import com.microsoft.playwright.Browser;
import com.microsoft.playwright.BrowserType;
import com.microsoft.playwright.Page;
import com.microsoft.playwright.Playwright;

class HelloWorldViewTest {

  static Playwright playwright = Playwright.create();
  Browser browser;
  Page page;
  String port = System.getProperty("server.port", "8080");

  @BeforeEach
  void setUp() {
    browser = playwright.chromium().launch();
    page = browser.newPage();
    page.navigate("http://localhost:" + port + "/");
  }

  @Test
  void shouldClickButton() {
    page.locator("input").fill("webforJ");
    page.getByText("Say Hello").click();

    assertThat(page.locator("dwc-toast").first())
        .containsText("Welcome to webforJ Starter webforJ!");
  }
}

Avainvaiheet

1. Alusta Playwright:

   • Luo Playwright-instanssi.
   • Käynnistä selaininstanssi playwright.chromium().launch()-metodilla.

2. Aseta testausympäristö:

   • Avaa uusi selainikkuna browser.newPage()-metodilla.
   • Siirry HelloWorldView-sivulle navigate-menetelmällä.

3. Vuorovaikuta elementtien kanssa:

   • Käytä Playwrightin lokalisaattoreita vuorovaikutukseen DOM-elementtien kanssa.
   • Täytä syöttökentät locator("input").fill()-metodilla ja laukaise toimintoja getByText("Say Hello").click()-menetelmällä.

4. Vaatimukset:

   • Vahvista näytetty toast-viesti PlaywrightAssertions.assertThat()-menetelmällä.

5. Puhdistus:

   • Playwright hoitaa selaimen puhdistuksen automaattisesti testin päättyessä. Manuaalista puhdistusta varten voit sulkea selaimen käyttämällä browser.close().

Testien suorittaminen

1. Käynnistä webforJ-palvelin:

   mvn jetty:run

2. Suorita testitapaukset:

   mvn test

Odotettu käyttäytyminen

• Vieraillessasi http://localhost:<port>/, HelloWorldView-sivu latautuu.
• Syötä webforJ tekstikenttään ja napsauta Say Hello-painiketta.
• Toast-viestin pitäisi ilmestyä tekstillä: Welcome to webforJ Starter webforJ!.