100 lines
4.9 KiB
TypeScript
100 lines
4.9 KiB
TypeScript
/**
|
||
* 外观专利无侵权数据页筛选纯函数(v1.3 AC-5)—— Phase 3 激活。
|
||
*
|
||
* 1. **snake 参数形状**:toAppearancePatentCleanListParams({...}) 产出
|
||
* `page`/`page_size`(默认 10、上限 100)、`task_id`、`asin`、`country`、
|
||
* `start_date`/`end_date`(ISO yyyy-MM-dd;空白不下发)——与后端 §3.2 参数归一逐字对撞;
|
||
* 2. **分页钳制**(铁律 15):page < 1 归 1;page_size 上限 100;
|
||
* `(page-1)*page_size` 溢出边界样本(page 极大值不得把乘积顶成负数/溢出)。
|
||
*
|
||
* 跑法:`node --test tests/appearance-patent-clean-filter.test.ts`(node --test 只收顶层
|
||
* `tests/*.test.ts`,不递归;纯函数零依赖可直测)
|
||
*/
|
||
import { test } from 'node:test'
|
||
import assert from 'node:assert/strict'
|
||
|
||
import {
|
||
APPEARANCE_PATENT_CLEAN_MAX_PAGE,
|
||
createAppearancePatentCleanFilterState,
|
||
toAppearancePatentCleanExportParams,
|
||
toAppearancePatentCleanListParams,
|
||
} from '../src/pages/patent/appearance-patent-clean-filter.ts'
|
||
|
||
test('AC-5 筛选参数——snake page/page_size/task_id/asin/country/group_id/start_date/end_date 形状', () => {
|
||
const full = toAppearancePatentCleanListParams(
|
||
{ taskId: '33179', asin: ' B0AB8CDEF9 ', country: 'DE', groupId: ' 7 ', startDate: '2026-11-01', endDate: '2026-11-09' },
|
||
2,
|
||
20,
|
||
)
|
||
// snake 逐字对撞后端 §3.2;ASIN 前后空白被构造器剥掉(后端服务侧再 trim 一次是双保险)。
|
||
// 分组(主管=组长,2026-11-11 客户口径「就是分组」):group_id 下发,选中行是分组管理里那一行。
|
||
assert.deepEqual(full, {
|
||
page: 2,
|
||
page_size: 20,
|
||
task_id: 33179,
|
||
asin: 'B0AB8CDEF9',
|
||
country: 'DE',
|
||
group_id: 7,
|
||
start_date: '2026-11-01',
|
||
end_date: '2026-11-09',
|
||
})
|
||
|
||
// 空白/非法值不下发:全空态只有分页两项;非法日期与空串同罪。
|
||
const blank = toAppearancePatentCleanListParams(createAppearancePatentCleanFilterState(), 1, 10)
|
||
assert.deepEqual(blank, { page: 1, page_size: 10 })
|
||
const dirty = toAppearancePatentCleanListParams(
|
||
{ taskId: 'abc', asin: ' ', country: '', groupId: 'abc', startDate: '2026/11/01', endDate: 'not-a-date' },
|
||
1,
|
||
10,
|
||
)
|
||
assert.deepEqual(dirty, { page: 1, page_size: 10 })
|
||
assert.equal('task_id' in dirty, false, '非数字任务号不下发')
|
||
assert.equal('group_id' in dirty, false, '非数字分组 id 不下发')
|
||
assert.equal('start_date' in dirty, false, '非法日期不下发')
|
||
})
|
||
|
||
test('AC-5 筛选参数——page 钳制防 (page-1)*page_size 溢出(铁律 15)', () => {
|
||
// page < 1 归 1;page_size 下限 1、默认 10、上限 100。
|
||
const low = toAppearancePatentCleanListParams(createAppearancePatentCleanFilterState(), 0, 0)
|
||
assert.equal(low.page, 1, 'page<1 归 1')
|
||
assert.equal(low.page_size, 10, 'page_size 非法回默认 10')
|
||
const big = toAppearancePatentCleanListParams(createAppearancePatentCleanFilterState(), 3, 500)
|
||
assert.equal(big.page_size, 100, 'page_size 上限 100')
|
||
|
||
// 溢出边界:page 极大值钳到 10_000(与后端 MAX_PAGE 同值),乘积 999_900 必须还是安全整数——
|
||
// 不钳的话 (Number.MAX_SAFE_INTEGER-1)*100 直接顶出安全整数域,翻页偏移就不再可靠。
|
||
const extreme = toAppearancePatentCleanListParams(createAppearancePatentCleanFilterState(), Number.MAX_SAFE_INTEGER, 100)
|
||
assert.equal(extreme.page, APPEARANCE_PATENT_CLEAN_MAX_PAGE)
|
||
const offset = (extreme.page - 1) * extreme.page_size
|
||
assert.equal(Number.isSafeInteger(offset), true, `(page-1)*page_size=${offset} 必须留在安全整数域`)
|
||
assert.equal(offset, 999_900)
|
||
})
|
||
|
||
test('导出参数——与列表同一过滤面单出口(无分页,空白/非法值不下发)', () => {
|
||
// 同一过滤态下导出与列表的过滤面字段逐字同源(防「页签筛了公司、导出全量」的两处各算各的)。
|
||
const state = { taskId: '33179', asin: ' B0AB8CDEF9 ', country: 'de', groupId: '7', startDate: '2026-11-01', endDate: '' }
|
||
const list = toAppearancePatentCleanListParams(state, 3, 20)
|
||
const exp = toAppearancePatentCleanExportParams(state)
|
||
for (const key of Object.keys(exp) as Array<keyof typeof exp>) {
|
||
assert.equal((list as Record<string, unknown>)[key], exp[key], `导出与列表的 ${key} 必须同源`)
|
||
}
|
||
assert.equal('page' in exp, false, '导出参数无分页(全量导出由服务侧上限兜住)')
|
||
assert.deepEqual(exp, {
|
||
task_id: 33179,
|
||
asin: 'B0AB8CDEF9',
|
||
country: 'de',
|
||
group_id: 7,
|
||
start_date: '2026-11-01',
|
||
})
|
||
|
||
// 全空态零字段;非法日期与非数字任务号/分组同列表口径不下发。
|
||
assert.deepEqual(toAppearancePatentCleanExportParams(createAppearancePatentCleanFilterState()), {})
|
||
assert.deepEqual(
|
||
toAppearancePatentCleanExportParams(
|
||
{ taskId: 'abc', asin: ' ', country: '', groupId: 'abc', startDate: '2026/11/01', endDate: 'not-a-date' },
|
||
),
|
||
{},
|
||
'脏值不下发,与列表参数归一规则逐字同源',
|
||
)
|
||
})
|