115 lines
5.5 KiB
TypeScript
115 lines
5.5 KiB
TypeScript
import { test } from 'node:test'
|
|
import assert from 'node:assert/strict'
|
|
|
|
import {
|
|
classifyTargetVersion,
|
|
describeTargetVersion,
|
|
parseVersionList,
|
|
pickDefaultVersion,
|
|
} from '../src/shared/utils/version-picker.ts'
|
|
|
|
/** /api/version/list 响应样例:接口按 created_at DESC 返回(旧版本重传会排最前) */
|
|
function listResponse(items: Array<Record<string, unknown>>) {
|
|
return { items }
|
|
}
|
|
|
|
test('版本列表解析:同一版本重复上传只保留先出现(最新)的一条记录', () => {
|
|
const items = parseVersionList(listResponse([
|
|
{ id: 9, version: '4.0.13', file_url: 'https://oss/4.0.13-new.zip', created_at: '2026-09-14 10:00' },
|
|
{ id: 5, version: '4.0.14', file_url: 'https://oss/4.0.14.zip', created_at: '2026-09-14 09:00' },
|
|
{ id: 2, version: '4.0.13', file_url: 'https://oss/4.0.13-old.zip', created_at: '2026-09-13 10:00' },
|
|
]))
|
|
assert.equal(items.length, 2)
|
|
const reuploaded = items.find((item) => item.version === '4.0.13')
|
|
assert.equal(reuploaded?.fileUrl, 'https://oss/4.0.13-new.zip', '同版本应取最新上传的包')
|
|
})
|
|
|
|
test('版本列表解析:无下载地址或空版本号的行被丢弃(选了也装不了)', () => {
|
|
const items = parseVersionList(listResponse([
|
|
{ id: 1, version: '4.0.14', file_url: 'https://oss/4.0.14.zip', created_at: '2026-09-14 10:36' },
|
|
{ id: 2, version: '4.0.13', file_url: '', created_at: '2026-09-13 20:00' },
|
|
{ id: 3, version: ' ', file_url: 'https://oss/blank.zip', created_at: '2026-09-13 19:00' },
|
|
{ id: 4, version: null, file_url: 'https://oss/null.zip', created_at: '2026-09-13 18:00' },
|
|
null,
|
|
'not-an-object',
|
|
]))
|
|
assert.deepEqual(items.map((item) => item.version), ['4.0.14'])
|
|
})
|
|
|
|
test('版本列表解析:按版本号从高到低排序,旧版本重传不会排到最前', () => {
|
|
const items = parseVersionList(listResponse([
|
|
// 旧版本刚重传:created_at 最新,但版本号最低
|
|
{ id: 30, version: '4.0.9', file_url: 'https://oss/4.0.9.zip', created_at: '2026-09-14 11:00' },
|
|
{ id: 29, version: '4.0.14', file_url: 'https://oss/4.0.14.zip', created_at: '2026-09-14 10:00' },
|
|
{ id: 28, version: '4.0.13', file_url: 'https://oss/4.0.13.zip', created_at: '2026-09-13 20:00' },
|
|
]))
|
|
assert.deepEqual(items.map((item) => item.version), ['4.0.14', '4.0.13', '4.0.9'])
|
|
})
|
|
|
|
test('版本列表解析:兼容驼峰字段、v 前缀与空/异常响应', () => {
|
|
const items = parseVersionList(listResponse([
|
|
{ id: 1, version: 'v4.0.14', fileUrl: 'https://oss/4.0.14.zip', createdAt: '2026-09-14 10:36' },
|
|
]))
|
|
assert.deepEqual(items, [
|
|
{ id: 1, version: '4.0.14', fileUrl: 'https://oss/4.0.14.zip', createdAt: '2026-09-14 10:36' },
|
|
])
|
|
assert.deepEqual(parseVersionList(null), [])
|
|
assert.deepEqual(parseVersionList({}), [])
|
|
assert.deepEqual(parseVersionList({ items: 'oops' }), [])
|
|
})
|
|
|
|
test('目标版本判定:高于本机=更新,相等=同版,低于本机=回退', () => {
|
|
assert.equal(classifyTargetVersion('4.0.12', '4.0.14'), 'newer')
|
|
assert.equal(classifyTargetVersion('4.0.14', '4.0.14'), 'same')
|
|
assert.equal(classifyTargetVersion('4.0.14', '4.0.13'), 'older')
|
|
// 多段补零后仍相等
|
|
assert.equal(classifyTargetVersion('4.0.14', '4.0.14.0'), 'same')
|
|
})
|
|
|
|
test('目标版本判定:本机版本未知时返回 unknown,不误判为升级', () => {
|
|
assert.equal(classifyTargetVersion('', '4.0.14'), 'unknown')
|
|
assert.equal(classifyTargetVersion(undefined as unknown as string, '4.0.14'), 'unknown')
|
|
assert.equal(classifyTargetVersion('4.0.14', ''), 'unknown')
|
|
})
|
|
|
|
test('回退文案必须写明低于当前版本(回退是显式操作,不得静默降级)', () => {
|
|
const text = describeTargetVersion('older', '4.0.14', '4.0.13')
|
|
assert.ok(text.includes('4.0.13'), '文案要带目标版本号')
|
|
assert.ok(text.includes('低于当前版本'), '回退必须明确提示低于本机版本')
|
|
assert.ok(text.includes('4.0.14'), '文案要带本机版本号')
|
|
})
|
|
|
|
test('同版与更新文案各自说明动作,本机版本未知时如实说明无法比较', () => {
|
|
assert.ok(describeTargetVersion('same', '4.0.14', '4.0.14').includes('与当前版本相同'))
|
|
const newer = describeTargetVersion('newer', '4.0.12', '4.0.14')
|
|
assert.ok(newer.includes('4.0.12') && newer.includes('4.0.14'))
|
|
assert.ok(describeTargetVersion('unknown', '', '4.0.14').includes('未读到本机版本'))
|
|
})
|
|
|
|
const versionList = parseVersionList(listResponse([
|
|
{ id: 3, version: '4.0.14', file_url: 'https://oss/4.0.14.zip', created_at: '2026-09-14 10:00' },
|
|
{ id: 2, version: '4.0.13', file_url: 'https://oss/4.0.13.zip', created_at: '2026-09-13 10:00' },
|
|
]))
|
|
|
|
test('默认选中:只有确实存在更新版本时才默认选中最新版', () => {
|
|
assert.equal(pickDefaultVersion('4.0.12', versionList), '4.0.14')
|
|
})
|
|
|
|
test('默认选中:本机已是最新版时不默认选中(不出现"更新到此版本"按钮)', () => {
|
|
assert.equal(pickDefaultVersion('4.0.14', versionList), '')
|
|
// 多段补零后仍是同版
|
|
assert.equal(pickDefaultVersion('4.0.14.0', versionList), '')
|
|
})
|
|
|
|
test('默认选中:本机版本高于线上(回滚过/灰度)时也不默认选中,避免把用户往低版本引导', () => {
|
|
assert.equal(pickDefaultVersion('4.0.15', versionList), '')
|
|
})
|
|
|
|
test('默认选中:本机版本读不到(旧客户端无版本桥)时仍默认选最新版,可一键安装', () => {
|
|
assert.equal(pickDefaultVersion('', versionList), '4.0.14')
|
|
})
|
|
|
|
test('默认选中:版本列表为空时不出默认目标', () => {
|
|
assert.equal(pickDefaultVersion('4.0.12', []), '')
|
|
})
|