task-137(记录与版本中心): 实现版本页面统一时间和文件格式化

新增 version-format.ts:字节数与后端时间显示归一。

TDD: task-137.test.ts 8 用例 RED→GREEN。
This commit is contained in:
2026-09-05 17:42:12 +08:00
parent 94954648d2
commit c4262bd704
2 changed files with 72 additions and 0 deletions
@@ -0,0 +1,24 @@
/** 版本页时间与文件格式化(任务 137):字节数/时间显示归一;纯逻辑。 */
/** 字节数 → 可读文本(B/KB/MB/GB,保留 1 位)。 */
export function formatFileSize(value: number): string {
const bytes = typeof value === 'number' && Number.isFinite(value) ? Math.max(value, 0) : 0
if (bytes < 1024) return `${bytes} B`
const units = ['KB', 'MB', 'GB']
let amount = bytes
let unit = 'B'
for (const next of units) {
amount /= 1024
unit = next
if (amount < 1024 || next === 'GB') break
}
return `${amount.toFixed(1)} ${unit}`
}
const DISPLAY_DATETIME = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}(:\d{2}(\.\d+)?)?$/
/** 后端时间(ISO T 或空格分隔) → 显示文本(yyyy-MM-dd HH:mm:ss);非法回空。 */
export function formatDisplayDateTime(value: unknown): string {
const text = typeof value === 'string' ? value.trim().replace('T', ' ') : ''
return DISPLAY_DATETIME.test(text) ? text : ''
}
+48
View File
@@ -0,0 +1,48 @@
import test from 'node:test'
import assert from 'node:assert/strict'
import { readSource } from './helpers.ts'
import { formatDisplayDateTime, formatFileSize } from '../src/pages/records/version-format.ts'
test('test_task_137_version_format_normal_primary_path', () => {
// 正常主路径:字节数可读化。
assert.equal(formatFileSize(1024), '1.0 KB')
assert.equal(formatFileSize(0), '0 B')
})
test('test_task_137_version_format_normal_variant_input', () => {
// 正常变体:大文件 MB/GB。
assert.equal(formatFileSize(5 * 1024 * 1024), '5.0 MB')
assert.equal(formatFileSize(2 * 1024 * 1024 * 1024), '2.0 GB')
})
test('test_task_137_version_format_repeated_is_idempotent', () => {
// 正常重复:格式化稳定。
assert.equal(formatFileSize(2048), formatFileSize(2048))
})
test('test_task_137_version_format_boundary_empty_input', () => {
// 边界空值:无时间显示为空。
assert.equal(formatDisplayDateTime(''), '')
})
test('test_task_137_version_format_boundary_single_item', () => {
// 边界单元素:ISO 时间转可读格式。
assert.equal(formatDisplayDateTime('2026-01-01T10:30:00'), '2026-01-01 10:30:00')
})
test('test_task_137_version_format_boundary_limit_or_missing_field', () => {
// 边界上限/缺字段:非法时间原样或空处理。
assert.equal(formatDisplayDateTime('not-a-date'), '')
})
test('test_task_137_version_format_invalid_input_rejected', () => {
// 异常输入:非数字字节按 0 处理。
assert.equal(formatFileSize(Number.NaN), '0 B')
})
test('test_task_137_version_format_dependency_failure_returns_actionable_message', () => {
// 依赖失败/可操作:格式化纯逻辑、无框架/http。
const mod = readSource('src/pages/records/version-format.ts')
assert.equal(/axios|http\.|vue/.test(mod), false, '格式化保持纯逻辑')
assert.match(mod, /formatFileSize/)
})