/** * 外观专利无侵权数据页筛选纯函数(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) { assert.equal((list as Record)[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' }, ), {}, '脏值不下发,与列表参数归一规则逐字同源', ) })