Merge pull request #1 from patrickduong/myda_11May2025_add_new_test_features

patrickduong · web-flow · commit 8f512f233881 · 2025-05-11T21:33:45.000+07:00
upgrade chrome Driver 136
update selenium to 4.22.0
update webDriverManager 5.8.0
update readme file
Add 2 new test cases for shopping cart feature
Add default run for browser always firefox - for skip issue on chrome
diff --git a/.gitignore b/.gitignore
@@ -25,5 +25,7 @@ replay_pid*
 
 /shelf/
 /workspace.xml
+/build
+/target
 .gradle
 .idea
diff --git a/README.md b/README.md
@@ -1,7 +1,6 @@
-# saucedemo_Test
+# sauceDemo_Test
 
 ## Preface:
-
 + This project is a basic test framework for UI automation using cucumber, selenium and build tool gradle
 + You should be familiar with Java programming language (intermediate level)
 + Knowledge should know
@@ -13,6 +12,8 @@
 + Setup Java SDK version: 1.8+ or later (default build is version 15)
 + Plugins: See the build.gradle for dependencies installation
 + Selenium usage should be familiar with @findby: https://www.selenium.dev/selenium/docs/api/java/org/openqa/selenium/support/FindBy.html
++ First use framework please run gradle build test for download all required dependencies.
++ Recommendation for using intelliJ IDE for install Java and manage lib
 
 ## Test Execution Flow
 1. Start the browser-driver base on defined properties in gradle.properties via build.gradle run (run with gradle)
@@ -22,6 +23,19 @@
    + Default generating 3 types html, json and xml (for later use with other report plugins) - see at target/cucumber-reports
    + I include the plugin called spacialcircumstances.gradle-cucumber-reporting that will generate report at target/cucumber-html-report (base on the Cucumber_report.json above)
 
+## To use the framework
+1. Please install any items mentioned at Prerequisites
+2. For executing using cli - set the default approach 1 for using firefox only
+    - Open terminal type ```gradle clean test```
+    - Wait until the execution done then click on the link ```~/target/cucumber-html-reports/overview-features.html```
+    - It should display the report result
+3. For executing single feature file just select the feature file then run
+
+
 ## NOTE
 + Feel free to update and customise this template base your own knowledge
-+ This test project has promblem with check page title when running directly with gradle.build or via cli. Temporary commented a step in feature file.
++ This test project has problem with check page title when running directly with gradle.build or via cli. Temporary commented a step in feature file.
++ The web app has issue with Chrome browser that need to handle popup will need to handle later
++ Please upgrade chrome driver and firefox driver to latest as link below (choose the correct driver that support CPU type)
+  + https://googlechromelabs.github.io/chrome-for-testing/
+  + https://github.com/mozilla/geckodriver/releases
diff --git a/build.gradle b/build.gradle
@@ -12,10 +12,10 @@ java {
 ext {
     cucumberVersion = '7.11.2'
     junitbomVersion = '5.9.2'
-    seleniumJavaVersion = '4.1.2'
+    seleniumJavaVersion = '4.22.0'
     junitvintageengineVersion = '5.7.2'
     hamcrestVersion = '2.2'
-    webdrivermanagerVersion = '5.3.2'
+    webdrivermanagerVersion = '5.8.0'
 }
 
 repositories {
@@ -48,17 +48,17 @@ cucumberReports {
 //please use only 1 approach below and comment the unused
 
 //approach_1: set override the os and driver
-//tasks.withType(Test).configureEach {
-//    systemProperties = [
-//            defaultos           : System.getProperty('defaultos', 'mac'),
-//            defaultbrowserdriver: System.getProperty('defaultbrowserdriver', 'firefox')
-//    ]
-//}
+tasks.withType(Test).configureEach {
+    systemProperties = [
+            defaultos           : System.getProperty('defaultos', 'mac'),
+            defaultbrowserdriver: System.getProperty('defaultbrowserdriver', 'firefox')
+    ]
+}
 
 //approach_2: read from gradle.properties
-tasks.register('uiTest', Test) {
-    systemProperties project.properties.subMap(["defaultos", "defaultbrowserdriver"])
-}
+//tasks.register('uiTest', Test) {
+//    systemProperties project.properties.subMap(["defaultos", "defaultbrowserdriver"])
+//}
 
 //run with gradle cli: open terminal
 // gradle uiTest -Pdefaultos=mac -Pdefaultbrowserdriver=firefox
diff --git a/gradle.properties b/gradle.properties
@@ -2,4 +2,8 @@
 #set to all will show all the warning
 org.gradle.warning.mode=none
 systemProp.defaultos=mac
-systemProp.defaultbrowserdriver=chrome
+systemProp.defaultbrowserdriver=firefox
+# Gradle properties
+org.gradle.parallel=false
+org.gradle.caching=false
+org.gradle.jvmargs=-Duser.language=en -Duser.country=US -Dfile.encoding=UTF-8
diff --git a/settings.gradle b/settings.gradle
@@ -10,4 +10,3 @@
 rootProject.name = 'saucedemo'
 println System.getProperty("defaultos")
 println System.getProperty("defaultbrowserdriver")
-include 'app'
diff --git a/src/main/resources/macos/chromedriver b/src/main/resources/macos/chromedriver
diff --git a/src/main/resources/winos/chromedriver.exe b/src/main/resources/winos/chromedriver.exe
diff --git a/src/test/java/cucumber/ScenarioContextUI.java b/src/test/java/cucumber/ScenarioContextUI.java
@@ -30,9 +30,13 @@ public ScenarioReport getReport() {
 
 
     private WebDriver getFreshWebdriver() {
-        //temporary hardcoded with mac and chrome when running with feature file
-        DEFAULT_OS = System.getProperty("defaultos","mac");
-        DEFAULT_DRIVER = System.getProperty("defaultbrowserdriver","chrome");
+        //temporary hardcoded value running with feature file
+        System.setProperty("defaultos","mac");
+        System.setProperty("defaultbrowserdriver","firefox");
+
+        DEFAULT_OS = System.getProperty("defaultos");
+        DEFAULT_DRIVER = System.getProperty("defaultbrowserdriver");
+
         //cannot pass gradle properties via variables always return null
         System.out.println("********DEFAULT_OS: " +  System.getProperty("defaultos") + "***");
         System.out.println("********DEFAULT_DRIVER: " + System.getProperty("defaultbrowserdriver") + "***");
diff --git a/src/test/java/pages/CartPage.java b/src/test/java/pages/CartPage.java
@@ -0,0 +1,64 @@
+package pages;
+
+import org.openqa.selenium.By;
+import org.openqa.selenium.WebDriver;
+import org.openqa.selenium.WebElement;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class CartPage extends BasePage {
+
+    public CartPage(final WebDriver driver) {
+        super(driver);
+    }
+
+    private final By cartItemsLocator = By.cssSelector("div.cart_list div.cart_item");
+
+//    private final By continueShopButtonLocator = By.cssSelector("[data-test='continue-shopping']");
+//    private final By checkOutButtonLocator = By.cssSelector("[data-test='checkout']");
+
+    public static class CartItem {
+        public final String name;
+        public final String price;
+        public final int quantity;
+
+        public CartItem(String name, String price, int quantity) {
+            this.name = name;
+            this.price = price;
+            this.quantity = quantity;
+        }
+    }
+
+    public List<CartItem> getAllCartItems() {
+        List<CartItem> items = new ArrayList<>();
+        List<WebElement> elements = driver.findElements(cartItemsLocator);
+
+        for (WebElement el : elements) {
+            String qtyText = el.findElement(By.cssSelector("[data-test='item-quantity']")).getText().trim();
+            int quantity = Integer.parseInt(qtyText);
+            String name = el.findElement(By.cssSelector("[data-test='inventory-item-name']")).getText().trim();
+            String price = el.findElement(By.cssSelector("[data-test='inventory-item-price']")).getText().trim();
+
+            items.add(new CartItem(name, price, quantity));
+        }
+        return items;
+    }
+
+    public boolean isItemInCart(String expectedName, String expectedPrice, int expectedQuantity) {
+        return getAllCartItems().stream().anyMatch(item ->
+                item.name.equals(expectedName) &&
+                        item.price.equals(expectedPrice) &&
+                        item.quantity == expectedQuantity
+        );
+    }
+
+    public void verifyItemPresent(String expectedName, String expectedPrice, int expectedQuantity) {
+        if (!isItemInCart(expectedName, expectedPrice, expectedQuantity)) {
+            throw new AssertionError(
+                    String.format("Cart does not contain item [%s, %s, qty=%d]",
+                            expectedName, expectedPrice, expectedQuantity));
+        }
+    }
+
+}
diff --git a/src/test/java/pages/InventoryPage.java b/src/test/java/pages/InventoryPage.java
@@ -1,5 +1,6 @@
 package pages;
 
+import org.openqa.selenium.By;
 import org.openqa.selenium.WebDriver;
 import org.openqa.selenium.WebElement;
 import org.openqa.selenium.support.FindBy;
@@ -14,11 +15,53 @@ public class InventoryPage extends BasePage {
     @FindBy(className = "title")
     private WebElement inventoryTitle;
 
-    public InventoryPage(WebDriver driver) {
+    public void addProductToCart(String productName, String productPrice) {
+        // 1. Grab all product containers
+        List<WebElement> items = driver.findElements(By.cssSelector("div.inventory_item"));
+
+        for (WebElement item : items) {
+            // 2. Extract name and price from each container
+            String name = item.findElement(By.cssSelector("[data-test='inventory-item-name']")).getText().trim();
+            String price = item.findElement(By.cssSelector("[data-test='inventory-item-price']")).getText().trim();
+
+            // 3. If both match, locate the button
+            if (name.equals(productName) && price.equals(productPrice)) {
+                WebElement btn = item.findElement(By.cssSelector("button.btn_inventory"));
+                String btnText = btn.getText().trim();
+
+                // 4. Only click if it's an 'Add to cart' button
+                if (btnText.equalsIgnoreCase("Add to cart")) {
+                    btn.click();
+                } else {
+                    // already in cart / says "Remove" — do nothing
+                    System.out.printf("Product '%s' already in cart (button shows '%s'), skipping click.%n",
+                            productName, btnText);
+                }
+                return;  // done after handling the matched product
+            }
+        }
+
+        throw new RuntimeException(
+                String.format("Product not found: name='%s', price='%s'", productName, productPrice)
+        );
+    }
+
+    public int getCartBadgeCount() {
+        WebElement badge = driver.findElement(By.cssSelector("span[data-test='shopping-cart-badge']"));
+        String text = badge.getText().trim();
+        try {
+            return Integer.parseInt(text);
+        } catch (NumberFormatException e) {
+            throw new RuntimeException("Cart badge did not contain a number: '" + text + "'", e);
+        }
+    }
+
+
+    public InventoryPage(final WebDriver driver) {
         super(driver);
     }
 
-    public String getPageTitle(){
+    public String getPageTitle() {
         return inventoryTitle.getText();
     }
 
@@ -27,5 +70,4 @@ public int countTotalProductItem() {
     }
 
 
-
 }
diff --git a/src/test/java/pages/LoginPage.java b/src/test/java/pages/LoginPage.java
@@ -15,7 +15,7 @@ public class LoginPage extends BasePage {
     @FindBy(id = "login-button")
     private WebElement loginButton;
 
-    public LoginPage(WebDriver driver) {
+    public LoginPage(final WebDriver driver) {
         super(driver);
     }
 
diff --git a/src/test/java/pages/MenuPopUP.java b/src/test/java/pages/MenuPopUP.java
@@ -16,7 +16,7 @@ public class MenuPopUP extends BasePage {
     @FindBy(id = "logout_sidebar_link")
     private WebElement logoutLink;
 
-    public MenuPopUP(WebDriver driver) {
+    public MenuPopUP(final WebDriver driver) {
         super(driver);
     }
 
diff --git a/src/test/java/steps/SauceDemoSteps.java b/src/test/java/steps/SauceDemoSteps.java
@@ -1,41 +1,71 @@
 package steps;
 
 import constraints.TestConstraints;
+import io.cucumber.datatable.DataTable;
+import io.cucumber.java.en.And;
 import io.cucumber.java.en.Given;
 import io.cucumber.java.en.Then;
 import io.cucumber.java.en.When;
+import org.openqa.selenium.By;
 import org.openqa.selenium.support.PageFactory;
+import pages.CartPage;
 import pages.InventoryPage;
 import pages.LoginPage;
 import pages.MenuPopUP;
-import java.util.Objects;
+
+import java.util.List;
+import java.util.Map;
+
 import static cucumber.ScenarioHooks.driver;
 
 public class SauceDemoSteps {
     private final LoginPage sauceDemoLoginPage;
     private final InventoryPage sauceDemoInventoryPage;
-
     private final MenuPopUP menuPopUP;
+    private final CartPage sauceDemoCartPage;
 
     public SauceDemoSteps() {
 
         sauceDemoLoginPage = PageFactory.initElements(driver, LoginPage.class);
         sauceDemoInventoryPage = PageFactory.initElements(driver, InventoryPage.class);
         menuPopUP = PageFactory.initElements(driver, MenuPopUP.class);
+        sauceDemoCartPage = PageFactory.initElements(driver,CartPage.class);
     }
 
     @Given("^I login with \"([^\"]*)\"$")
     public void i_login_with(String userName) {
         sauceDemoLoginPage.login(userName, TestConstraints.DEFAULT_PASSWORD);
     }
 
-    @Then("^The page title display is \"([^\"]*)\"$")
-    public void verifyPageTitle(String pageTitle) {
-        assert Objects.equals(sauceDemoInventoryPage.getPageTitle(), pageTitle);
+    @When("I add the following products to the cart:")
+    public void i_add_the_following_products_to_the_cart(DataTable table) {
+        // Convert DataTable to List<Map<columnName, cellValue>>
+        List<Map<String, String>> rows = table.asMaps(String.class, String.class);
+
+        for (Map<String, String> row : rows) {
+            String name = row.get("name");
+            String price = row.get("price");
+            sauceDemoInventoryPage.addProductToCart(name, price);
+        }
+    }
+
+    @Then("the cart badge should show {int}")
+    public void the_cart_badge_should_show(Integer expectedCount) {
+        int badgeCount = sauceDemoInventoryPage.getCartBadgeCount();
+        if (!(badgeCount == expectedCount)) {
+            throw new AssertionError(
+                    String.format("Expected cart badge to show %d but was %d", expectedCount, badgeCount)
+            );
+        }
+    }
+
+    @And("the cart contains an item {string} priced {string} with quantity {int}")
+    public void cart_contains_expected_item(String name, String price, Integer qty) {
+        sauceDemoCartPage.verifyItemPresent(name, price, qty);
     }
 
     @Then("^The Product page display success with (\\d+)")
-    public void verifyTotalProductItem(int totalProductItem) {
+    public void the_default_product_item_should_show(int totalProductItem) {
         System.out.println("Expected productItem is [" + totalProductItem + "]");
         System.out.println("Actual productItem is [" + sauceDemoInventoryPage.countTotalProductItem() + "]");
         assert totalProductItem == sauceDemoInventoryPage.countTotalProductItem();
@@ -47,4 +77,8 @@ public void i_logout_the_web() {
         menuPopUP.logout();
     }
 
+    @When("I view the cart")
+    public void i_view_the_Cart() {
+        driver.findElement(By.cssSelector("span[data-test='shopping-cart-badge']")).click();
+    }
 }
diff --git a/src/test/resources/Features/saucedemo_cart.feature b/src/test/resources/Features/saucedemo_cart.feature
@@ -0,0 +1,31 @@
+@ui @sauceDemoCart
+Feature: UI - SauceDemoCart Test
+
+  Scenario Outline: User can add any product to shopping cart and the cart badge update correctly
+    Given I login with "<username>"
+    When I add the following products to the cart:
+      | name                  | price  |
+      | Sauce Labs Backpack   | $29.99 |
+      | Sauce Labs Bike Light | $9.99  |
+    Then the cart badge should show 2
+    When I logout the web
+
+    Examples:
+      | username     |
+      | problem_user |
+
+  Scenario Outline: User can view any products that exist in the cart page
+    Given I login with "<username>"
+    When I add the following products to the cart:
+      | name                  | price  |
+      | Sauce Labs Backpack   | $29.99 |
+      | Sauce Labs Bike Light | $9.99  |
+    When I view the cart
+    Then the cart badge should show 2
+    And the cart contains an item "Sauce Labs Backpack" priced "$29.99" with quantity 1
+    And the cart contains an item "Sauce Labs Bike Light" priced "$9.99" with quantity 1
+    When I logout the web
+
+    Examples:
+      | username                |
+      | performance_glitch_user |
diff --git a/src/test/resources/Features/saucedemo_login.feature b/src/test/resources/Features/saucedemo_login.feature

-Original file line number
+Diff line change
 /shelf/
 /workspace.xml
 +/build
 +/target
 .gradle
 .idea