proffesor-for-testing__agentic-qe/tests/e2e/pages/HomePage.ts

import { Page, Locator, expect } from '@playwright/test';
import { BasePage } from './BasePage';

/**
 * Home Page Object Model
 * Handles interactions with the Sauce Demo homepage
 *
 * Generated by: qe-queen-coordinator
 */
export class HomePage extends BasePage {
  // Hero section
  readonly heroSection: Locator;
  readonly heroTitle: Locator;
  readonly heroSubtitle: Locator;

  // Featured products
  readonly featuredProducts: Locator;
  readonly productCards: Locator;
  readonly productTitles: Locator;
  readonly productPrices: Locator;
  readonly productImages: Locator;

  // Navigation links
  readonly catalogLink: Locator;
  readonly aboutUsLink: Locator;
  readonly blogLink: Locator;

  // Social links
  readonly socialLinks: Locator;
  readonly facebookLink: Locator;
  readonly twitterLink: Locator;
  readonly instagramLink: Locator;

  constructor(page: Page) {
    super(page);

    // Hero section selectors
    this.heroSection = page.locator('.hero, .banner, [data-hero]');
    this.heroTitle = page.locator('.hero h1, .banner-title, [data-hero-title]');
    this.heroSubtitle = page.locator('.hero p, .banner-subtitle');

    // Product grid selectors - Shopify theme specific
    this.featuredProducts = page.locator('.featured-products, .product-grid, [data-products]');
    this.productCards = page.locator('.product-card, .grid-item, .product-item');
    this.productTitles = page.locator('.product-card h3, .product-title, .product-card__title');
    this.productPrices = page.locator('.product-price, .price, [data-price]');
    this.productImages = page.locator('.product-card img, .product-image');

    // Navigation
    this.catalogLink = page.locator('[href="/collections/all"], a:text("Catalog")');
    this.aboutUsLink = page.locator('[href*="about"], a:text("About")');
    this.blogLink = page.locator('[href*="/blogs"], a:text("Blog")');

    // Social links
    this.socialLinks = page.locator('.social-links, .footer-social');
    this.facebookLink = page.locator('[href*="facebook"]');
    this.twitterLink = page.locator('[href*="twitter"]');
    this.instagramLink = page.locator('[href*="instagram"]');
  }

  /**
   * Navigate to homepage
   */
  async navigate() {
    await this.goto('/');
    await this.waitForPageLoad();
  }

  /**
   * Get all featured product names
   */
  async getFeaturedProductNames(): Promise<string[]> {
    const titles = await this.productTitles.allTextContents();
    return titles.map(t => t.trim());
  }

  /**
   * Get featured product count
   */
  async getFeaturedProductCount(): Promise<number> {
    return await this.productCards.count();
  }

  /**
   * Click on a product by name
   */
  async clickProduct(productName: string) {
    const product = this.page.locator(`.product-card:has-text("${productName}"), .product-item:has-text("${productName}")`);
    await product.click();
    await this.page.waitForURL('**/products/**');
  }

  /**
   * Click on first product
   */
  async clickFirstProduct() {
    await this.productCards.first().click();
    await this.page.waitForURL('**/products/**');
  }

  /**
   * Navigate to catalog page
   */
  async goToCatalog() {
    await this.catalogLink.click();
    await this.page.waitForURL('**/collections/**');
  }

  /**
   * Verify homepage loaded correctly
   */
  async verifyHomepageLoaded() {
    await expect(this.page).toHaveTitle(/Sauce Demo/i);
    await expect(this.featuredProducts.or(this.productCards.first())).toBeVisible();
  }

  /**
   * Get product price by name
   */
  async getProductPrice(productName: string): Promise<string> {
    const productCard = this.page.locator(`.product-card:has-text("${productName}"), .product-item:has-text("${productName}")`);
    const price = await productCard.locator('.price, .product-price, [data-price]').textContent();
    return price?.trim() || '';
  }

  /**
   * Check if social links are present
   */
  async verifySocialLinks() {
    await expect(this.facebookLink).toBeVisible();
    await expect(this.twitterLink).toBeVisible();
    await expect(this.instagramLink).toBeVisible();
  }
}