Sample Page Objects code

README.md

@@ -1,6 +1,6 @@
 # Serenity JUnit Starter project
 
-Get started quickly with Serenity BDD and JUnit 5 with this simple starter project. 
+Get started quickly with Serenity BDD and JUnit 5 using Page Objects and Action Classes with this simple starter project. 
 
 ## Get the code
 

src/test/java/starter/acceptancetests/WhenSearchingForTerms.java

@@ -1,39 +1,42 @@
 package starter.acceptancetests;
 
+import net.serenitybdd.annotations.Steps;
 import net.serenitybdd.junit5.SerenityJUnit5Extension;
-import net.serenitybdd.screenplay.Actor;
-import net.serenitybdd.screenplay.annotations.CastMember;
-import net.serenitybdd.screenplay.ensure.Ensure;
-import net.serenitybdd.screenplay.questions.page.TheWebPage;
 import org.junit.jupiter.api.DisplayName;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.extension.ExtendWith;
-import starter.actions.navigation.NavigateTo;
-import starter.actions.search.LookForInformation;
+import starter.actions.NavigateSteps;
+import starter.actions.SearchSteps;
+
+import static org.assertj.core.api.Assertions.assertThat;
 
 @ExtendWith(SerenityJUnit5Extension.class)
 class WhenSearchingForTerms {
 
-    @CastMember
-    Actor actor;
+    @Steps
+    NavigateSteps navigate;
+
+    @Steps
+    SearchSteps search;
 
     @Test
     @DisplayName("Should be able to search for red things")
     void searchForRedThings() {
-        actor.attemptsTo(
-                NavigateTo.theSearchHomePage(),
-                LookForInformation.about("red"),
-                Ensure.that(TheWebPage.title()).containsIgnoringCase("red")
-        );
+        navigate.opensTheHomePage();
+
+        search.searchForTerm("red");
+
+        assertThat(search.getSearchResults()).anyMatch(title -> title.toLowerCase().contains("red"));
     }
 
     @Test
-    @DisplayName("Should be able to search for green things")
+    @DisplayName("Result page title should mention the search term")
     void searchForGreenThings() {
-        actor.attemptsTo(
-                NavigateTo.theSearchHomePage(),
-                LookForInformation.about("green"),
-                Ensure.that(TheWebPage.title()).containsIgnoringCase("green")
-        );
+        navigate.opensTheHomePage();
+
+        search.searchForTerm("green");
+
+        assertThat(search.getTitle()).containsIgnoringCase("green");
     }
+
 }

src/test/java/starter/actions/NavigateSteps.java

@@ -0,0 +1,15 @@
+package starter.actions;
+
+import net.serenitybdd.annotations.Step;
+import net.serenitybdd.core.steps.UIInteractionSteps;
+import starter.pageobjects.SearchForm;
+
+public class NavigateSteps extends UIInteractionSteps {
+
+    SearchForm searchForm;
+
+    @Step("User opens the DuckDuckGo home page")
+    public void opensTheHomePage() {
+        searchForm.open();
+    }
+}

src/test/java/starter/actions/SearchSteps.java

@@ -0,0 +1,25 @@
+package starter.actions;
+
+import net.serenitybdd.annotations.Step;
+import net.serenitybdd.annotations.Steps;
+import net.serenitybdd.core.steps.UIInteractionSteps;
+import org.openqa.selenium.Keys;
+import starter.pageobjects.SearchForm;
+
+import java.util.List;
+
+public class SearchSteps extends UIInteractionSteps {
+
+    SearchForm searchForm;
+
+    @Step("User searches for '{0}'")
+    public void searchForTerm(String searchTerm) {
+        find(SearchForm.SEARCH_FIELD).sendKeys(searchTerm);
+        find(SearchForm.SEARCH_BUTTON).click();
+    }
+
+    @Step("Check the search results")
+    public List<String> getSearchResults() {
+        return findAll(SearchForm.ARTICLE_HEADINGS).texts();
+    }
+}

src/test/java/starter/pageobjects/SearchForm.java

@@ -0,0 +1,12 @@
+package starter.pageobjects;
+
+import net.serenitybdd.annotations.DefaultUrl;
+import net.serenitybdd.core.pages.PageObject;
+import org.openqa.selenium.By;
+
+@DefaultUrl("https://duckduckgo.com/")
+public class SearchForm extends PageObject {
+    public static final By SEARCH_FIELD = By.name("q");
+    public static final By SEARCH_BUTTON = By.cssSelector("[aria-label='Search']");
+    public static final By ARTICLE_HEADINGS =  By.cssSelector("[data-testid=result] h2");
+}