refactor: extend fixtures with checkoutPage and readyForCheckout

Author: kkamranvv

README.md

@@ -9,6 +9,14 @@ The project follows the **Page Object Model (POM)** pattern and covers core e-co
 - Page Object Model (POM)
 - Allure Report (planned)
 - GitHub Actions (CI/CD)
+- [Testomat.io](https://testomat.io/) — test management & living documentation
+
+## Test Documentation
+
+All manual and automated test cases are documented in Testomat.io.
+You can explore the full list of test cases and descriptions below 👇
+
+[View Test Cases in Testomat.io](https://www.saucedemo.com/)
 
 ## 📂 Project Structure
 
@@ -23,6 +31,7 @@ fixtures/ # Custom Playwright fixtures
 reports/ # Reports (Allure)
 
 ## 🚀 How to Run Tests
+
 ```bash
 # Install dependencies
 npm install
@@ -35,3 +44,4 @@ npx playwright test --headed
 
 # Run a specific test file
 npx playwright test tests/login.spec.ts
+```

fixtures/fixtures.ts

@@ -1,8 +1,19 @@
-import { test as base, expect } from "@playwright/test";
+import { Page, test as base, expect } from "@playwright/test";
 import { LoginPage } from "../pages/LoginPage";
 import { AddItem } from "../pages/AddItemToCart";
+import { Checkout } from "../pages/Checkout";
 
-export const test = base.extend<{ loginPage: LoginPage; cartReady: void }>({
+interface ReadyForCheckout {
+  page: Page;
+  checkoutPage: Checkout;
+}
+
+export const test = base.extend<{
+  loginPage: LoginPage;
+  cartReady: void;
+  checkoutPage: Checkout;
+  readyForCheckout: ReadyForCheckout;
+}>({
   loginPage: async ({ page }, use) => {
     const loginPage = new LoginPage(page);
     await loginPage.goto();
@@ -22,6 +33,25 @@ export const test = base.extend<{ loginPage: LoginPage; cartReady: void }>({
 
     await use();
   },
+
+  checkoutPage: async ({ page }, use) => {
+    const checkout = new Checkout(page);
+
+    await checkout.clickCheckout();
+
+    await expect(page).toHaveURL(
+      "https://www.saucedemo.com/checkout-step-one.html"
+    );
+
+    await use(checkout);
+  },
+
+  readyForCheckout: async (
+    { page, loginPage, cartReady, checkoutPage },
+    use
+  ) => {
+    await use({ page, checkoutPage });
+  },
 });
 
 export { expect };

tests/Checkout.spec.ts

@@ -1,38 +1,34 @@
+import { read } from "fs";
 import { test, expect } from "../fixtures/fixtures";
 
 import { AddItem } from "../pages/AddItemToCart";
 
 import { Checkout } from "../pages/Checkout";
 
 test.describe("Checkout", () => {
-  test("Successfull checkout", async ({ page, loginPage, cartReady }) => {
-    const checkout = new Checkout(page);
+  test("Successfull checkout", async ({ readyForCheckout }) => {
+    const { page, checkoutPage } = readyForCheckout;
 
-    await checkout.clickCheckout();
-    await checkout.completeInfo("Kamran", "Musadirli", "12345");
-    await checkout.clickContinue();
+    await checkoutPage.completeInfo("Kamran", "Musadirli", "12345");
+    await checkoutPage.clickContinue();
     await page.waitForTimeout(2000);
 
     await expect(page).toHaveURL(
       "https://www.saucedemo.com/checkout-step-two.html"
     );
 
-    await checkout.clickFinish();
+    await checkoutPage.clickFinish();
 
     await expect(page.locator(".complete-header")).toHaveText(
       "Thank you for your order!"
     );
   });
 
   test.describe("Checkout with invalid data", () => {
-    test("Checkout with no data", async ({ page, loginPage, cartReady }) => {
-      const checkout = new Checkout(page);
+    test("Checkout with no data", async ({ readyForCheckout }) => {
+      const { page, checkoutPage } = readyForCheckout;
 
-      await checkout.clickCheckout();
-
-      // without filling the data
-
-      await checkout.clickContinue();
+      await checkoutPage.clickContinue();
 
       await expect(
         page.locator(".error-message-container.error")
@@ -46,17 +42,13 @@ test.describe("Checkout", () => {
     });
 
     test("Checkout without Last Name And Zip Code", async ({
-      page,
-      loginPage,
-      cartReady,
+      readyForCheckout,
     }) => {
-      const checkout = new Checkout(page);
-
-      await checkout.clickCheckout();
+      const { page, checkoutPage } = readyForCheckout;
 
-      await checkout.completeInfo("Kamran");
+      await checkoutPage.completeInfo("Kamran");
 
-      await checkout.clickContinue();
+      await checkoutPage.clickContinue();
 
       await expect(
         page.locator(".error-message-container.error")
@@ -69,18 +61,12 @@ test.describe("Checkout", () => {
       await page.waitForTimeout(2000);
     });
 
-    test("Checkout without Zip Code", async ({
-      page,
-      loginPage,
-      cartReady,
-    }) => {
-      const checkout = new Checkout(page);
-
-      await checkout.clickCheckout();
+    test("Checkout without Zip Code", async ({ readyForCheckout }) => {
+      const { page, checkoutPage } = readyForCheckout;
 
-      await checkout.completeInfo("Kamran", "Musadirli");
+      await checkoutPage.completeInfo("Kamran", "Musadirli");
 
-      await checkout.clickContinue();
+      await checkoutPage.clickContinue();
 
       await expect(
         page.locator(".error-message-container.error")