Lesson 10 - Basket Cases

For this lesson we are going to try to add a Feature where a customer adds an item to their basket:

Feature: Customers can buy artwork

  Scenario: Betty chooses "Unusable Security"
    Given Betty adds "Unusable Security" at $2 to her basket
    When she checks her basket
    Then she can see her basket contains only 1 item of "Unusable Security"

This involves clicking the Add button on an item, then going to Checkout:

and confirming that the number of items and subtotal are correct:

Our Step Definitions will mostly rely on a new Shop helper class:

public class ShopStepDefinitions {
    @Given("{actor} adds {string} at ${int} to her basket")
    public void bettyAddsToHerBasket(Actor actor, String itemName, int itemPrice) {
        actor.wasAbleTo(Open.browserOn().the(LandingPage.class));
        actor.attemptsTo(Shop.addItemToBasket(itemName, itemPrice));
    }

    @When("{actor} checks her basket")
    public void sheChecksHerBasket(Actor actor) {
        actor.attemptsTo(Shop.openBasket());
    }

    @Then("{actor} can see her basket contains only {int} item of {string}")
    public void sheCanSeeHerBasketContainsOnly(Actor actor, int itemCount, String itemName) {
        actor.attemptsTo(Shop.checkBasketContainsOnly(itemCount, itemName));
    }
}

public class Shop {

    public static Performable addItemToBasket(String itemName, itemPrice) {
        return Task.where("adds " + itemName + " to basket",
                actor -> {
                    actor.remember("item price", itemPrice);
                    actor.attemptsTo(Click.on(ShopPage.ADD_ITEM.of(itemName)));
                }
        );
    }

    public static Performable openBasket() {
        return Task.where("opens basket",
                actor -> {
                    actor.attemptsTo(Click.on(ShopPage.CHECKOUT));
                    actor.remember("basket contents", Text.of(CheckoutPage.BASKET_ITEMS));
                    actor.remember("basket subtotal", Text.of(CheckoutPage.SUB_TOTAL));
                }
        );
    }

    public static Question<Boolean> basketIsCorrect(int itemCount, String itemName) {
        return Question.about("basket contents").answeredBy(
                actor -> {
                    int itemPrice = actor.recall("item price");
                    String basketContent = actor.recall("basket contents");
                    String subTotal = actor.recall("basket subtotal");
                    return basketContent.equals(itemName + "\nQuantity " + itemCount + "remove\n" + itemPrice)
                            && subTotal.equals("$" + itemPrice + ".00");
                }
        );
    }

    public static Performable checkBasketContainsOnly(int itemCount, String itemName) {
        return Ensure.that("basket has " + itemCount + " of " + itemName,
                basketIsCorrect(itemCount, itemName))
                .isTrue();
    }

}

The first Task definition is just a simple click on the ADD_ITEM button but it has also stored the item price.

The openBasket() method also stores the text content of the basket and the subtotal.

Finally the method to check the basket uses a compound Question object to check both the basket contents and subtotal.

We had to implement 2 PageObjects for the Shop and Checkout components:

public class ShopPage extends PageObject {

    public static Target ADD_ITEM = Target.the("Add Item to Basket")
            .locatedBy("//*[.='{0}']//..//button");

    public static Target CHECKOUT = Target.the("Checkout button")
            .locatedBy("//*[text()='Checkout']");

}

public class CheckoutPage extends PageObject {

    public static Target BASKET_ITEMS = Target.the("Item in basket")
            .locatedBy("//*[@class='productItem']");

    public static Target SUB_TOTAL = Target.the("basket subtotal")
            .locatedBy("//*[.='subtotal']//following-sibling::*");

}