Files
crawler-plugin/admin-frontend-vue/tests/jd-product-group.test.ts
T

270 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.4 Phase 5 → v1.7 对齐原型《商品数据商城》)——
* node --test 直跑(纯函数零依赖)。
*
* 不用 readFileSync/readSource/globSync 读点:source-pin-ratchet 对台账外新文件带读点即红,
* 本文件只 import 被测纯函数。
*
* 覆盖:
* 1. **snake 参数形状**:toJdProductListParams 产出 `page`/`page_size`(默认 50、上限 1000、
* 档位 50/100/200/500/1000〔v1.7 对齐原型,上限与后端 JdProductQueryService.MAX_PAGE_SIZE
* 逐字同步〕)、`keyword`(v1.7 合并搜索:商品编码 OR 标题,OR 语义在后端 SQL)、
* `shop_name`(v1.7 店铺名单点选,精确 eq)、`min_price`/`max_price`(v1.7 价格区间)、
* `group_id`/`owner_group_id`/`synced_from`/`synced_to`(ISO yyyy-MM-dd;空白/非法不下发;
* groupId 空串→不带、有值→snake group_id;ownerGroupId>0 才带、0/null/NaN 一律不带=
* 后端按作用域默认分组取,V203);分页钳制(铁律 15)。
* 旧 `product_code`/`title_keyword` 两参数 v1.7 起前端停发(合并进 keyword;后端参数
* 保留兼容在飞请求);商品状态筛选与 json/txt 导出参数口仍随 2026-11-15 客户口径下线。
* 2. **详情解析**:parseJdProductDetail 解析 attrGroups/images(camel 为正 snake 容错、缺 url 弃行),
* attrGroups 解析不出时 attrJsonRaw 原文兜底;列表行解析缺 id 弃行。
*
* 跑法:`node --test tests/jd-product-group.test.ts`
*/
import { test } from 'node:test'
import assert from 'node:assert/strict'
import {
JD_PRODUCT_MAX_PAGE,
JD_PRODUCT_MAX_PAGE_SIZE,
JD_PRODUCT_PAGE_SIZE,
JD_PRODUCT_PAGE_SIZE_OPTIONS,
createJdProductFilterState,
toJdProductListParams,
} from '../src/pages/jd/jd-product-filter.ts'
import {
jdCategoryChildren,
jdCategoryRoots,
} from '../src/pages/jd/jd-category-tree.ts'
import {
JD_PRODUCT_DEFAULT_SIZE,
jdPriceRange,
parseJdProductDetail,
parseJdProductPage,
toJdProductItem,
} from '../src/pages/jd/jd-product-model.ts'
test('类目级联静态导航树——服饰内衣二级与京麦面板样本逐字同源,一级集非空且无重名', () => {
// 京麦面板真机样本(2026-11-16 客户截图):服饰内衣下就是这五个二级,改名即红。
assert.deepEqual(jdCategoryChildren(['服饰内衣']).map(node => node.name), ['服饰配件', '内衣', '女装', '男装', '定制服装/工装'])
assert.deepEqual(jdCategoryChildren(['不存在的类目']), [], '未知一级回落空子级(面板不出第二栏)')
const roots = jdCategoryRoots().map(node => node.name)
assert.deepEqual(roots, ['服饰内衣', '母婴', '运动户外'], '一级导航与京麦授权类目一致')
assert.equal(new Set(roots).size, roots.length, '一级类目名不得重复')
for (const root of roots) {
const children = jdCategoryChildren([root]).map(node => node.name)
assert.equal(new Set(children).size, children.length, `${root} 的二级不得重复`)
}
})
test('京东列表参数——snake 形状:keyword/店铺/价格下发,旧编码标题两框停发、日期空白/非法不下发', () => {
const full = toJdProductListParams(
{
keyword: ' 保温杯 ',
shopName: ' 绿屿街道店 ',
minPrice: ' 100 ',
maxPrice: 'abc',
groupId: ' 7 ',
syncedFrom: '2026-11-01',
syncedTo: '2026-11-09',
},
2,
20,
// V203 第 4 参=当前数据权限分组(分类列/分类筛选的作用域,不是筛选条件)。
11,
)
assert.deepEqual(full, {
page: 2,
page_size: 20,
keyword: '保温杯',
shop_name: '绿屿街道店',
min_price: 100,
group_id: 7,
owner_group_id: 11,
synced_from: '2026-11-01',
synced_to: '2026-11-09',
}, 'keyword/店铺 trim 后下发;非法价格(abc)不下发,合法价格转 number')
// 旧两框 v1.7 起前端停发(合并进 keyword):参数面不再出现(后端参数保留兼容在飞请求)。
assert.equal('product_code' in full, false, 'product_code 前端停发(合并搜索替代)')
assert.equal('title_keyword' in full, false, 'title_keyword 前端停发(合并搜索替代)')
assert.equal('sale_status' in full, false, '商品状态筛选已下线,参数面不再出现 sale_status')
// 出厂态=分页两项、不带 classified(2026-11-21 用户口径「默认改成全部」——全部档
// 序列化不带 classified 参数=后端跳过谓词查全量);
// 脏值(非数字分组、非法日期、非法价格)同罪不下发。
const blank = toJdProductListParams(createJdProductFilterState(), 1, 20)
assert.deepEqual(blank, { page: 1, page_size: 20 },
'出厂默认不带 classified 键——首屏查全量(默认全部档),不再卡未分类')
assert.equal('group_id' in blank, false, 'groupId 空串不带 group_id')
assert.equal('owner_group_id' in blank, false, '没传当前分组就不带 owner_group_id(后端按作用域默认组取)')
const dirty = toJdProductListParams(
{ ...createJdProductFilterState(), groupId: 'abc', syncedFrom: '2026/11/01', syncedTo: 'not-a-date', minPrice: 'abc', maxPrice: ' ' },
1,
20,
)
assert.deepEqual(dirty, { page: 1, page_size: 20 },
'脏值(分组/日期/价格)不下发;出厂态查全量(默认全部档)')
// 价格区间(v1.7 F2):合法上下限转 number 下发(后端 price_min >= X AND price_max <= Y)。
const priced = toJdProductListParams(
{ ...createJdProductFilterState(), minPrice: ' 100.5 ', maxPrice: '200' },
1,
20,
)
assert.deepEqual({ min_price: priced.min_price, max_price: priced.max_price }, { min_price: 100.5, max_price: 200 },
'价格区间合法值转 number 下发(字符串不发给后端 BigDecimal)')
// 当前分组非法值(0/NaN/null)一律不下发:0 是「不属于任何组」的哨兵,不能当组 id 发出去。
for (const bad of [0, null, undefined, Number.NaN]) {
assert.equal('owner_group_id' in toJdProductListParams(createJdProductFilterState(), 1, 20, bad), false,
`ownerGroupId=${String(bad)} 不得下发 owner_group_id`)
}
})
test('京东列表参数——page 钳制防 (page-1)*page_size 溢出(铁律 15)', () => {
const low = toJdProductListParams(createJdProductFilterState(), 0, 0)
assert.equal(low.page, 1, 'page<1 归 1')
assert.equal(low.page_size, 50, 'page_size 非法回默认 50(v1.6 新契约)')
const big = toJdProductListParams(createJdProductFilterState(), 3, 5000)
assert.equal(big.page_size, 1000, 'page_size 上限 1000(v1.7 对齐原型档位放宽)')
const extreme = toJdProductListParams(createJdProductFilterState(), Number.MAX_SAFE_INTEGER, 1000)
assert.equal(extreme.page, JD_PRODUCT_MAX_PAGE)
const offset = (extreme.page - 1) * extreme.page_size
assert.equal(Number.isSafeInteger(offset), true, `(page-1)*page_size=${offset} 必须留在安全整数域`)
assert.equal(offset, 9_999_000, '10_000 页 × 1000 条仍在 Number.MAX_SAFE_INTEGER 内')
})
/** v1.7 契约:首屏默认 50、档位 50/100/200/500/1000、上限 1000;model 侧默认与 filter 侧
* 同值不漂(页面装配层挂常量,两处字面量从此只剩常量出处;上限与后端
* JdProductQueryService.MAX_PAGE_SIZE 逐字同步——契约测试两侧钉着这个数)。 */
test('分页档位——默认 50、档位 50/100/200/500/1000、上限 1000(v1.7 对齐原型)', () => {
assert.deepEqual([...JD_PRODUCT_PAGE_SIZE_OPTIONS], [50, 100, 200, 500, 1000], '档位清单逐字同(v1.7 新契约)')
assert.ok(JD_PRODUCT_PAGE_SIZE_OPTIONS.includes(JD_PRODUCT_PAGE_SIZE), '默认值必须是档位之一')
assert.equal(JD_PRODUCT_PAGE_SIZE, 50, '默认档 50(v1.6 拍板放宽,v1.4 §3.4 的 20 已废)')
assert.equal(JD_PRODUCT_DEFAULT_SIZE, JD_PRODUCT_PAGE_SIZE, 'model 侧默认与 filter 侧同值')
assert.equal(JD_PRODUCT_MAX_PAGE_SIZE, 1000, '上限 1000(v1.7 对齐原型,与后端 MAX_PAGE_SIZE 逐字同步)')
})
/** 分类状态快筛(2026-11-17 用户口径「加个已分类和未分类的筛选」;2026-11-18「加个全部
* 选项」恢复全量档;**2026-11-21 用户口径「默认改成全部」=出厂默认改卡 ''**,推翻
* 11-17「默认卡未分类」):界面三档,'classified'→true、'ungrouped'→false、
* ''(全部)→ 不带 classified 参数;出厂默认与「重置」都卡 ''(全部)。
* 缺省/脏值同走「全部」兜底(不拿脏值冒充档位)。
* 参数名是新档 classified——不是后端仍拒收的旧 grouped/ungrouped 查询参数。 */
test('京东列表参数——classified 默认全部:已分类→true、未分类→false、脏值兜底不下发', () => {
const yes = toJdProductListParams({ ...createJdProductFilterState(), classified: 'classified' }, 1, 20, 11)
assert.equal(yes.classified, true)
assert.equal(yes.owner_group_id, 11, 'classified 与当前分组成对下发(后端按组判已/未分类)')
const no = toJdProductListParams({ ...createJdProductFilterState(), classified: 'ungrouped' }, 1, 20, 11)
assert.equal(no.classified, false, '未分类档显式选档仍下发 classified:false')
assert.equal(createJdProductFilterState().classified, '',
'出厂态与重置都必须卡「全部」档(2026-11-21 用户口径:默认改成全部)')
for (const blank of [undefined, 'grouped', 'nonsense'] as const) {
const q = toJdProductListParams({ ...createJdProductFilterState(), classified: blank }, 1, 20)
assert.equal('classified' in q, false, `classified=${String(blank)} 按「全部」兜底处理,不拿脏值冒充档位`)
}
})
test('详情解析——attrGroups/images 结构化解析(snake 容错、缺 url 弃行)', () => {
const detail = parseJdProductDetail({
code: 0,
message: 'ok',
data: {
id: 42,
title: '304不锈钢保温杯',
sale_status: '上架中',
attrGroups: [
{
groupName: '规格',
attrs: [
{ key: 'capacity', label: '容量', value: '500ml' },
{ key: 'material', label: '', value: '304不锈钢' },
],
},
{ group_name: '其他', attrs: [{ key: 'color', label: '颜色', value: '白色' }] },
],
images: [
{ imageType: 'MAIN', attrName: '', sortNo: 1, url: 'https://img.example/main.jpg', width: 800, height: 800 },
{ image_type: 'ATTR', attrName: '白色', sortNo: 2, url: 'https://img.example/white.jpg' },
{ imageType: 'ATTR', attrName: '', sortNo: 3, url: 'https://img.example/attr2.jpg' },
{ imageType: 'DETAIL', sortNo: 4, url: '' }, // 缺 url 弃行
],
},
})
assert.equal(detail.item.id, 42)
assert.equal(detail.item.title, '304不锈钢保温杯')
assert.equal(detail.item.saleStatus, '上架中', 'snake 容错')
assert.equal(detail.attrGroups.length, 2, '两个属性块')
assert.equal(detail.attrGroups[0].groupName, '规格')
assert.equal(detail.attrGroups[0].attrs[0].label, '容量')
assert.equal(detail.attrGroups[1].groupName, '其他', 'group_name snake 容错')
assert.equal(detail.images.length, 3, '缺 url 的 DETAIL 图弃行')
assert.equal(detail.images[1].imageType, 'ATTR', 'image_type snake 容错')
assert.equal(detail.images[1].attrName, '白色')
assert.equal(detail.images[1].sortNo, 2)
assert.equal(detail.images[2].attrName, '', 'attrName 缺省空串')
assert.equal(detail.attrJsonRaw, '', '结构化解析成功时不需要原文兜底')
})
test('详情解析——attrGroups 缺失时 attrJsonRaw 原文兜底;信封外裸负载同口径', () => {
const raw = '{"规格":{"容量":"500ml"}}'
const detail = parseJdProductDetail({ id: 7, attrJsonRaw: raw })
assert.equal(detail.item.id, 7)
assert.deepEqual(detail.attrGroups, [], 'attrGroups 解析不出为空')
assert.equal(detail.attrJsonRaw, raw, '原文兜底字段原样透传(界面展示,不静默吞)')
assert.deepEqual(detail.images, [])
// 非法负载不抛:整包垃圾回空详情(id 0),attrJsonRaw 留空。
const junk = parseJdProductDetail('not-an-object')
assert.equal(junk.item.id, 0)
assert.equal(junk.attrJsonRaw, '')
})
test('列表行解析——camel 为正 snake 容错、缺 id 弃行、价格区间拼装', () => {
const page = parseJdProductPage({
success: true,
data: {
items: [
{
id: 1,
shopId: 3,
shopName: '旗舰自营店',
productCode: 'JD-10086',
priceMin: '12.90',
priceMax: '15.90',
stockTotal: 500,
saleStatus: '上架中',
groupId: 7,
groupName: '甲组',
syncedAt: '2026-11-12 09:00:00',
},
{ id: 'not-a-number', title: '缺 id 弃行' },
{ shop_name: 'snake 行也缺 id,弃' },
],
total: 1,
page: 1,
page_size: 20,
},
})
assert.equal(page.items.length, 1, '三条原始行里两条缺有效 id,只留 1 行')
const row = page.items[0]
assert.equal(row.shopName, '旗舰自营店')
assert.equal(row.groupId, 7)
assert.equal(row.groupName, '甲组')
// 2026-11-16 价格改走 decimalText(数值/字符串都收)后同口径去尾零,与详情 SKU 价一致。
assert.equal(jdPriceRange(row), '12.9 ~ 15.9', 'min/max 都有给区间(去尾零)')
assert.equal(jdPriceRange({ priceMin: '12.90', priceMax: '' }), '12.9', '只空一侧给单值')
assert.equal(jdPriceRange({ priceMin: '', priceMax: '' }), '', '全空为空串(界面展示 -)')
// snake 行同口径 + 缺省回默认。
const snakePage = parseJdProductPage({ data: { items: [{ id: 9, shop_name: 'B店', main_image_url: 'https://img/x.jpg' }], total: 1, page: 2, page_size: 5 } })
const snakeRow = toJdProductItem({ id: 9, shop_name: 'B店', main_image_url: 'https://img/x.jpg' })
assert.equal(snakeRow?.mainImageUrl, 'https://img/x.jpg')
assert.equal(snakePage.pageSize, 5)
})