张翔
2.6 KiB
2.6 KiB
测试框架API文档
核心模块
TestConfig
配置管理模块，提供统一的配置接口。
方法
getInstance(): 获取单例实例getEnvironment(): 获取当前环境配置setEnvironment(envName: string): 设置环境
示例
import { testConfig } from './core/test-config';
const env = testConfig.getEnvironment();
console.log(env.baseURL);
TestLogger
日志记录模块，提供统一的日志接口。
方法
debug(message: string): 记录调试信息info(message: string): 记录一般信息warn(message: string): 记录警告信息error(message: string, error?: Error): 记录错误信息startTest(testName: string): 开始测试endTest(testName: string, status: string): 结束测试
示例
import { testLogger } from './core/test-logger';
testLogger.startTest('示例测试');
testLogger.info('测试步骤1');
testLogger.endTest('示例测试', 'passed');
TestDataManager
数据管理模块，提供测试数据管理接口。
方法
createTestUser(userData: Partial<TestUser>): 创建测试用户createTestRole(roleData: Partial<TestRole>): 创建测试角色getTestData(key: string): 获取测试数据cleanup(): 清理测试数据
示例
import { testDataManager } from './core/test-data-manager';
const user = await testDataManager.createTestUser({
realName: '测试用户',
email: 'test@example.com'
});
await testDataManager.cleanup();
辅助工具
FormHelper
表单操作辅助工具。
方法
fillField(selector: string, value: string): 填充字段fillForm(fields: Record<string, { value: string }>): 填充表单selectOption(selector: string, value: string): 选择选项submitForm(selector?: string): 提交表单
示例
import { FormHelper } from './helpers/form-helper';
const formHelper = new FormHelper(page);
await formHelper.fillField('input[name="username"]', 'testuser');
await formHelper.submitForm();
TableHelper
表格操作辅助工具。
方法
getRowCount(tableSelector: string): 获取行数getCellText(tableSelector: string, row: number, col: number): 获取单元格文本findRowsByCellText(tableSelector: string, searchText: string): 查找行clickRow(tableSelector: string, row: number): 点击行
示例
import { TableHelper } from './helpers/table-helper';
const tableHelper = new TableHelper(page);
const rowCount = await tableHelper.getRowCount('.user-table');
const cellText = await tableHelper.getCellText('.user-table', 1, 2);