Testing with Selenium

Openen in ChatGPT

Deze documentatie beschrijft het proces voor het testen van een webforJ-apps met Selenium, met specifieke focus op de HelloWorldView van de webforj-archetype-hello-world.

Basisprincipes van de app

Om meer te leren over de webforj-archetype-hello-world, raadpleeg de sectie Inleiding tot de basisprincipes van de app.

Vereisten

Voordat je de Selenium-tests uitvoert, zorg ervoor dat aan het volgende is voldaan:

• de webforJ-app correct is ingesteld en draait op je lokale server.
• Je hebt geïnstalleerd:
  • Selenium Java bindings.
  • Een compatibele WebDriver voor je browser.
  • Maven voor projectafhankelijkheden.

Maven-configuratie

Voeg de benodigde afhankelijkheden toe in je pom.xml voor Selenium en andere testbibliotheken:

pom.xml

<dependencies>
  <dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.27.0</version>
  </dependency>
  <dependency>
    <groupId>io.github.bonigarcia</groupId>
    <artifactId>webdrivermanager</artifactId>
    <version>5.9.2</version>
  </dependency>
  <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <scope>test</scope>
  </dependency>
</dependencies>

Testvoorbeeld: HelloWorldView

De volgende code demonstreert een Selenium-gebaseerde test voor de HelloWorldView-component.

HelloWorldViewTest.java

package com.example.views;

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

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.WebDriverWait;

import static java.time.Duration.ofSeconds;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.openqa.selenium.support.ui.ExpectedConditions.titleIs;
import io.github.bonigarcia.wdm.WebDriverManager;

class HelloWorldViewTest {

  private WebDriver driver;
  private static final String PORT = System.getProperty("server.port", "8080");

  @BeforeAll
  static void setupAll() {
    WebDriverManager.chromedriver().setup();
  }

  @BeforeEach
  void setup() {
    driver = new ChromeDriver();
    driver.get("http://localhost:" + PORT + "/");
    new WebDriverWait(driver, ofSeconds(30))
            .until(titleIs("webforJ Hello World"));
  }

  @AfterEach
  void teardown() {
    if (driver != null) {
        driver.quit();
    }
  }

  @Test
  void shouldClickButton() {
    WebElement button = driver.findElement(By.tagName("dwc-button"));
    assertEquals("Say Hello", button.getText(), "Buttontekst mismatch!");
  }
}

Belangrijke stappen

1. Initialiseer WebDriver:

   • Gebruik WebDriverManager om automatisch de driver-executable voor de browser te beheren.

2. Stel de testomgeving in:

   • Start de testserver op http://localhost:<port>/.
   • Wacht totdat de paginatitel overeenkomt met de verwachte webforJ Hello World.

3. Interactie met elementen:

   • Lokaliseer elementen met behulp van By.tagName, By.id, of andere Selenium-locators.
   • Verifieer verwachte gedragingen zoals knopklikken of tekstwijzigingen.

info

Omdat webforJ een single-page webapplicatie produceert, is Selenium zich niet bewust van DOM-manipulatie nadat de initiële pagina is geladen. Je kunt de WebDriverWait API van Selenium gebruiken om te wachten tot de DOM is samengesteld.

4. Opruimen:
   • Sluit de WebDriver-sessie af om middelen vrij te geven.

Tests uitvoeren

1. Start de webforJ-server:

   mvn jetty:run

2. Voer de testgevallen uit:

   mvn test

Verwacht gedrag

• Bij het bezoeken van http://localhost:<port>/, wordt de HelloWorldView-pagina geladen.
• Het dwc-button-element met de tekst Say Hello zou aanwezig moeten zijn.