Files
crawler-plugin/frontend-vue/tests/mount/jd-collect-progress.mount.test.ts
T
huangzd1997 e621deea58 feat(jd-collect): 建单页按京麦店内分类多选采集
客户口径「类目不需要只要分类」「做成多选的」:采集建单页下线类目级联与平台分组,
换京麦「店内分类」快照多选(getShopCategoryList 2026-11-16 取证 9 个,见
ops docs/jd-collect-api-contract.md §2.6)。建单请求体/页面推送/兜底拉取三处同键
shopCategoryNames+shopCategoryIds(label+id 双键,行级填充形状未取证,客户端任一
命中即命中);categoryPaths 标 @Deprecated 仅历史行兼容。超长归一化文案泛化为
normalizeStringSelection;历史行 VO 带回双键供重试/继续同源。
删除建单页唯一消费方的死件:JdCategoryCascader.vue/jd-category-tree.ts/其测试
(后管另有在用副本,不受影响)。

判据:JdCollectTaskServiceTest 三例(双键归一化/空白归 null/51 个拒)+
JdTaskPullSpiImplTest 七键载荷透传;前端 jd-collect-tab/jd-shop-category/mount
三支(快照消费、双键同链、绊线:级联组件与分组接口不得回流建单页)。
可读棘轮:JdCollectTab.vue 804→786 行(同款返回按钮 CSS 合并、死 .download 类删除)。
客户端侧(app_client jd_base 行级过滤)同窗另一仓提交。
2026-11-16 20:14:40 +08:00

338 lines
14 KiB
TypeScript
Raw 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 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
async function mountPage() {
wrapper = mount(JdCollectTab, {
global: {
stubs: {
NotificationBell: true,
RouterLink: { template: '<a class="router-link-stub"><slot /></a>' },
'router-link': { template: '<a class="router-link-stub"><slot /></a>' },
},
},
})
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 客户口径「类目不需要只要分类」「选京麦的内部分类去采集」+「做成多选的」:
// 选项集=京麦「店内分类」快照(jd-shop-category.ts,getShopCategoryList 取证 9 个),
// checkbox 多选;建单请求体与推送载荷带 label+id 双键(行级填充形状未取证,客户端
// 任一键命中即命中)——mock 选中项用快照真实行(拉丁舞服/1024347572),贴合下发形状。
const w = await mountPage()
const rows = w.findAll('.shop-cat-item')
expect(rows.length).toBeGreaterThan(0, '分类多选列表必须渲染快照选项')
const latinRow = rows.find((row) => row.text().includes('拉丁舞服'))
expect(latinRow, '快照里必须有「拉丁舞服」').toBeTruthy()
await latinRow!.find('input').setValue(true)
const uniformRow = rows.find((row) => row.text().includes('工作制服'))
await uniformRow!.find('input').setValue(true)
await flushPromises()
await startCollect(w)
expect(api.createJdCollectTask).toHaveBeenCalledWith('京麦后台', ['ONSALE', 'OFFSALE'], 0, [],
['拉丁舞服', '工作制服'], ['1024347572', '1024347567'])
const payload = api.enqueue.mock.calls[0][0]
expect(payload.data).toEqual({
taskId: 88,
shopName: '京麦后台',
listTabs: ['ONSALE', 'OFFSALE'],
maxProducts: 0,
shopCategoryNames: ['拉丁舞服', '工作制服'],
shopCategoryIds: ['1024347572', '1024347567'],
})
})
it('采集分类块:快照选项全量渲染并可取消勾选(清空恢复全店采集)', async () => {
const w = await mountPage()
const block = w.findAll('.category-block').find((el) => el.text().includes('采集分类'))
expect(block, '必须有「采集分类(可选,多选)」块').toBeTruthy()
expect(block!.text()).toContain('采集分类(可选,多选)')
// 快照 9 项全渲染(客户端「能看见管理员/商家建的分类」口径落点就在这)
expect(block!.findAll('.shop-cat-item').length).toBe(9)
expect(block!.text()).toContain('不选=全店采集')
const first = block!.findAll('.shop-cat-item')[0]
await first.find('input').setValue(true)
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('不选=全店采集')
})
})