Files
knowledge-governance/web/src/versionHistory.test.ts
T
姚章浩 30686dd288
build / build (push) Successful in 1m21s
fix(ui): 版本记录错误详情复用已解析响应体,不再二次读 Body
父复核发现的确定缺陷:fetchVersionHistory 在 130 行已 await response.json(),
错误分支又读一次,真实 Response 抛 TypeError(Body already read),被 catch 吞掉,
用户仍只看到状态码。

改为复用已解析的 value(error/code);同时把 code 从错误分支里重复声明去掉。
测试用真实 Response 构造 500:伪 mock 可重复 json() 会把 double-read 掩盖成绿。
2026-11-01 19:59:28 +08:00

158 lines
5.8 KiB
TypeScript

import { afterEach, describe, expect, it, vi } from 'vitest'
import { fetchBuildInfo, fetchVersionHistory, reasonLabel, syncVersionHistory } from './versionHistory'
const jsonResponse = (body: unknown, status = 200) =>
Promise.resolve({ ok: status >= 200 && status < 300, status, json: () => Promise.resolve(body) } as Response)
afterEach(() => vi.unstubAllGlobals())
// 用真实 Response(Node 全局):正文只能读一次,重复 json() 必然抛 TypeError。
// 依赖"可重复 json()"的伪 mock 会把 double-read 的 bug 掩盖成绿。
const realResponse = (body: unknown, status: number) =>
new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } })
const pageBody = {
items: [
{
commit_sha: 'a'.repeat(40),
short_sha: 'aaaaaaaaaaaa',
parents: [],
committed_at: '2026-10-13T10:00:00Z',
author_display: '姚章浩',
subject: 'feat: 甲',
body: '正文',
record_kind: 'development',
version_label: '0.1.2',
version_state: 'verified',
release_tags: [],
release_notes: '',
commit_url: 'https://gitea.example/commit/aaa',
version_reason: 'counted_commits_since_base_tag',
is_current_running: false,
},
],
next_cursor: 'next-cursor',
has_more: true,
sync: {
available: true,
status: 'completed',
complete: true,
last_success_at: '2026-10-13T12:00:00Z',
fetched_count: 111,
expected_count: 111,
error_code: '',
source_head_sha: 'a'.repeat(40),
active_snapshot_id: 3,
repo: 'Weknora/knowledge-governance',
},
current_running: {
state: 'development',
commit_sha: 'b'.repeat(40),
display_version: '0.1.2',
matched_commit_sha: '',
},
}
describe('fetchVersionHistory 服务端错误详情', () => {
it('500 时把服务端的 error 与 code 带进异常消息(真实 Response,正文只能读一次)', async () => {
const errBody = { error: '读取版本记录失败', code: 'version_history_unavailable' }
const fetchMock = vi.fn(() => Promise.resolve(realResponse(errBody, 500)))
vi.stubGlobal('fetch', fetchMock)
await expect(fetchVersionHistory({ kind: 'all', cursor: '' })).rejects.toThrow(
/HTTP 500.*读取版本记录失败.*version_history_unavailable/s
)
expect(fetchMock).toHaveBeenCalledOnce()
})
})
describe('versionHistory client', () => {
it('loads a page, keeps the cursor and reads sync/current-running facts', async () => {
const fetchMock = vi.fn((_input: RequestInfo | URL, _init?: RequestInit) => jsonResponse(pageBody))
vi.stubGlobal('fetch', fetchMock)
const page = await fetchVersionHistory({ kind: 'all', cursor: '' })
expect(fetchMock).toHaveBeenCalledOnce()
const url = String(fetchMock.mock.calls[0][0])
expect(url).toContain('/api/v1/version-history?')
expect(url).not.toContain('kind=all')
expect(url).toContain('limit=30')
expect(page.items[0].version_label).toBe('0.1.2')
expect(page.next_cursor).toBe('next-cursor')
expect(page.has_more).toBe(true)
expect(page.sync.expected_count).toBe(111)
expect(page.current_running.state).toBe('development')
})
it('passes the kind filter and cursor through', async () => {
const fetchMock = vi.fn((_input: RequestInfo | URL, _init?: RequestInit) =>
jsonResponse({ ...pageBody, items: [], has_more: false })
)
vi.stubGlobal('fetch', fetchMock)
await fetchVersionHistory({ kind: 'historical', cursor: 'c-1', limit: 50 })
const url = String(fetchMock.mock.calls[0][0])
expect(url).toContain('kind=historical')
expect(url).toContain('cursor=c-1')
expect(url).toContain('limit=50')
})
it('explains an expired cursor instead of showing a raw error', async () => {
vi.stubGlobal(
'fetch',
vi.fn(() => jsonResponse({ code: 'cursor_expired' }, 409))
)
await expect(fetchVersionHistory({ kind: 'all', cursor: 'stale' })).rejects.toThrow('已被清理')
})
it('rejects malformed payloads instead of rendering half-truths', async () => {
vi.stubGlobal(
'fetch',
vi.fn(() => jsonResponse({ items: 'nope' }))
)
await expect(fetchVersionHistory({ kind: 'all', cursor: '' })).rejects.toThrow('响应无效')
})
it('posts the sync request and reports reuse', async () => {
const fetchMock = vi.fn((_input: RequestInfo | URL, _init?: RequestInit) =>
jsonResponse({ job_id: 'job-1', status: 'running', reused: true })
)
vi.stubGlobal('fetch', fetchMock)
const accepted = await syncVersionHistory()
expect(String(fetchMock.mock.calls[0][0])).toBe('/api/v1/version-history/sync')
expect(fetchMock.mock.calls[0][1]).toMatchObject({ method: 'POST' })
expect(accepted.reused).toBe(true)
})
it('says admin-only when the sync is refused', async () => {
vi.stubGlobal(
'fetch',
vi.fn(() => jsonResponse({ code: 'forbidden_role' }, 403))
)
await expect(syncVersionHistory()).rejects.toThrow('只有管理员')
})
it('never fabricates a build identity when injection is missing', async () => {
vi.stubGlobal(
'fetch',
vi.fn(() =>
jsonResponse({
release_version: '',
build_kind: 'development',
commit_sha: null,
display_version: 'dev',
built_at: '',
identity_available: false,
})
)
)
const info = await fetchBuildInfo()
expect(info.commit_sha).toBeNull()
expect(info.identity_available).toBe(false)
})
it('maps every evidence reason to a human explanation', () => {
expect(reasonLabel('lightweight_tag')).toContain('轻量 tag')
expect(reasonLabel('no_baseline')).toContain('发布基线')
expect(reasonLabel('shallow_or_incomplete_graph')).toContain('提交图不完整')
expect(reasonLabel('something_new')).toBe('版本号未能核验')
})
})