import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
import { flushPromises, mount } from '@vue/test-utils'
import ElementPlus from 'element-plus'
import { createMemoryHistory, createRouter } from 'vue-router'
import Welcome from '@/components/Welcome.vue'
import { getReviewFeed, getReviewTaskStats } from '@/api/review'
import { updateFragmentOwnership } from '@/api/reportFragments'
import appRouter from '@/router'
import { BASE_SPEED_PX_PER_SEC, NARROW_SPEED_FACTOR } from '@/utils/autoScroll'
vi.mock('@/api/review', () => ({
getReviewFeed: vi.fn(),
getReviewTaskStats: vi.fn(),
getTaskReview: vi.fn(),
}))
vi.mock('@/api/reportFragments', () => ({
updateFragmentOwnership: vi.fn(),
}))
const makeFragment = (id: number) => ({
id,
contextNum: `SESSION_${id}`,
contextType: 'SESSION',
taskName: `任务${id}`,
taskNum: `T${id}`,
sourceType: 'FRAGMENT',
content: `残片内容${id}`,
createdTime: '2026-01-01 10:00:00',
pendingOwnership: false,
})
const router = createRouter({
history: createMemoryHistory(),
routes: [
{ path: '/', component: { template: '
' } },
{ path: '/welcome', component: { template: '' } },
{ path: '/study', component: { template: '' } },
{ path: '/review', component: { template: '' } },
],
})
/** jsdom 不实现 Web Animations API,用可控桩替代 */
interface AnimStub {
keyframes: unknown
options: { duration: number; iterations: number; easing: string }
currentTime: number
paused: boolean
cancel: ReturnType
pause: ReturnType
play: ReturnType
}
let animations: AnimStub[] = []
let animateSpy: ReturnType
/**
* jsdom 不做布局,用宽度桩模拟渲染结果:
* scrollWidth = 单份内容宽 × 当前已渲染份数(由 DOM 里的 chip 数量推得),
* clientWidth = 轨道宽度。
*/
const stubLayout = (perCopyWidth: number, trackWidth: number) => {
Object.defineProperty(HTMLElement.prototype, 'scrollWidth', {
configurable: true,
get(this: HTMLElement) {
if (!this.classList?.contains('review-scroll-content')) return 0
const renderedChips = this.querySelectorAll('.review-chip').length
return perCopyWidth * (renderedChips / SOURCE_CHIP_COUNT)
},
})
Object.defineProperty(HTMLElement.prototype, 'clientWidth', {
configurable: true,
get(this: HTMLElement) {
return this.classList?.contains('review-scroll-track') ? trackWidth : 0
},
})
}
/** mock 数据里的残留条数,用于把“份数”换算回“条数” */
const SOURCE_CHIP_COUNT = 2
/** 从渲染结果反推当前份数 */
const renderedRepeatCount = (wrapper: { findAll: (s: string) => unknown[] }) =>
wrapper.findAll('.review-chip').length / SOURCE_CHIP_COUNT
const mountWelcome = async () => {
const wrapper = mount(Welcome, { global: { plugins: [router, ElementPlus] } })
await flushPromises()
return wrapper
}
beforeEach(() => {
animations = []
animateSpy = vi.fn((keyframes: unknown, options: AnimStub['options']) => {
const anim: AnimStub = {
keyframes,
options,
currentTime: 0,
paused: false,
cancel: vi.fn(),
pause: vi.fn(function (this: AnimStub) { this.paused = true }),
play: vi.fn(function (this: AnimStub) { this.paused = false }),
}
animations.push(anim)
return anim as unknown as Animation
})
Element.prototype.animate = animateSpy as unknown as Element['animate']
vi.mocked(getReviewFeed).mockResolvedValue({ code: 200, data: [makeFragment(1), makeFragment(2)] })
})
afterEach(() => {
// @ts-expect-error 清理原型上的自定义布局桩
delete HTMLElement.prototype.scrollWidth
// @ts-expect-error 清理原型上的自定义布局桩
delete HTMLElement.prototype.clientWidth
})
describe('Welcome 首页滚动条', () => {
it('内容超过一屏时按基准速度建立动画,时长由恒速换算', async () => {
stubLayout(4000, 1000) // 单份 4000px,60px/s → 66666ms
await mountWelcome()
expect(animateSpy).toHaveBeenCalledTimes(1)
const options = animations[0].options
expect(options.iterations).toBe(Infinity)
expect(options.easing).toBe('linear')
expect(options.duration).toBeCloseTo((4000 / BASE_SPEED_PX_PER_SEC) * 1000)
})
it('速度与内容量无关:内容翻倍只让时长翻倍', async () => {
stubLayout(4000, 1000)
await mountWelcome()
const few = animations[0].options.duration
animations = []
animateSpy.mockClear()
stubLayout(40000, 1000)
await mountWelcome()
const many = animations[0].options.duration
expect(many / few).toBeCloseTo(10)
})
it('内容不足一屏时仍然滚动,且按单份宽度换算时长', async () => {
stubLayout(300, 1000) // 单份 300px,远小于轨道
await mountWelcome()
expect(animateSpy).toHaveBeenCalled()
expect(animations[animations.length - 1].options.duration)
.toBeCloseTo((300 / BASE_SPEED_PX_PER_SEC) * 1000)
})
it('内容比轨道窄时补足份数后重建动画,避免循环露白', async () => {
stubLayout(300, 1000) // 单份 300px、轨道 1000px → ceil(1000/300)+1 = 5 份
const wrapper = await mountWelcome()
expect(renderedRepeatCount(wrapper)).toBe(5)
expect(animateSpy).toHaveBeenCalledTimes(1)
// 位移按份数换算:100% / 5 = 20%
expect(animations[0].keyframes).toEqual([
{ transform: 'translateX(0)' },
{ transform: 'translateX(-20%)' },
])
})
it('内容足够宽时保持最少两份,不会反复重建', async () => {
stubLayout(4000, 1000)
const wrapper = await mountWelcome()
expect(renderedRepeatCount(wrapper)).toBe(2)
expect(animateSpy).toHaveBeenCalledTimes(1)
})
it('窄屏(手机)按系数降速', async () => {
stubLayout(4000, 375)
await mountWelcome()
const speed = 4000 / (animations[0].options.duration / 1000)
expect(speed).toBeCloseTo(BASE_SPEED_PX_PER_SEC * NARROW_SPEED_FACTOR)
})
it('滚轮按速度换算手动位移,并夹在一轮时长内', async () => {
stubLayout(4000, 1000)
const wrapper = await mountWelcome()
const track = wrapper.find('.review-scroll-track')
await track.trigger('wheel', { deltaY: BASE_SPEED_PX_PER_SEC, deltaMode: 0 })
// 滚动 60px = 1 秒动画时间
expect(animations[0].currentTime).toBeCloseTo(1000)
await track.trigger('wheel', { deltaY: -100000, deltaMode: 0 })
expect(animations[0].currentTime).toBe(0)
})
it('手指左右拖动共用同一套换算,拖动后恢复播放', async () => {
stubLayout(4000, 1000)
const wrapper = await mountWelcome()
const track = wrapper.find('.review-scroll-track')
await track.trigger('touchstart', { touches: [{ clientX: 300 }] })
expect(animations[0].paused).toBe(true)
await track.trigger('touchmove', { touches: [{ clientX: 360 }] })
expect(animations[0].currentTime).toBeCloseTo(1000)
await track.trigger('touchend')
expect(animations[0].paused).toBe(false)
})
it('拖动后松开不会误触打开回忆卡片', async () => {
stubLayout(4000, 1000)
const wrapper = await mountWelcome()
const track = wrapper.find('.review-scroll-track')
await track.trigger('touchstart', { touches: [{ clientX: 300 }] })
await track.trigger('touchmove', { touches: [{ clientX: 400 }] })
await wrapper.find('.review-chip').trigger('click')
await flushPromises()
expect(wrapper.find('.recall-question').exists()).toBe(false)
})
it('点击残片(未拖动)会打开回忆卡片', async () => {
stubLayout(4000, 1000)
const wrapper = await mountWelcome()
await wrapper.find('.review-chip').trigger('click')
await flushPromises()
expect(wrapper.find('.recall-question').exists()).toBe(true)
expect(wrapper.find('.recall-snippet').text()).toContain('残片内容1')
})
it('卸载时取消动画并移除窗口监听', async () => {
const removeSpy = vi.spyOn(window, 'removeEventListener')
stubLayout(4000, 1000)
const wrapper = await mountWelcome()
wrapper.unmount()
expect(animations[0].cancel).toHaveBeenCalled()
expect(removeSpy).toHaveBeenCalledWith('resize', expect.any(Function))
removeSpy.mockRestore()
})
})
/**
* 待归类内容(归属-01):Feed 卡片打「待归类」标记,并在卡片上就地完成归类,不必进详情。
*/
describe('Welcome Feed 待归类内容', () => {
beforeEach(() => {
vi.clearAllMocks()
stubLayout(4000, 1000)
vi.mocked(getReviewTaskStats).mockResolvedValue({
code: 200,
data: [
{ taskNum: 'T002', taskName: 'TypeScript 类型体操' },
],
} as never)
vi.mocked(updateFragmentOwnership).mockResolvedValue({ code: 200, data: null } as never)
})
it('pendingOwnership 的残片在 Feed 上打「待归类」标记', async () => {
vi.mocked(getReviewFeed).mockResolvedValue({
code: 200,
data: [{ ...makeFragment(1), taskNum: null, taskName: null, pendingOwnership: true }],
} as never)
const wrapper = await mountWelcome()
expect(wrapper.find('.chip-pending').exists()).toBe(true)
expect(wrapper.find('.review-chip').text()).toContain('待归类')
})
it('点击待归类残片弹归类弹窗,选定任务后就地归类并刷新 Feed', async () => {
vi.mocked(getReviewFeed).mockResolvedValue({
code: 200,
data: [{ ...makeFragment(1), taskNum: null, taskName: null, pendingOwnership: true }],
} as never)
const wrapper = await mountWelcome()
await wrapper.find('.review-chip').trigger('click')
await flushPromises()
expect(wrapper.text()).toContain('归类这条学习残片')
expect(getReviewTaskStats).toHaveBeenCalled()
wrapper.findComponent({ name: 'ElSelect' }).vm.$emit('update:modelValue', 'T002')
await flushPromises()
const confirm = wrapper.findAll('button').find((b) => b.text().trim() === '确定归类')
await confirm!.trigger('click')
await flushPromises()
expect(updateFragmentOwnership).toHaveBeenCalledWith(1, 'T002')
// 归类成功后重新拉取 Feed
expect(getReviewFeed).toHaveBeenCalledTimes(2)
wrapper.unmount()
})
it('「升格为新任务」跳转到已有的新建任务流程并带上残片编号', async () => {
vi.mocked(getReviewFeed).mockResolvedValue({
code: 200,
data: [{ ...makeFragment(7), taskNum: null, taskName: null, pendingOwnership: true }],
} as never)
const pushSpy = vi.spyOn(appRouter, 'push').mockResolvedValue()
const wrapper = await mountWelcome()
await wrapper.find('.review-chip').trigger('click')
await flushPromises()
const promote = wrapper.findAll('button').find((b) => b.text().trim() === '升格为新任务')
await promote!.trigger('click')
await flushPromises()
expect(pushSpy).toHaveBeenCalledWith({ name: 'add-task', query: { promoteFragment: '7' } })
pushSpy.mockRestore()
wrapper.unmount()
})
})