Testing Guide

         ┌─────────┐
         │  E2E    │  少量关键路径 (Playwright)
        ┌┴─────────┴┐
        │ 集成测试   │  API + Store 联动 (Vitest)
       ┌┴───────────┴┐
       │  单元测试    │  hooks/utils/transforms (Vitest)
       └─────────────┘

packages/core/__tests__/
├── setup.ts                    # 全局 setup（localStorage mock 等）
├── utils/
│   └── performance.test.ts     # 工具函数测试
├── services/
│   └── api/
│       └── orders.test.ts      # API 服务测试
└── i18n/
    └── i18n.test.ts            # i18n 测试

import { describe, it, expect, vi, beforeEach } from 'vitest';
import { renderHook, act } from '@testing-library/react';

describe('useOrderDetail', () => {
  beforeEach(() => {
    vi.clearAllMocks();
  });

  it('应返回订单详情数据', async () => {
    const { result } = renderHook(() => useOrderDetail('order-123'));

    await waitFor(() => {
      expect(result.current.displayOrder).toBeDefined();
      expect(result.current.isLoading).toBe(false);
    });
  });

  it('应正确处理错误状态', async () => {
    vi.mocked(ordersApi.getOrder).mockRejectedValue(new Error('网络错误'));

    const { result } = renderHook(() => useOrderDetail('invalid'));

    await waitFor(() => {
      expect(result.current.error).toBeTruthy();
    });
  });
});

describe('transformCoreOrder', () => {
  it('应将买家角色正确映射', () => {
    const result = transformCoreOrder({
      coreOrder: mockOrder,
      currentUserPeerID: 'buyer-peer-id',
    });

    expect(result.userRole).toBe('buyer');
    expect(result.canDispute).toBe(true);
  });
});

import { act } from '@testing-library/react';

describe('useCartStore', () => {
  beforeEach(() => {
    // 重置 store
    useCartStore.setState({ items: [], error: null });
  });

  it('应正确添加商品', () => {
    act(() => {
      useCartStore.getState().addItem(mockItem);
    });

    expect(useCartStore.getState().items).toHaveLength(1);
    expect(useCartStore.getState().getItemCount()).toBe(1);
  });
});

import { skipIfNoIntegration } from '../setup';

describe('Orders Integration', () => {
  skipIfNoIntegration();

  it('应完成完整的购买流程', async () => {
    // 创建订单
    const order = await ordersApi.createOrder(mockPurchase);
    expect(order.id).toBeDefined();

    // 确认订单
    await ordersApi.confirmOrder(order.id);
    // ...
  });
});

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

test.describe('首页', () => {
  test('应正确显示导航栏', async ({ page }) => {
    await page.goto('/');

    await expect(page.getByRole('navigation')).toBeVisible();
    await expect(page.getByTestId('search-input')).toBeVisible();
  });

  test('响应式：移动端应显示汉堡菜单', async ({ page }) => {
    await page.setViewportSize({ width: 375, height: 667 });
    await page.goto('/');

    await expect(page.getByTestId('mobile-menu-button')).toBeVisible();
  });
});

import { loginAndSetup } from './fixtures/auth';
import { mockOrdersAPI, mockNotificationsAPI } from './fixtures/mock-api-routes';

test.describe('Authenticated Pages', () => {
  test.beforeAll(async ({ browser }) => {
    const page = await browser.newPage();
    await loginAndSetup(page);
    // 保存认证状态...
  });

  test('orders page', async ({ page }) => {
    await mockOrdersAPI(page); // 拦截 API 返回 mock 数据
    await page.goto('/orders/purchases');
    await expect(page).toHaveScreenshot('orders-purchases.png');
  });
});

# 桌面端
pnpm --filter @mobazha/web exec playwright test desktop-visual --project=chromium

# 移动端
pnpm --filter @mobazha/web exec playwright test mobile-visual --project="Mobile Chrome"

# 更新快照
pnpm --filter @mobazha/web exec playwright test desktop-visual --update-snapshots

# 单元测试
pnpm --filter @mobazha/core test

# 带覆盖率
pnpm --filter @mobazha/core test -- --coverage

# E2E 测试
pnpm --filter @mobazha/web test:e2e

# 单个文件
pnpm --filter @mobazha/core test -- orderTransform.test.ts