/** * 服务端分页 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') }) })