Files
crawler-plugin/admin-frontend-vue/tests/mount/jd-category-sidebar.mount.test.ts
T

234 lines
11 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.
/**
* 京东数据库侧栏(JdCategorySidebar,v1.6 蓝图 Phase 2)的挂载契约。
*
* 纯展示组件:取数与失败兜底全在页面(props 流入、emit 流出),本文件零 api mock——
* 钉的是「徽标数=点节点后列表命中的行数」(jdCategoryCountTree 同源)、双 Tab 切换、
* 点节点 emit 形状(树内带路径/树外兜底 path 空/全部商品 null)、可写档分档入口。
*
* 跑法:`npx vitest run tests/mount/jd-category-sidebar.mount.test.ts`
*/
import { beforeEach, describe, expect, it } from 'vitest'
import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
import JdCategorySidebar from '@/pages/jd/JdCategorySidebar.vue'
import type { JdProductCategoryOption, JdProductGroup } from '@/pages/jd/jd-product-api.ts'
/** 类目计数夹具:树内名(连衣裙支+同名跨支短裤)+树外历史名,读数与 Phase 1
* 纯函数测试同源——服饰内衣根徽标 20(子树去重)、全部商品 37、兜底 12。 */
const CATEGORY_OPTIONS: JdProductCategoryOption[] = [
{ name: '连衣裙', productCount: 7 },
{ name: '短袖连衣裙', productCount: 4 },
{ name: '艺考形体服', productCount: 5 },
{ name: '短裤', productCount: 9 },
{ name: '已下架历史类目', productCount: 12 },
]
const CATEGORIES: JdProductGroup[] = [
{ id: 7, name: '裙装', ownerGroupId: 11, sortOrder: 0, productCount: 3 },
{ id: 8, name: '裤装', ownerGroupId: 11, sortOrder: 1, productCount: 1 },
]
interface MountOptions {
editable?: boolean
selectedCategory?: { name: string; path: string[] } | null
selectedGroupId?: number | null
}
function mountSidebar(options: MountOptions = {}): VueWrapper<Element> {
return mount(JdCategorySidebar, {
props: {
categoryOptions: CATEGORY_OPTIONS,
categories: CATEGORIES,
editable: options.editable ?? true,
selectedCategory: options.selectedCategory ?? null,
selectedGroupId: options.selectedGroupId ?? null,
},
})
}
/** 在指定 Tab 体内按文案找行(两个 Tab 体 v-show 共存于 DOM,必须先圈定范围)。 */
function rowByText(scope: VueWrapper<Element>, text: string) {
const row = scope.findAll('.jd-side-row').find((node) => node.text().includes(text))
expect(row, `应存在文案含「${text}」的侧栏行`).toBeTruthy()
return row!
}
beforeEach(() => {
// 纯展示组件无副作用;占位保持与页面 mount 测试同构。
})
describe('商品目录 Tab(京麦授权类目树+计数徽标)', () => {
it('出厂停在商品目录 Tab;徽标与 Phase 1 聚合同源(根=子树去重和、全部商品=计数行总和)', () => {
const wrapper = mountSidebar()
const catalog = wrapper.get('.jd-side-catalog')
const all = catalog.get('.jd-side-all')
expect(all.text()).toContain('全部商品')
expect(all.text()).toContain('37', '全部商品徽标=5 条计数行求和(7+4+5+9+12)')
expect(rowByText(catalog, '服饰内衣').text()).toContain('20',
'服饰内衣根徽标=子树去重和(连衣裙7+短袖4+短裤9,短裤跨支同名只记一次)')
expect(rowByText(catalog, '母婴').text()).toContain('0', '无词条一级归 0 不缺节点')
expect(rowByText(catalog, '运动户外').text()).toContain('5')
wrapper.unmount()
})
it('一级默认展开(二级首屏可见);逐级展开后末级行点行 emit {name, path}', async () => {
const wrapper = mountSidebar()
const catalog = wrapper.get('.jd-side-catalog')
const women = rowByText(catalog, '女装')
expect(women.classes()).toContain('depth-1', '一级默认展开 ⇒ 二级行(depth-1 缩进)首屏可见')
// 末级艺考形体服在 depth-2:其父(舞蹈体操鞋服/装备)未展开时不可见。
expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('艺考形体服'))).toBe(false)
await catalog.get('[aria-label="展开或收起 舞蹈体操鞋服/装备"]').trigger('click')
await flushPromises()
const yikao = rowByText(catalog, '艺考形体服')
expect(yikao.classes()).toContain('depth-2', '艺考形体服是 level 3(depth 2 缩进)')
await yikao.trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')).toEqual([[{ name: '艺考形体服', path: ['运动户外', '舞蹈体操鞋服/装备', '艺考形体服'] }]])
wrapper.unmount()
})
it('点二级节点 emit 完整路径(页面按子树展开 IN);箭头只折展不选中', async () => {
const wrapper = mountSidebar()
const catalog = wrapper.get('.jd-side-catalog')
// 女装行未展开时,其子行(连衣裙)不可见。
expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(false)
const women = rowByText(catalog, '女装')
await women.trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')).toEqual([[{ name: '女装', path: ['服饰内衣', '女装'] }]],
'点行=选中即筛,emit 完整名称路径')
// 点行顺手展开(下钻感):子行现在可见。
expect(wrapper.emitted('select-category')).toHaveLength(1)
expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(true,
'非末级行点行后展开子级')
// 箭头(role=button, aria-label)只折展:点它不得触发 select-category。
const before = wrapper.emitted('select-category')?.length ?? 0
await catalog.get('[aria-label="展开或收起 女装"]').trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')?.length).toBe(before, '箭头点击不选中(click.stop 防冒泡)')
expect(catalog.findAll('.jd-side-row').some((node) => node.text().includes('连衣裙'))).toBe(false,
'再点箭头=收起(子行隐藏)')
wrapper.unmount()
})
it('「全部商品」行 emit null(页面清类目筛选重查);挂载即带选中态时祖先自动展开并高亮', async () => {
const wrapper = mountSidebar({ selectedCategory: { name: '连衣裙', path: ['服饰内衣', '女装', '连衣裙'] } })
const catalog = wrapper.get('.jd-side-catalog')
const dress = rowByText(catalog, '连衣裙')
expect(dress.classes()).toContain('selected', '外部选中态回显高亮')
expect(dress.classes()).toContain('depth-2', '挂载即带选中 ⇒ watch immediate 展开祖先(女装已展开,行可见)')
await wrapper.setProps({ selectedCategory: null })
expect(catalog.get('.jd-side-all').classes()).toContain('selected', 'null=全部商品高亮')
await catalog.get('.jd-side-all').trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')).toEqual([[null]], '点全部商品=清选')
wrapper.unmount()
})
})
describe('树外兜底组(树上对不上的历史行,单名等值出口)', () => {
it('兜底组头渲染计数和=extraTotal;行点击 emit {name, path:[]}(页面按单名等值回落)', async () => {
const wrapper = mountSidebar()
const catalog = wrapper.get('.jd-side-catalog')
const head = catalog.get('.jd-side-extra-head')
expect(head.text()).toContain('树外兜底')
expect(head.text()).toContain('12', '兜底组头徽标=extraTotal(历史行求和)')
const extra = rowByText(catalog, '已下架历史类目')
await extra.trigger('click')
await flushPromises()
expect(wrapper.emitted('select-category')).toEqual([[{ name: '已下架历史类目', path: [] }]],
'树外名 path 空数组=无路径序列化(单名等值旧形状,不静默丢筛选)')
wrapper.unmount()
})
it('全部是树内名时兜底组整体不渲染(不占一条空组)', () => {
const wrapper = mount(JdCategorySidebar, {
props: {
categoryOptions: [{ name: '连衣裙', productCount: 7 }],
categories: CATEGORIES,
editable: true,
selectedCategory: null,
selectedGroupId: null,
},
})
expect(wrapper.find('.jd-side-extra').exists()).toBe(false)
wrapper.unmount()
})
})
describe('店铺分类 Tab(当前分组分类平铺+入口分档)', () => {
it('点店铺分类切 Tab;分类行带计数;点行 emit id、再点已选中的 emit null(toggle 清选)', async () => {
const wrapper = mountSidebar()
const tabs = wrapper.findAll('.jd-sidebar-tab')
expect(tabs.map((tab) => tab.text())).toEqual(['商品目录', '店铺分类'])
await tabs[1]!.trigger('click')
await flushPromises()
expect(tabs[1]!.classes()).toContain('active')
const custom = wrapper.get('.jd-side-custom')
const skirt = rowByText(custom, '裙装')
expect(skirt.text()).toContain('3', '分类行计数徽标')
await skirt.trigger('click')
await flushPromises()
expect(wrapper.emitted('select-group')).toEqual([[7]])
await wrapper.setProps({ selectedGroupId: 7 })
expect(rowByText(custom, '裙装').classes()).toContain('selected', '选中态回显')
await rowByText(custom, '裙装').trigger('click')
await flushPromises()
expect(wrapper.emitted('select-group')?.at(-1)).toEqual([null], '再点已选中=清选回全部分类')
wrapper.unmount()
})
it('可写档出「新建分类」行:emit 分类名并清输入,空名按钮置灰;只读档不渲染该行', async () => {
const editable = mountSidebar({ editable: true })
const custom = editable.get('.jd-side-custom')
const input = custom.get('[aria-label="新分类名称"]')
const createBtn = custom.findAll('button').find((b) => b.text() === '新建分类')!
expect(createBtn.attributes('disabled')).toBeDefined()
await input.setValue('上新区')
await createBtn.trigger('click')
await flushPromises()
expect(editable.emitted('create-category')).toEqual([['上新区']],
'侧栏只 emit,建分类的 API 调用与刷新在页面(Phase 5 接线)')
expect((input.element as HTMLInputElement).value).toBe('', '提交即清输入')
await input.setValue(' ')
expect(createBtn.attributes('disabled')).toBeDefined(), '纯空白名按钮置灰'
editable.unmount()
const readonly = mountSidebar({ editable: false })
expect(readonly.get('.jd-side-custom').find('[aria-label="新分类名称"]').exists()).toBe(false,
'只读档不渲染新建行')
readonly.unmount()
})
it('「分类管理」入口对所有人渲染(同组普通号只读可看 V203),点击 emit manage-categories', async () => {
for (const editable of [true, false]) {
const wrapper = mountSidebar({ editable })
const manage = wrapper.get('.jd-side-custom').get('.jd-side-manage')
expect(manage.text()).toBe('分类管理')
await manage.trigger('click')
await flushPromises()
expect(wrapper.emitted('manage-categories')).toHaveLength(1)
wrapper.unmount()
}
})
it('空分类空态文案分档:可写档引导新建,只读档直说', () => {
const writable = mount(JdCategorySidebar, {
props: { categoryOptions: [], categories: [], editable: true, selectedCategory: null, selectedGroupId: null },
})
expect(writable.get('.jd-side-empty').text()).toBe('本组暂无分类,先新建一个')
writable.unmount()
const readonly = mount(JdCategorySidebar, {
props: { categoryOptions: [], categories: [], editable: false, selectedCategory: null, selectedGroupId: null },
})
expect(readonly.get('.jd-side-empty').text()).toBe('本组暂无分类')
readonly.unmount()
})
})