ui-automation / xfbhAutoTest · Files

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

/**
 * 基础页面类 - 所有页面对象的父类
 * 提供通用的页面操作方法
 */

export abstract class BasePage {
  readonly page: Page;

  constructor(page: Page) {
    this.page = page;
  }

  /** 
   截图并附加到Allure报告
  @param testName 测试名称
  @param screenshotName 截图名称
  */
  async attachScreenshot(testInfo:any,screenshotName:string):
  Promise<void>{
    const screenshot = await this.page.screenshot();
    await testInfo.attach(screenshotName,{
      body:screenshot,
      contentType:'image/png'
    });
  }

  /**
   * 导航到指定路径
   * @param path 相对路径
   */
  async navigate(path: string = '/'): Promise<void> {
    const baseURL = process.env.BASE_URL || 'https://erp-pad.test.gszdtop.com';
    await this.page.goto(`${baseURL}/#${path}`);
  }

  /**
   * 等待页面加载完成
   */
  async waitForPageLoad(): Promise<void> {
    await this.page.waitForLoadState('networkidle');
  }

  /**
   * 点击元素
   * @param selector 选择器或定位器
   */
  async click(selector: string | Locator): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await locator.click();
  }

  /**
   * 点击包含指定文本的元素
   * @param text 文本内容
   */
  async clickByText(text: string): Promise<void> {
    await this.page.getByText(text).click();
  }

  /**
   * 填写输入框
   * @param selector 选择器或定位器
   * @param value 填写的值
   */
  async fill(selector: string | Locator, value: string): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await locator.fill(value);
  }

  /**
   * 清空并填写输入框
   * @param selector 选择器或定位器
   * @param value 填写的值
   */
  async clearAndFill(selector: string | Locator, value: string): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await locator.clear();
    await locator.fill(value);
  }

  /**
   * 等待元素可见
   * @param selector 选择器或定位器
   * @param timeout 超时时间（毫秒）
   */
  async waitForVisible(selector: string | Locator, timeout: number = 30000): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await locator.waitFor({ state: 'visible', timeout });
  }

  /**
   * 等待元素附加到 DOM
   * @param selector 选择器或定位器
   * @param timeout 超时时间（毫秒）
   */
  async waitForAttached(selector: string | Locator, timeout: number = 30000): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await locator.waitFor({ state: 'attached', timeout });
  }

  /**
   * 等待元素隐藏
   * @param selector 选择器或定位器
   * @param timeout 超时时间（毫秒）
   */
  async waitForHidden(selector: string | Locator, timeout: number = 30000): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await locator.waitFor({ state: 'hidden', timeout });
  }

  /**
   * 断言元素可见
   * @param selector 选择器或定位器
   */
  async expectVisible(selector: string | Locator): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await expect(locator).toBeVisible();
  }

  /**
   * 断言元素包含指定文本
   * @param selector 选择器或定位器
   * @param text 期望的文本
   */
  async expectText(selector: string | Locator, text: string | RegExp): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await expect(locator).toContainText(text);
  }

  /**
   * 断言元素具有确切文本
   * @param selector 选择器或定位器
   * @param text 期望的确切文本
   */
  async expectExactText(selector: string | Locator, text: string | RegExp): Promise<void> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    await expect(locator).toHaveText(text);
  }

  /**
   * 选择下拉列表选项（通过文本匹配）
   * @param selector 选择器
   * @param optionText 选项文本
   */
  async selectOptionByText(selector: string, optionText: string): Promise<void> {
    await this.page.locator(selector).selectOption({ label: optionText });
  }

  /**
   * 获取元素文本内容
   * @param selector 选择器或定位器
   */
  async getText(selector: string | Locator): Promise<string | null> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    return locator.textContent();
  }

  /**
   * 获取输入框的值
   * @param selector 选择器或定位器
   */
  async getInputValue(selector: string | Locator): Promise<string> {
    const locator = typeof selector === 'string' ? this.page.locator(selector) : selector;
    return locator.inputValue();
  }

  /**
   * 截图
   * @param name 截图名称
   */
  async takeScreenshot(name: string): Promise<Buffer> {
    return this.page.screenshot({ path: `screenshots/${name}.png`, fullPage: true });
  }

  /**
   * 等待指定时间
   * @param ms 毫秒数
   */
  async wait(ms: number): Promise<void> {
    await this.page.waitForTimeout(ms);
  }

  /**
   * 获取页面 URL
   */
  getUrl(): string {
    return this.page.url();
  }

  /**
   * 刷新页面
   */
  async reload(): Promise<void> {
    await this.page.reload({ waitUntil: 'networkidle' });
  }

  /**
   * 等待导航完成
   * @param timeout 超时时间
   */
  async waitForNavigation(timeout: number = 30000): Promise<void> {
    await this.page.waitForLoadState('load', { timeout });
  }

  /**
   * 获取定位器
   * @param selector 选择器
   */
  getLocator(selector: string): Locator {
    return this.page.locator(selector);
  }

  /**
   * 过滤定位器
   * @param selector 选择器
   * @param options 过滤选项
   */
  filterLocator(selector: string, options: { hasText?: string | RegExp; has?: Locator }): Locator {
    return this.page.locator(selector).filter(options);
  }
}