diff --git a/src/__tests__/api/export.spec.ts b/src/__tests__/api/export.spec.ts new file mode 100644 index 0000000..f461e7d --- /dev/null +++ b/src/__tests__/api/export.spec.ts @@ -0,0 +1,65 @@ +import { describe, it, expect, vi, beforeEach } from 'vitest' + +vi.mock('@/utils/request', () => ({ + default: { + get: vi.fn(), + post: vi.fn(), + put: vi.fn(), + del: vi.fn(), + }, +})) + +import request from '@/utils/request' +import { exportRange, exportTask } from '@/api/export' + +const mockedRequest = vi.mocked(request) + +const sample = { + fileName: 'LPT-学习数据-20261009-1130.md', + contentType: 'text/markdown; charset=UTF-8', + content: '# 学习数据', +} + +describe('export API', () => { + beforeEach(() => { + vi.clearAllMocks() + }) + + it('exportTask 请求 GET /export/task/:taskNum 并带上 markdown 格式', async () => { + mockedRequest.get.mockResolvedValue({ code: 200, data: sample }) + const result = await exportTask('T001', 'markdown') + expect(mockedRequest.get).toHaveBeenCalledWith('/export/task/T001', { format: 'markdown' }) + expect(result).toEqual({ code: 200, data: sample }) + }) + + it('exportTask 支持 json 格式', async () => { + mockedRequest.get.mockResolvedValue({ code: 200, data: { ...sample, fileName: 'LPT-学习数据.json' } }) + await exportTask('T002', 'json') + expect(mockedRequest.get).toHaveBeenCalledWith('/export/task/T002', { format: 'json' }) + }) + + it('exportRange 带起止日期时把两个日期都拼进查询参数', async () => { + mockedRequest.get.mockResolvedValue({ code: 200, data: sample }) + await exportRange({ startDate: '2026-01-01', endDate: '2026-01-31', format: 'markdown' }) + expect(mockedRequest.get).toHaveBeenCalledWith('/export/range', { + format: 'markdown', + startDate: '2026-01-01', + endDate: '2026-01-31', + }) + }) + + it('exportRange 省略起止日期时只传格式(导出全部)', async () => { + mockedRequest.get.mockResolvedValue({ code: 200, data: sample }) + await exportRange({ format: 'json' }) + expect(mockedRequest.get).toHaveBeenCalledWith('/export/range', { format: 'json' }) + }) + + it('exportRange 只填一个日期时另一个不进入查询参数', async () => { + mockedRequest.get.mockResolvedValue({ code: 200, data: sample }) + await exportRange({ startDate: '2026-01-01', format: 'markdown' }) + expect(mockedRequest.get).toHaveBeenCalledWith('/export/range', { + format: 'markdown', + startDate: '2026-01-01', + }) + }) +}) diff --git a/src/__tests__/integration/review-detail-export-flow.spec.ts b/src/__tests__/integration/review-detail-export-flow.spec.ts new file mode 100644 index 0000000..e91fb15 --- /dev/null +++ b/src/__tests__/integration/review-detail-export-flow.spec.ts @@ -0,0 +1,113 @@ +import { describe, it, expect, vi, beforeEach } from 'vitest' +import { flushPromises, mount } from '@vue/test-utils' +import ElementPlus, { ElMessage } from 'element-plus' +import { createMemoryHistory, createRouter } from 'vue-router' +import ReviewDetail from '@/components/ReviewDetail.vue' +import { getReportDetail, getTaskReview } from '@/api/review' +import { getSessionDetail } from '@/api/studySessions' +import { exportTask } from '@/api/export' +import { downloadTextFile } from '@/utils/download' + +vi.mock('@/api/review', () => ({ + getFragmentDetail: vi.fn(), + getReportDetail: vi.fn(), + getTaskReview: vi.fn(), +})) + +vi.mock('@/api/studySessions', () => ({ + getSessionDetail: vi.fn(), +})) + +vi.mock('@/api/reportFragments', () => ({ + updateFragments: vi.fn(), +})) + +vi.mock('@/api/export', () => ({ + exportTask: vi.fn(), + exportRange: vi.fn(), +})) + +vi.mock('@/utils/download', () => ({ + downloadTextFile: vi.fn(), +})) + +const taskReviewItem = { + id: 1, + sessionNum: 'S001', + taskNum: 'T001', + taskName: '学习 Vue3 组合式 API', + sourceType: 'REPORT', + content: '# 学习报告', + createdTime: '2026-01-01 10:00:00', +} + +const exportResult = { + fileName: 'LPT-学习数据-20261009-1130.json', + contentType: 'application/json; charset=UTF-8', + content: '{"ok":true}', +} + +/** + * 交互式集成测试:真实挂载任务复习详情页, + * 覆盖「导出该任务」入口与格式选择的导出流程。 + */ +describe('ReviewDetail 任务导出流程(集成)', () => { + beforeEach(() => { + vi.clearAllMocks() + vi.mocked(getTaskReview).mockResolvedValue({ code: 200, data: [taskReviewItem] }) + vi.mocked(getReportDetail).mockResolvedValue({ + code: 200, + data: { content: '# 学习报告', sessionNum: 'S001' }, + }) + vi.mocked(getSessionDetail).mockResolvedValue({ + code: 200, + data: { + sessionNum: 'S001', + sessionState: 'ENDED', + taskNum: 'T001', + taskId: 1, + taskName: '学习 Vue3 组合式 API', + actualTime: 600, + effectiveTime: 500, + effectivenessRatio: 0.8, + }, + }) + vi.mocked(exportTask).mockResolvedValue({ code: 200, data: exportResult }) + }) + + const mountDetail = async () => { + const router = createRouter({ + history: createMemoryHistory(), + routes: [{ path: '/review/detail/task/:taskNum', component: ReviewDetail }], + }) + await router.push('/review/detail/task/T001') + await router.isReady() + + const wrapper = mount(ReviewDetail, { + global: { + plugins: [ElementPlus, router], + stubs: { ElTag: true }, + }, + }) + await flushPromises() + return wrapper + } + + it('点击「导出该任务」并选择 JSON 后调用导出接口并触发下载', async () => { + const wrapper = await mountDetail() + + const openButton = wrapper.findAll('button').find((b) => b.text().trim() === '导出该任务') + expect(openButton).toBeTruthy() + await openButton!.trigger('click') + await flushPromises() + + await wrapper.find('input.el-radio__original[value="json"]').setChecked() + await flushPromises() + await wrapper.find('.export-confirm-button').trigger('click') + await flushPromises() + + expect(exportTask).toHaveBeenCalledWith('T001', 'json') + expect(downloadTextFile).toHaveBeenCalledWith(exportResult) + expect(ElMessage.success).toHaveBeenCalledWith('导出完成,文件已开始下载') + }) +}) diff --git a/src/__tests__/integration/review-export-flow.spec.ts b/src/__tests__/integration/review-export-flow.spec.ts new file mode 100644 index 0000000..c1c2150 --- /dev/null +++ b/src/__tests__/integration/review-export-flow.spec.ts @@ -0,0 +1,160 @@ +import { describe, it, expect, vi, beforeEach } from 'vitest' +import { flushPromises, mount } from '@vue/test-utils' +import ElementPlus, { ElDatePicker, ElDialog, ElMessage } from 'element-plus' +import { createMemoryHistory, createRouter } from 'vue-router' +import Review from '@/components/Review.vue' +import { getReviewTaskStats } from '@/api/review' +import { exportRange } from '@/api/export' +import { downloadTextFile } from '@/utils/download' + +vi.mock('@/api/review', () => ({ + getReviewTaskStats: vi.fn(), + getReviewFeed: vi.fn(), + getTaskReview: vi.fn(), +})) + +vi.mock('@/api/export', () => ({ + exportTask: vi.fn(), + exportRange: vi.fn(), +})) + +vi.mock('@/utils/download', () => ({ + downloadTextFile: vi.fn(), +})) + +const tasks = [ + { + taskNum: 'T001', + taskName: '学习 Vue3 组合式 API', + reportCount: 3, + fragmentCount: 5, + effectiveTime: 9000, + reviewDurationSeconds: 1200, + }, +] + +const exportResult = { + fileName: 'LPT-学习数据-20261009-1130.md', + contentType: 'text/markdown; charset=UTF-8', + content: '# 学习数据', +} + +/** + * 交互式集成测试:真实挂载 Review 总览页,覆盖导出弹窗主流程 + * (打开弹窗 → 选格式 → 点导出 → 调用接口 → 触发下载)与未选时间段的拦截。 + */ +describe('Review 导出流程(集成)', () => { + beforeEach(() => { + vi.clearAllMocks() + vi.mocked(getReviewTaskStats).mockResolvedValue({ code: 200, data: tasks }) + vi.mocked(exportRange).mockResolvedValue({ code: 200, data: exportResult }) + }) + + const mountReview = async () => { + const router = createRouter({ + history: createMemoryHistory(), + routes: [ + { path: '/review', name: 'review', component: Review }, + { path: '/review/detail/task/:taskNum', component: { template: '
' } }, + { path: '/review/recall/:taskNum', component: { template: '' } }, + ], + }) + await router.push('/review') + await router.isReady() + + const wrapper = mount(Review, { + global: { + plugins: [ElementPlus, router], + // el-tag 在 jsdom + VTU 下 vnode mounted 钩子崩溃(EP 2.8 已知问题),纯视觉组件,stub 掉 + stubs: { ElTag: true }, + }, + }) + await flushPromises() + return { wrapper } + } + + const openExportDialog = async (wrapper: ReturnType