Files
crawler-plugin/frontend-vue/tests/mount/jd-collect-progress.mount.test.ts

360 lines
15 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 「获取店铺数据」一键采集 + 任务面板挂载用例(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(),
}))
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 }),
}))
const EMPTY_DASHBOARD = {
pendingTaskCount: 0,
processedTaskCount: 0,
successTaskCount: 0,
failedTaskCount: 0,
}
function historyItem(over: Record<string, unknown> = {}) {
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<string, unknown>) {
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: '<div class="shop-cat-select"><slot /></div>',
}
const ElOptionStub = {
name: 'ElOption',
props: ['label', 'value'],
template: '<div class="shop-cat-option">{{ label }}</div>',
}
async function mountPage(realSelect = false) {
wrapper = mount(JdCollectTab, {
global: {
// 分类两格用真实 ElementPlus 组件树(经 update:modelValue 模拟点选,
// 弹层 teleport 到 body,不依赖开合动画);其余格用桩。
...(realSelect ? { plugins: [ElementPlus] } : {}),
stubs: {
NotificationBell: true,
RouterLink: { template: '<a class="router-link-stub"><slot /></a>' },
'router-link': { template: '<a class="router-link-stub"><slot /></a>' },
...(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()
}
beforeEach(() => {
vi.useFakeTimers()
localStorage.setItem('username', 'admin')
for (const mock of Object.values(api)) 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('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('下拉选分类后建单:店内分类双键随建单请求体与推送载荷同链下发', async () => {
// 2026-11-16 客户口径「类目不需要只要分类」「选京麦的内部分类去采集」;
// 2026-11-17 客户口径「不要全展示出来,弄个下拉式多选」:checkbox 列表换 el-select
// 多选(collapse-tags)。选项集=京麦「店内分类」快照(jd-shop-category.ts,取证 9 个),
// 选择模型是 id 数组;建单请求体与推送载荷带 label+id 双键、按快照原序反查(行级填充
// 形状未取证,客户端任一键命中即命中)——选中项用快照真实行,贴合下发形状。
const w = await mountPage(true)
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('采集分类块:下拉渲染快照全量选项并可清空(恢复全店采集)', async () => {
const w = await mountPage(true)
const block = w.findAll('.category-block').find((el) => el.text().includes('采集分类'))
expect(block, '必须有「采集分类(可选,多选)」块').toBeTruthy()
expect(block!.text()).toContain('采集分类(可选,多选)')
// 快照 9 项全进下拉选项(客户端「能看见管理员/商家建的分类」口径落点就在这;
// 弹层 teleport 到 body,选项组件仍挂在页面组件树里,按组件计数不按 DOM)
expect(w.findAllComponents(ElOption).length).toBe(9)
expect(block!.find('.shop-cat-select').exists(), '分类块必须是 el-select 下拉').toBe(true)
expect(block!.text()).toContain('默认全店采集')
expect(block!.findComponent(ElSelect).props('placeholder')).toBe('全店采集(点击选择分类)')
const select = block!.findComponent(ElSelect)
await select.vm.$emit('update:modelValue', ['1024347567'])
await flushPromises()
expect(block!.text()).toContain('只采选中 1 个分类的商品')
expect(block!.find('.shop-cat-clear').exists(), '选中后出「清空」').toBe(true)
await block!.find('.shop-cat-clear').trigger('click')
await flushPromises()
expect(block!.text()).toContain('默认全店采集')
})
})