/** * 「获取店铺数据」一键采集 + 任务面板挂载用例(v1.5 改版后)。 * * 页面改版(2026-11-15):左侧只留「一键获取店铺数据」按钮,右侧换共享任务面板 * (TaskCenterPanel + useLiveTaskBoard,与外观专利同一骨架);单任务进度条移除, * 进度在任务卡片上。四组靶子保留,缺一条就是假绿: * ① 点一次按钮就走完整链路:建单 → 激活 → 把 `jd-shop-collect-run` 推进本机客户端队列 → 轮询批量进度; * ② 有 total 时卡片进度条按已落库商品数算出真实百分比(分母只来自服务端游标,不编造); * ③ total 缺失时只显示「已采集 N 个商品」,不编造百分比; * ④ 终态即收手:SUCCESS/FAILED 从轮询移除,FAILED 显示服务端原因并出「重试」按钮 * (重试走通用原位复位 + 重新激活推队列——断点续传,不新建任务)。 * * 跑法:`npx vitest run tests/mount/jd-collect-progress.mount.test.ts` */ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest' import { flushPromises, mount, type VueWrapper } from '@vue/test-utils' import ElementPlus, { ElOption, ElSelect } from 'element-plus' import JdCollectTab from '@/pages/jd/JdCollectTab.vue' const api = vi.hoisted(() => ({ createJdCollectTask: vi.fn(), // 8d8c88a5 起建单后先 PENDING→RUNNING 再推队列;mock 里缺这一个键会让组件拿到 // undefined 调用、enqueue 永远不被调用(本文件当时没跟上,红在这里)。 activateJdCollectTask: vi.fn(), fetchJdCollectCategories: vi.fn(), fetchJdCollectGroups: vi.fn(), fetchJdCollectDashboard: vi.fn(), fetchJdCollectHistory: vi.fn(), fetchJdCollectTaskProgressBatch: vi.fn(), deleteJdCollectTask: vi.fn(), interruptJdCollectTask: vi.fn(), retryClientTask: vi.fn(), enqueue: vi.fn(), // 2026-11-19「同步分类」:选项集正本从冻结快照改为桥实时拉取(每家店的店内分类不同)。 syncCategories: vi.fn(), })) vi.mock('@/shared/api/types/modules/jd-collect', () => ({ createJdCollectTask: api.createJdCollectTask, activateJdCollectTask: api.activateJdCollectTask, fetchJdCollectCategories: api.fetchJdCollectCategories, fetchJdCollectGroups: api.fetchJdCollectGroups, fetchJdCollectProgress: vi.fn(), fetchJdCollectDashboard: api.fetchJdCollectDashboard, fetchJdCollectHistory: api.fetchJdCollectHistory, fetchJdCollectTaskProgressBatch: api.fetchJdCollectTaskProgressBatch, deleteJdCollectTask: api.deleteJdCollectTask, interruptJdCollectTask: api.interruptJdCollectTask, })) vi.mock('@/shared/api/task-retry', () => ({ retryClientTask: api.retryClientTask, })) vi.mock('@/shared/bridges/pywebview', () => ({ getPywebviewApi: () => ({ enqueue_json: api.enqueue, get_jd_shop_categories: api.syncCategories }), })) const EMPTY_DASHBOARD = { pendingTaskCount: 0, processedTaskCount: 0, successTaskCount: 0, failedTaskCount: 0, } function historyItem(over: Record = {}) { return { taskId: 88, taskNo: 'JD-1', taskStatus: 'RUNNING', success: false, errorMessage: null, shopName: '花屿巷旗舰店', listTabs: ['ONSALE', 'OFFSALE'], rowCount: 30, itemsReceived: 30, total: 100, page: 2, listTab: 'ONSALE', batches: 1, createdAt: '2026-11-15T10:00:00', updatedAt: null, finishedAt: null, ...over, } } function batchOf(item: Record) { return { items: [ { task: { id: item.taskId ?? 88, taskNo: 'JD-1', status: item.taskStatus ?? 'RUNNING', errorMessage: item.errorMessage ?? null, updatedAt: null, }, items: [item], }, ], missingTaskIds: [], } } let wrapper: VueWrapper | null = null /** el-select/el-option 轻量桩:轮询组用例不带真实 ElementPlus——真件在 fake timers 下 * 的内部计时/Popper 会被 `advanceTimersByTimeAsync(60s)` 一并点燃、打断任务面板轮询链 * (2026-11-17 改版实测 SUCCESS/FAILED 两格因此转红)。下拉形状由分类两格的真实组件 * 用例兜底,这里只保证模板可解析、v-model 透传、选项渲染计数。 */ const ElSelectStub = { name: 'ElSelect', props: ['modelValue'], emits: ['update:modelValue'], template: '
', } const ElOptionStub = { name: 'ElOption', props: ['label', 'value'], template: '
{{ label }}
', } async function mountPage(realSelect = false) { wrapper = mount(JdCollectTab, { global: { // 分类两格用真实 ElementPlus 组件树(经 update:modelValue 模拟点选, // 弹层 teleport 到 body,不依赖开合动画);其余格用桩。 ...(realSelect ? { plugins: [ElementPlus] } : {}), stubs: { NotificationBell: true, RouterLink: { template: '' }, 'router-link': { template: '' }, ...(realSelect ? {} : { 'el-select': ElSelectStub, 'el-option': ElOptionStub }), }, }, }) await flushPromises() return wrapper } async function startCollect(w: VueWrapper) { await w.find('.collect-btn').trigger('click') await flushPromises() } /** 「同步分类」拉回的当前店铺分类样本(label/value 与旧快照同形;顺序=同步序/orderNo)。 */ const SYNCED_CATEGORIES = [ { label: '工作制服', value: '1024347567' }, { label: '礼服/演出服', value: '1024347568' }, { label: '拉丁舞服', value: '1024347572' }, ] function syncedResult(over: Record = {}) { return { success: true, shopName: '花屿巷旗舰店', shopId: '165515933', categories: SYNCED_CATEGORIES, ...over } } async function syncCategories(w: VueWrapper) { await w.find('.shop-cat-sync').trigger('click') await flushPromises() } beforeEach(() => { vi.useFakeTimers() localStorage.setItem('username', 'admin') for (const mock of Object.values(api)) { // 无桥用例会把 syncCategories 覆写成 undefined,这里按可重置性防御(保持全量 reset 语义)。 if (typeof (mock as { mockReset?: unknown })?.mockReset === 'function') mock.mockReset() } api.createJdCollectTask.mockResolvedValue({ taskId: 88, taskNo: 'JD-1', collectChannel: 'LOCAL' }) api.activateJdCollectTask.mockResolvedValue(null) api.fetchJdCollectCategories.mockResolvedValue([]) api.fetchJdCollectGroups.mockResolvedValue([]) api.enqueue.mockResolvedValue({ success: true }) api.fetchJdCollectDashboard.mockResolvedValue(EMPTY_DASHBOARD) api.fetchJdCollectHistory.mockResolvedValue({ items: [] }) api.fetchJdCollectTaskProgressBatch.mockResolvedValue(batchOf(historyItem())) vi.spyOn(console, 'error').mockImplementation(() => {}) vi.spyOn(console, 'warn').mockImplementation(() => {}) }) afterEach(() => { wrapper?.unmount() wrapper = null vi.useRealTimers() vi.restoreAllMocks() localStorage.clear() }) describe('获取店铺数据:一键采集 + 任务面板', () => { it('点一次按钮就走完整链路:建单 → 激活 → 推本机队列 → 轮询批量进度', async () => { const w = await mountPage() await startCollect(w) expect(api.createJdCollectTask).toHaveBeenCalledTimes(1) // 店铺名留空 → 按「京麦后台」占位(客户端从京麦后台现读真实店铺名落库); // 不选分类=双键空数组(全店采集,后端归一化为 null 进 request_json) expect(api.createJdCollectTask).toHaveBeenCalledWith('京麦后台', ['ONSALE', 'OFFSALE'], 0, [], [], []) expect(api.activateJdCollectTask).toHaveBeenCalledWith(88) expect(api.enqueue).toHaveBeenCalledTimes(1) const payload = api.enqueue.mock.calls[0][0] expect(payload.type).toBe('jd-shop-collect-run') expect(payload.data).toEqual({ taskId: 88, shopName: '京麦后台', listTabs: ['ONSALE', 'OFFSALE'], maxProducts: 0, shopCategoryNames: [], shopCategoryIds: [], }) // 轮询已启动:批量进度端点拿到任务 88 expect(api.fetchJdCollectTaskProgressBatch).toHaveBeenCalled() const calledIds = api.fetchJdCollectTaskProgressBatch.mock.calls[0][0] expect(calledIds).toContain(88) }) it('有 total 时任务卡片显示真实百分比(分母只来自服务端游标)', async () => { const w = await mountPage() await startCollect(w) await flushPromises() expect(w.find('.task-item').exists()).toBe(true) expect(w.find('.status').text()).toBe('正在获取店铺数据…') const bar = w.find('.file-progress-bar') expect(bar.exists()).toBe(true) expect(bar.attributes('style')).toContain('width: 30%') // 百分比文字随 countLabel 一起出(TaskItemCard 有 countLabel 就不显示「总进度 X%」) expect(w.find('.file-progress-meta').text()).toContain('已采集 30/100 个商品(30%)') }) it('没有分母(total 缺失)时只显示已采集行数,不编造百分比', async () => { api.fetchJdCollectTaskProgressBatch.mockResolvedValue( batchOf(historyItem({ total: null, page: null, itemsReceived: 30, rowCount: 30 })), ) const w = await mountPage() await startCollect(w) await flushPromises() const meta = w.find('.file-progress-meta') expect(meta.exists()).toBe(true) expect(meta.text()).toContain('已采集 30 个商品') expect(meta.text()).not.toContain('%') expect(w.find('.file-progress-bar').attributes('style')).toContain('width: 0%') }) it('分片被拒时进度行以落库 rowCount 为准(itemsReceived 低估不再与行数行自相矛盾)', async () => { // 34959 实录(2026-11-19):8 行已落京东数据库、分片回传 500 ⇒ 服务端 // itemsReceived=0、rowCount=8,extraLines 显示「已采集 8 个商品」而进度行显示 0。 api.fetchJdCollectTaskProgressBatch.mockResolvedValue( batchOf(historyItem({ total: 8, itemsReceived: 0, rowCount: 8 })), ) const w = await mountPage() await startCollect(w) await flushPromises() const meta = w.find('.file-progress-meta') expect(meta.text()).toContain('已采集 8/8 个商品(99%)') expect(meta.text()).not.toContain('已采集 0 个') // 已落库 8/8:条形按 99% 封顶(SUCCESS 才满格) expect(w.find('.file-progress-bar').attributes('style')).toContain('width: 99%') }) it('没有分母且分片被拒时已采行数也取 rowCount 真值', async () => { api.fetchJdCollectTaskProgressBatch.mockResolvedValue( batchOf(historyItem({ total: null, page: null, itemsReceived: 0, rowCount: 8 })), ) const w = await mountPage() await startCollect(w) await flushPromises() expect(w.find('.file-progress-meta').text()).toContain('已采集 8 个商品') expect(w.find('.file-progress-meta').text()).not.toContain('已采集 0 个') }) it('SUCCESS 终态:状态徽章落「获取完成」、进度满格,且从轮询中收手', async () => { const w = await mountPage() await startCollect(w) await flushPromises() api.fetchJdCollectTaskProgressBatch.mockResolvedValue( batchOf(historyItem({ taskStatus: 'SUCCESS', success: true, itemsReceived: 100, rowCount: 100 })), ) await vi.advanceTimersByTimeAsync(60_000) await flushPromises() expect(w.find('.status').text()).toBe('获取完成') // 终态任务没有进度条(isActiveTask 才有),行数行收口在卡片 extraLines expect(w.find('.file-progress-bar').exists()).toBe(false) expect(w.find('.task-item').text()).toContain('已采集 100 个商品') // 终态即收手:再推进几轮轮询间隔,批量进度不再被调 const callsAfterTerminal = api.fetchJdCollectTaskProgressBatch.mock.calls.length await vi.advanceTimersByTimeAsync(60_000) await flushPromises() expect(api.fetchJdCollectTaskProgressBatch.mock.calls.length).toBe(callsAfterTerminal) }) it('FAILED 终态:显示服务端原因、出「重试」按钮,重试走原位复位并重新激活推队列', async () => { const w = await mountPage() await startCollect(w) await flushPromises() api.fetchJdCollectTaskProgressBatch.mockResolvedValue( batchOf(historyItem({ taskStatus: 'FAILED', success: false, errorMessage: '京麦后台未登录,请先在客户端登录京麦', itemsReceived: 30, })), ) await vi.advanceTimersByTimeAsync(60_000) await flushPromises() expect(w.find('.status').text()).toBe('获取失败') expect(w.find('.task-item').text()).toContain('京麦后台未登录') const retryBtn = w.find('.btn-retry') expect(retryBtn.exists()).toBe(true) expect(retryBtn.text()).toBe('重试') await retryBtn.trigger('click') await flushPromises() // 铁律 26:原任务复位(不克隆新任务),复位后重新激活并推队列(断点续传) expect(api.retryClientTask).toHaveBeenCalledWith(88) expect(api.activateJdCollectTask).toHaveBeenCalledWith(88) expect(api.enqueue).toHaveBeenCalled() const pushPayload = api.enqueue.mock.calls.at(-1)?.[0] expect(pushPayload?.type).toBe('jd-shop-collect-run') expect(pushPayload?.data?.taskId).toBe(88) }) it('建单失败:只报错不留假任务,一次批量进度请求也不发', async () => { api.createJdCollectTask.mockRejectedValue(new Error('缺少登录凭据')) const w = await mountPage() await startCollect(w) expect(w.find('.feedback.error').text()).toContain('缺少登录凭据') expect(api.fetchJdCollectTaskProgressBatch).not.toHaveBeenCalled() expect(api.enqueue).not.toHaveBeenCalled() }) it('激活失败:不推队列(否则首个分片必被「任务不在运行中」拒收),并把原因说给用户', async () => { api.activateJdCollectTask.mockRejectedValue(new Error('服务暂不可用')) const w = await mountPage() await startCollect(w) expect(api.activateJdCollectTask).toHaveBeenCalledWith(88) expect(api.enqueue).not.toHaveBeenCalled() expect(w.find('.feedback.error').text()).toContain('任务激活失败') }) it('激活时服务端回「已在执行中」:等同激活成功,照常推队列', async () => { api.activateJdCollectTask.mockRejectedValue(new Error('任务已在执行中(客户端已认领)')) const w = await mountPage() await startCollect(w) expect(api.enqueue).toHaveBeenCalledTimes(1) expect(w.find('.feedback.error').exists()).toBe(false) }) it('推送本机队列失败:走 amber notice 提示(不占红色 error),建单与轮询照常', async () => { // 2026-11-19 用户实录:建单撞上客户端升级重启窗口,推送失败被渲染成红色「推送失败」 // 横幅;实为设计内兜底慢路径(客户端 60 秒一轮 pull-pending 自动认领,最多晚约 1 // 分钟)。桥返回失败必须按提示展示,红色 error 只留给真失败(建单/激活失败)。 api.enqueue.mockResolvedValue({ success: false, error: 'queue is closing' }) const w = await mountPage() await startCollect(w) expect(api.createJdCollectTask).toHaveBeenCalledTimes(1) const notice = w.find('.feedback.notice') expect(notice.exists()).toBe(true) expect(notice.text()).toContain('任务已创建') expect(notice.text()).toContain('自动领取') expect(notice.text()).not.toContain('失败') expect(w.find('.feedback.error').exists()).toBe(false) // 建单成功即进轮询:兜底拉取认领后进度照常上屏 expect(api.fetchJdCollectTaskProgressBatch).toHaveBeenCalled() }) it('推送抛异常:同样走 notice 提示、不回滚建单', async () => { api.enqueue.mockRejectedValue(new Error('bridge gone')) const w = await mountPage() await startCollect(w) const notice = w.find('.feedback.notice') expect(notice.exists()).toBe(true) expect(notice.text()).toContain('自动领取') expect(notice.text()).not.toContain('失败') expect(w.find('.feedback.error').exists()).toBe(false) expect(api.fetchJdCollectTaskProgressBatch).toHaveBeenCalled() }) it('下拉选分类后建单:店内分类双键随建单请求体与推送载荷同链下发', async () => { // 2026-11-16 客户口径「类目不需要只要分类」「选京麦的内部分类去采集」; // 2026-11-17 客户口径「不要全展示出来,弄个下拉式多选」;2026-11-19 选项集改 // 「同步分类」桥实时拉取(每家店的店内分类名字与 id 都不同,冻结快照已退役)。 // 建单请求体与推送载荷带 label+id 双键、按选项集原序反查(行级填充形状未取证, // 客户端任一键命中即命中)——选中项用同步样本真实行,贴合下发形状。 api.syncCategories.mockResolvedValue(syncedResult()) const w = await mountPage(true) await syncCategories(w) const select = w.findComponent(ElSelect) expect(select.exists(), '采集分类必须是下拉多选(el-select),不再是逐条复选框').toBe(true) await select.vm.$emit('update:modelValue', ['1024347572', '1024347567']) await flushPromises() await startCollect(w) // 双键顺序恒等于选项集序(工作制服在前),与点选先后无关——同源反查,不随 UI 顺序漂。 expect(api.createJdCollectTask).toHaveBeenCalledWith('京麦后台', ['ONSALE', 'OFFSALE'], 0, [], ['工作制服', '拉丁舞服'], ['1024347567', '1024347572']) const payload = api.enqueue.mock.calls[0][0] expect(payload.data).toEqual({ taskId: 88, shopName: '京麦后台', listTabs: ['ONSALE', 'OFFSALE'], maxProducts: 0, shopCategoryNames: ['工作制服', '拉丁舞服'], shopCategoryIds: ['1024347567', '1024347572'], }) }) it('同步分类成功:选项集换成当前店铺实时分类并显示店铺名(不再是 9 个冻结快照)', async () => { const w = await mountPage(true) const block = w.findAll('.category-block').find((el) => el.text().includes('采集分类')) expect(block, '必须有「采集分类(可选,多选)」块').toBeTruthy() // 未同步:选项集为空(不预置任何快照),提示指向「同步分类」;空选=全店采集。 expect(w.findAllComponents(ElOption).length).toBe(0) expect(block!.text()).toContain('未同步或空选=全店采集') expect(block!.text()).not.toContain('2026-11-16 快照') expect(block!.findComponent(ElSelect).props('placeholder')).toBe('全店采集(点击选择分类)') api.syncCategories.mockResolvedValue(syncedResult()) await syncCategories(w) expect(w.findAllComponents(ElOption).length).toBe(SYNCED_CATEGORIES.length, '选项集必须等于桥拉回的当前店铺分类,不是冻结快照的 9 个') expect(block!.text()).toContain('已同步店铺「花屿巷旗舰店」:3 个分类') expect(block!.text()).not.toContain('未同步') // 按钮回到可再同步态(店铺侧改了分类可随时重拉) const syncBtn = w.find('.shop-cat-sync') expect(syncBtn.text()).toBe('同步分类') expect(syncBtn.attributes('disabled')).toBeUndefined() }) it('同步失败 jd_busy:京东任务在跑是设计内等待,走 amber notice 不占红色 error', async () => { api.syncCategories.mockResolvedValue( syncedResult({ success: false, code: 'jd_busy', error: '京东采集/发布任务正在运行,请等任务结束后再同步分类' })) const w = await mountPage(true) await syncCategories(w) const notice = w.find('.feedback.notice') expect(notice.exists()).toBe(true) expect(notice.text()).toContain('任务正在运行') expect(w.find('.feedback.error').exists()).toBe(false) // 分类照常未同步:选项集仍空(busy 后不得回落假数据) expect(w.findAllComponents(ElOption).length).toBe(0) }) it('同步失败 jd_login:京麦未登录要用户去登录,走红色 error', async () => { api.syncCategories.mockResolvedValue( syncedResult({ success: false, code: 'jd_login', error: '京麦未登录(登录态失效),请先在客户端登录京麦' })) const w = await mountPage(true) await syncCategories(w) const error = w.find('.feedback.error') expect(error.exists()).toBe(true) expect(error.text()).toContain('京麦未登录') expect(w.find('.feedback.notice').exists()).toBe(false) expect(w.findAllComponents(ElOption).length).toBe(0) }) it('老客户端无同步桥:按钮置灰,全店采集不受影响', async () => { const originalSync = api.syncCategories api.syncCategories = undefined as unknown as typeof api.syncCategories try { const w = await mountPage(true) await flushPromises() const syncBtn = w.find('.shop-cat-sync') expect(syncBtn.exists()).toBe(true) // 桥上没有 get_jd_shop_categories(老客户端/浏览器打开)⇒ 按钮置灰, // 用户根本点不到(无桥提示 SYNC_UNAVAILABLE_NOTE 的形状由 jd-collect-tab 纯测试钉住) expect(syncBtn.attributes('disabled')).toBeDefined() expect(w.findAllComponents(ElOption).length).toBe(0) // 全店采集主链路不依赖分类:建单双键空数组照常 await startCollect(w) expect(api.createJdCollectTask).toHaveBeenCalledWith('京麦后台', ['ONSALE', 'OFFSALE'], 0, [], [], []) } finally { // 覆写必须还原:hoisted 对象的 undefined 会穿过 beforeEach 的 mockReset 泄漏到后续用例 api.syncCategories = originalSync } }) it('重同步换店:清掉不属于当前店铺的已选分类,防止跨店 id 误过滤', async () => { api.syncCategories.mockResolvedValue(syncedResult()) const w = await mountPage(true) await syncCategories(w) const select = w.findComponent(ElSelect) await select.vm.$emit('update:modelValue', ['1024347567', '1024347572']) await flushPromises() // 换了一家店:新分类集与旧店 id 无交集 ⇒ 旧已选项必须被清掉并告知 api.syncCategories.mockResolvedValue(syncedResult({ shopName: '另一家旗舰店', categories: [ { label: '男士上衣', value: '9900000001' }, { label: '其他', value: '9900000002' }, ], })) await syncCategories(w) expect(w.text()).toContain('清除了 2 个不属于当前店铺的已选项') expect(w.findAllComponents(ElOption).length).toBe(2) await startCollect(w) const payload = api.enqueue.mock.calls[0][0] // 跨店残留 id 不得进建单请求体(否则按另一家店的分类过滤,0 行命中) expect(payload.data.shopCategoryIds).toEqual([]) expect(payload.data.shopCategoryNames).toEqual([]) }) })