Files
crawler-plugin/frontend-vue/tests/mount/server-table-paging.mount.test.ts
huangzd1997 0586df2df0 feat(phase-4): AC-16/17/18 前端登录态与分片上传、后管包体与竞态门
AC-16(S1-F1/S1-F2)
- frontend-vue ensureAuth:清态前先判 isAuthError——弱网/超时/5xx 不再把人踢回登录页;
  http.ts 的 onResponseRejected 给错误打鉴权标记(HTTP 401 与业务 401/4011 都算),
  纯网络错误保留底层文案供调用方区分"断网"与"掉登录";clearLocalSession 导出复用。
- admin 全局错误兜底:main.ts 装 app.config.errorHandler(首屏就崩也接得住),
  window error / unhandledrejection 由 App.vue setup 调 useGlobalErrorReporting() 接线,
  卸载出口在 onBeforeUnmount 摘监听与提示定时器(后管的 timer-cleanup-pairing 尺子要求
  "注册点所在文件找得回反注册 + 卸载钩子",故接线必须在组件作用域,不在 main.ts)。
  上报体只带 kind/message/stack/route/ts 并过脱敏(Bearer、JWT 三段式、query 里疑似
  token/key/secret 的取值一律打码),凭据零容忍;服务端新增
  /api/admin/client-errors(requireAdmin,字段截断 2000 后 WARN 落日志,不落库)。

AC-17(S1-F3)
- 后端新增分片通道 ChunkedUploadService(init/part/status/complete/abort):8MB/片、
  同片重复上传幂等覆盖、流式拼装复算 sha256、超限与缺片直接拒绝、24h 过期回收;
  FileUploadController 暴露 /api/files/chunk/**,LocalFileStorageService 加
  saveTempFileFromFile(同一套扩展名黑名单与 fileKey 索引);三键显式写进 application.yml
  (不进"只在代码默认值里"的名单)。
- 工作台安装包 93MB:WorkbenchClientPackageService 走同一分片通道转存 client 桶
  (objectKey 写进会话 purpose,拼装时逐字匹配,防借分片接口覆盖已发布包),
  confirm 失败带 cleanupUnconfirmedObject 补偿清理未登记对象;后管 ≤64MB 仍直传预签名 PUT。
- 用户端 upload.ts:大文件分片 + 逐片重试 + 进度回调,超时按体积给(不再固定 120s);
  断点探测失败不再静默按"全缺"重传(catch-silence 棘轮因此一格没涨,blocks 300→301 已记名)。

AC-18(P1-F1/P1-F2/P1-F4/S1-F4)
- 后管 manualChunks 摘掉 element-plus(按需引入已在 src/plugins/element.ts 生效):
  实测构建产物已无 element-plus 独立 chunk,index.html 只 modulepreload vue 块。
- UsersPage/DeviceLogsPage 接 createLatestRequestGate,旧响应不再覆盖新页;
  用户端新增 useServerTablePaging(只驻留当前页 + 自带竞态门 + 失败给原因),
  挂载用例 3 例钉住"翻页重取/旧响应作废/失败可见"。
- DeliveryVideoWorkspace 两处轮询接 document.visibilityState,隐藏标签页暂停。

激活 Phase 0 预置契约 7 例(用户端 5 + 后管 5,共 12 例;其中 AC-16 后管两支按"接线在组件作用域"
的口径改写并把判据加强到反注册配对 + 根组件接线,见蓝图 §5)。
门禁读数:后端 mvn -o test-compile rc=0,CatchSilenceRatchetTest 9 例绿(total 1034→1045、
notRethrow 585→591、logOnly 182→188 逐处记名,EMPTY 未涨)、ChunkedUploadServiceTest 8 例、
WorkbenchClientPackageServiceTest 21 例、ClientErrorReportControllerTest 4 例;后管 1848 例 +
mount 33 例 + vue-tsc + build 全绿;用户端 955 例 + mount 30 例 + vue-tsc + build 全绿。
真机:OssWorkbenchClientLiveVerificationTest 以线上 MinIO 实测 PUT→stat→sha256→presign→删除
全链 1 例绿(凭据只走环境变量,不落任何文件)。

⚠ 按 pathspec 只圈本轮文件:application.yml 用索引手术只提交分片三键那一格,他人
「PENDING 不再按 2 小时判死」的 StaleTaskRepairService/ClientTaskPullSpi/application.yml
注释件与 useLiveTaskBoard/BrandAppearancePatentTab/task-delete-target 四件在飞改动
原样留在工作树未提交。
2026-10-29 13:47:21 +08:00

96 lines
3.8 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 服务端分页 composable 的挂载用例(AC-18/P1-F2)。
*
* 钉三件事,缺一条就是假绿:
* ① 只驻留当前页——组件内存里永远只有 fetchPage 交回来的那一页,不是整份数据;
* ② 翻页真的重取——page 变化必须再打一次后端(fetchPage 带上新页码),不是本地切片;
* ③ 旧响应不许盖新页——快速翻页时先发的请求后返回,回写必须被 latest-request 门丢掉
* (这正是 S1-F4 在服务端分页形态下的等价物)。
*
* 跑法:cd frontend-vue && npx vitest run tests/mount/server-table-paging.mount.test.ts
*/
import { describe, expect, it, vi } from 'vitest'
import { flushPromises, mount } from '@vue/test-utils'
import { defineComponent, h, nextTick } from 'vue'
import { useServerTablePaging } from '@/shared/composables/useTablePaging'
const Harness = defineComponent({
props: {
fetchPage: { type: Function, required: true },
},
setup(props) {
const paging = useServerTablePaging(props.fetchPage as never, 2)
return { paging }
},
render() {
return h('div', [
h('span', { 'data-test': 'rows' }, String(this.paging.rows.value.length)),
h('span', { 'data-test': 'total' }, String(this.paging.total.value)),
h('span', { 'data-test': 'page' }, String(this.paging.page.value)),
h('span', { 'data-test': 'error' }, this.paging.error.value),
])
},
})
describe('useServerTablePaging', () => {
it('只驻留当前页,翻页按新页码重取', async () => {
const fetchPage = vi.fn(async ({ page, pageSize }) => ({
items: page === 1
? [{ id: 'a' }, { id: 'b' }]
: [{ id: `p${page}-${pageSize}` }],
total: 5,
}))
const wrapper = mount(Harness, { props: { fetchPage } })
await flushPromises()
expect(wrapper.get('[data-test=rows]').text()).toBe('2')
expect(wrapper.get('[data-test=total]').text()).toBe('5')
expect(fetchPage).toHaveBeenCalledTimes(1)
expect(fetchPage).toHaveBeenLastCalledWith({ page: 1, pageSize: 2 })
wrapper.vm.paging.page.value = 3
await flushPromises()
await nextTick()
expect(fetchPage).toHaveBeenCalledTimes(2)
expect(fetchPage).toHaveBeenLastCalledWith({ page: 3, pageSize: 2 })
// 第二页只有 1 行(第 5 条)——数据源里从不出现整份 5 行
expect(wrapper.get('[data-test=rows]').text()).toBe('1')
})
it('旧请求晚到不得覆盖新页(竞态门)', async () => {
let firstResolve: (v: { items: { id: string }[]; total: number }) => void = () => undefined
const fetchPage = vi.fn((params: { page: number }) => {
if (params.page === 1) {
return new Promise<{ items: { id: string }[]; total: number }>((resolve) => {
firstResolve = resolve
})
}
return Promise.resolve({ items: [{ id: 'fresh' }], total: 3 })
})
const wrapper = mount(Harness, { props: { fetchPage } })
await nextTick()
// 第一页请求仍在飞时立刻翻到第二页:第二页先返回并落地
wrapper.vm.paging.page.value = 2
await flushPromises()
expect(wrapper.get('[data-test=rows]').text()).toBe('1')
// 迟到的第一页响应(2 行)绝不能盖掉当前页
firstResolve({ items: [{ id: 'stale-1' }, { id: 'stale-2' }], total: 99 })
await flushPromises()
expect(wrapper.get('[data-test=rows]').text()).toBe('1')
expect(wrapper.get('[data-test=total]').text()).toBe('3')
})
it('取数失败把原因说出来,不静默空表', async () => {
const fetchPage = vi.fn(async () => { throw new Error('后端 503') })
const wrapper = mount(Harness, { props: { fetchPage } })
await flushPromises()
expect(wrapper.get('[data-test=error]').text()).toBe('后端 503')
expect(wrapper.get('[data-test=rows]').text()).toBe('0')
})
})