# 测试框架API文档

## 核心模块

### TestConfig

配置管理模块，提供统一的配置接口。

#### 方法

- `getInstance()`: 获取单例实例
- `getEnvironment()`: 获取当前环境配置
- `setEnvironment(envName: string)`: 设置环境

#### 示例

```typescript
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)`: 结束测试

#### 示例

```typescript
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()`: 清理测试数据

#### 示例

```typescript
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)`: 提交表单

#### 示例

```typescript
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)`: 点击行

#### 示例

```typescript
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);
```