feat(phase-2): 京东数据库侧栏组件——商品目录树计数徽标/树外兜底+店铺分类双 Tab(additive,页面 Phase 5 接线)
This commit is contained in:
@@ -0,0 +1,233 @@
|
||||
/**
|
||||
* 京东数据库侧栏(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()
|
||||
})
|
||||
})
|
||||
Reference in New Issue
Block a user