|
| 1 | +import { test, expect } from "../fixtures/auth"; |
| 2 | +import { mockApi } from "../helpers/mock-api"; |
| 3 | +import { mockCards } from "../fixtures/mock-data"; |
| 4 | + |
| 5 | +/** |
| 6 | + * 시험 모드 타이머 지속성 & 이탈 세션 복원 회귀 테스트. |
| 7 | + * |
| 8 | + * 대상: src/pages/learn/test-mode.tsx, src/shared/hooks/use-timer.ts |
| 9 | + * |
| 10 | + * 기대 동작 (버그 픽스 후 GREEN, 현재는 RED): |
| 11 | + * - 시험 도중 브라우저 새로고침/탭 닫기 시 답변과 남은 시간이 보존된다. |
| 12 | + * - 재진입(새로고침 / SPA 이동 후 재진입) 시 "이전에 풀던 내역" 복원 |
| 13 | + * 다이얼로그가 뜬다. |
| 14 | + * - "이어서 풀기" → 답변이 복원되고 타이머가 이어서 진행된다(전체 시간으로 |
| 15 | + * 리셋되지 않음). |
| 16 | + * - "처음부터" → 답변이 초기화되고 타이머가 전체 시간으로 리셋된다. |
| 17 | + * |
| 18 | + * 알려진 근본 원인 (이 테스트가 검증하는 대상): |
| 19 | + * 1) 답변/세션 저장이 effect cleanup에만 의존 → 새로고침·탭 닫기 시 |
| 20 | + * cleanup이 실행되지 않아 저장 자체가 누락됨. (pagehide/visibilitychange |
| 21 | + * 핸들러 부재) |
| 22 | + * 2) 새로고침 시 useTimer가 복원한 타이머를 mount effect의 |
| 23 | + * timer.start(full)가 덮어써 초기화함. |
| 24 | + * |
| 25 | + * DEV_MOCK 제거 후 실 API 연결 상태 기준. |
| 26 | + */ |
| 27 | + |
| 28 | +const GROUP_ID = 1; |
| 29 | +const CARDSET_ID = 42; |
| 30 | +const CARDSET_URL = `/groups/${GROUP_ID}/cardsets/${CARDSET_ID}`; |
| 31 | + |
| 32 | +const STUDY_DEFAULTS_KEY = `flipnote-study-defaults-${CARDSET_ID}`; |
| 33 | +const SESSION_KEY = `flipnote-exam-session-${CARDSET_ID}`; |
| 34 | +const TIMER_KEY = `flipnote-timer-${CARDSET_ID}`; |
| 35 | + |
| 36 | +const FULL_MINUTES = 30; |
| 37 | +const FULL_SECONDS = FULL_MINUTES * 60; |
| 38 | + |
| 39 | +const MOCK_CARDS = mockCards.slice(0, 3); |
| 40 | + |
| 41 | +// localStorage에 시험 모드 설정을 주입해두면 설정 화면이 시험 모드로 로드된다. |
| 42 | +const TEST_SETTINGS = { |
| 43 | + mode: "test", |
| 44 | + isUnlimitedTime: false, |
| 45 | + testTimeMinutes: FULL_MINUTES, |
| 46 | + orderType: "sequential", |
| 47 | + testMode: "all", |
| 48 | + totalCardCount: MOCK_CARDS.length, |
| 49 | +}; |
| 50 | + |
| 51 | +async function mockAllApis(page: Parameters<typeof mockApi>[0]) { |
| 52 | + const m = mockApi(page); |
| 53 | + |
| 54 | + await m.succeed("**/api/auth/token/refresh", { success: true, data: {} }); |
| 55 | + await m.succeed("**/api/users/me", { |
| 56 | + success: true, |
| 57 | + data: { |
| 58 | + userId: 1, |
| 59 | + nickname: "테스터", |
| 60 | + email: "test@test.com", |
| 61 | + phone: "", |
| 62 | + smsAgree: false, |
| 63 | + profileImageUrl: "", |
| 64 | + }, |
| 65 | + }); |
| 66 | + await m.succeed(`**/api/card-sets/${CARDSET_ID}`, { |
| 67 | + success: true, |
| 68 | + data: { |
| 69 | + id: CARDSET_ID, |
| 70 | + name: "테스트 카드셋", |
| 71 | + groupId: GROUP_ID, |
| 72 | + visibility: "PUBLIC", |
| 73 | + category: "IT", |
| 74 | + hashtag: "", |
| 75 | + imageRefId: 0, |
| 76 | + imageUrl: "", |
| 77 | + cardCount: MOCK_CARDS.length, |
| 78 | + likeCount: 0, |
| 79 | + bookmarkCount: 0, |
| 80 | + createdAt: "2024-01-01T00:00:00", |
| 81 | + updatedAt: "2024-01-01T00:00:00", |
| 82 | + liked: false, |
| 83 | + bookmarked: false, |
| 84 | + managers: [], |
| 85 | + }, |
| 86 | + }); |
| 87 | + await m.succeed(`**/api/card-sets/${CARDSET_ID}/cards`, { |
| 88 | + success: true, |
| 89 | + data: MOCK_CARDS, |
| 90 | + }); |
| 91 | + await m.succeed(`**/api/groups/${GROUP_ID}`, { |
| 92 | + success: true, |
| 93 | + data: { |
| 94 | + groupId: GROUP_ID, |
| 95 | + name: "테스트 그룹", |
| 96 | + category: "IT", |
| 97 | + description: "", |
| 98 | + joinPolicy: "OPEN", |
| 99 | + visibility: "PUBLIC", |
| 100 | + maxMember: 10, |
| 101 | + imageUrl: "", |
| 102 | + createdAt: "2024-01-01T00:00:00", |
| 103 | + modifiedAt: "2024-01-01T00:00:00", |
| 104 | + }, |
| 105 | + }); |
| 106 | + await m.succeed(`**/api/groups/${GROUP_ID}/members`, { |
| 107 | + success: true, |
| 108 | + data: { memberInfoList: [] }, |
| 109 | + }); |
| 110 | + await m.succeed(`**/api/groups/${GROUP_ID}/permissions`, { |
| 111 | + success: true, |
| 112 | + data: { role: "MEMBER", permissions: [] }, |
| 113 | + }); |
| 114 | +} |
| 115 | + |
| 116 | +/** 설정 화면(시험 모드) → "학습 시작" → 시험 화면 진입까지 이동 */ |
| 117 | +async function navigateToTestMode(page: Parameters<typeof mockApi>[0]) { |
| 118 | + await page.addInitScript( |
| 119 | + ({ key, value, sessionKey, timerKey }) => { |
| 120 | + localStorage.setItem(key, JSON.stringify(value)); |
| 121 | + // 이전 테스트/세션 잔여 상태 제거 |
| 122 | + sessionStorage.removeItem(sessionKey); |
| 123 | + sessionStorage.removeItem(timerKey); |
| 124 | + }, |
| 125 | + { |
| 126 | + key: STUDY_DEFAULTS_KEY, |
| 127 | + value: TEST_SETTINGS, |
| 128 | + sessionKey: SESSION_KEY, |
| 129 | + timerKey: TIMER_KEY, |
| 130 | + }, |
| 131 | + ); |
| 132 | + await mockAllApis(page); |
| 133 | + |
| 134 | + await page.goto(CARDSET_URL); |
| 135 | + await page.waitForSelector("text=학습 모드 선택"); |
| 136 | + |
| 137 | + await Promise.all([ |
| 138 | + page.waitForURL(/cardsets\/learning/, { timeout: 5000 }), |
| 139 | + page.getByRole("button", { name: "학습 시작" }).click(), |
| 140 | + ]); |
| 141 | + |
| 142 | + // 카드 로드 완료 = 답변 입력란 노출 |
| 143 | + await expect(page.getByPlaceholder("답변을 입력하세요").first()).toBeVisible(); |
| 144 | +} |
| 145 | + |
| 146 | +/** sessionStorage의 타이머 키에서 남은 시간(초)을 계산해 읽는다. */ |
| 147 | +const readTimerRemaining = (page: Parameters<typeof mockApi>[0]) => |
| 148 | + page.evaluate((key) => { |
| 149 | + const raw = sessionStorage.getItem(key); |
| 150 | + if (!raw) return null; |
| 151 | + try { |
| 152 | + const s = JSON.parse(raw) as |
| 153 | + | { status: "running"; endTime: number } |
| 154 | + | { status: "paused"; remainingMs: number }; |
| 155 | + if (s.status === "running") return (s.endTime - Date.now()) / 1000; |
| 156 | + if (s.status === "paused") return s.remainingMs / 1000; |
| 157 | + } catch { |
| 158 | + return null; |
| 159 | + } |
| 160 | + return null; |
| 161 | + }, TIMER_KEY); |
| 162 | + |
| 163 | +const restoreDialog = (page: Parameters<typeof mockApi>[0]) => |
| 164 | + page.getByRole("dialog", { name: "이전 시험 내역" }); |
| 165 | + |
| 166 | +const firstAnswer = (page: Parameters<typeof mockApi>[0]) => |
| 167 | + page.getByPlaceholder("답변을 입력하세요").first(); |
| 168 | + |
| 169 | +const ANSWER_TEXT = "내가 작성한 답변입니다"; |
| 170 | + |
| 171 | +test.describe("시험 모드 — 타이머 지속성 & 이탈 세션 복원", () => { |
| 172 | + test("새로고침 시 복원 다이얼로그가 나타난다", async ({ |
| 173 | + authenticatedPage: page, |
| 174 | + }) => { |
| 175 | + await navigateToTestMode(page); |
| 176 | + |
| 177 | + await firstAnswer(page).fill(ANSWER_TEXT); |
| 178 | + // 타이머가 최소 1초 이상 진행되도록 대기 (남은 시간 보존 확인용) |
| 179 | + await page.waitForTimeout(2000); |
| 180 | + |
| 181 | + await page.reload(); |
| 182 | + |
| 183 | + await expect(restoreDialog(page)).toBeVisible(); |
| 184 | + }); |
| 185 | + |
| 186 | + test("'이어서 풀기' 시 답변이 복원되고 타이머가 초기화되지 않는다", async ({ |
| 187 | + authenticatedPage: page, |
| 188 | + }) => { |
| 189 | + await navigateToTestMode(page); |
| 190 | + |
| 191 | + await firstAnswer(page).fill(ANSWER_TEXT); |
| 192 | + await page.waitForTimeout(2000); |
| 193 | + |
| 194 | + // 새로고침 직전 남은 시간(이미 일부 소요되어 전체 시간보다 작아야 함) |
| 195 | + const before = await readTimerRemaining(page); |
| 196 | + expect(before).not.toBeNull(); |
| 197 | + expect(before!).toBeLessThan(FULL_SECONDS); |
| 198 | + |
| 199 | + await page.reload(); |
| 200 | + |
| 201 | + await expect(restoreDialog(page)).toBeVisible(); |
| 202 | + await page.getByRole("button", { name: "이어서 풀기" }).click(); |
| 203 | + await expect(restoreDialog(page)).toBeHidden(); |
| 204 | + |
| 205 | + // 답변 복원 |
| 206 | + await expect(firstAnswer(page)).toHaveValue(ANSWER_TEXT); |
| 207 | + |
| 208 | + // 타이머가 전체 시간으로 리셋되지 않고 이어짐 (복원값 근처, +tolerance 이내) |
| 209 | + const after = await readTimerRemaining(page); |
| 210 | + expect(after).not.toBeNull(); |
| 211 | + expect(after!).toBeLessThanOrEqual(before! + 2); |
| 212 | + }); |
| 213 | + |
| 214 | + test("'처음부터' 시 답변이 초기화되고 타이머가 리셋된다", async ({ |
| 215 | + authenticatedPage: page, |
| 216 | + }) => { |
| 217 | + await navigateToTestMode(page); |
| 218 | + |
| 219 | + await firstAnswer(page).fill(ANSWER_TEXT); |
| 220 | + await page.waitForTimeout(2000); |
| 221 | + |
| 222 | + await page.reload(); |
| 223 | + |
| 224 | + await expect(restoreDialog(page)).toBeVisible(); |
| 225 | + await page.getByRole("button", { name: "처음부터" }).click(); |
| 226 | + await expect(restoreDialog(page)).toBeHidden(); |
| 227 | + |
| 228 | + // 답변 초기화 |
| 229 | + await expect(firstAnswer(page)).toHaveValue(""); |
| 230 | + |
| 231 | + // 타이머 전체 시간으로 재시작 |
| 232 | + const remaining = await readTimerRemaining(page); |
| 233 | + expect(remaining).not.toBeNull(); |
| 234 | + expect(remaining!).toBeGreaterThan(FULL_SECONDS - 5); |
| 235 | + }); |
| 236 | + |
| 237 | + test("SPA 이동 후 재진입 시 복원 다이얼로그가 나타나고 답변이 복원된다", async ({ |
| 238 | + authenticatedPage: page, |
| 239 | + }) => { |
| 240 | + await navigateToTestMode(page); |
| 241 | + |
| 242 | + await firstAnswer(page).fill(ANSWER_TEXT); |
| 243 | + await page.waitForTimeout(1000); |
| 244 | + |
| 245 | + // 앱 내 뒤로가기(SPA) → 설정 화면으로 이탈 |
| 246 | + await page.goBack(); |
| 247 | + await page.waitForSelector("text=학습 모드 선택"); |
| 248 | + |
| 249 | + // 다시 학습 시작 → 시험 화면 재진입 |
| 250 | + await Promise.all([ |
| 251 | + page.waitForURL(/cardsets\/learning/, { timeout: 5000 }), |
| 252 | + page.getByRole("button", { name: "학습 시작" }).click(), |
| 253 | + ]); |
| 254 | + |
| 255 | + await expect(restoreDialog(page)).toBeVisible(); |
| 256 | + await page.getByRole("button", { name: "이어서 풀기" }).click(); |
| 257 | + await expect(restoreDialog(page)).toBeHidden(); |
| 258 | + |
| 259 | + await expect(firstAnswer(page)).toHaveValue(ANSWER_TEXT); |
| 260 | + }); |
| 261 | +}); |
0 commit comments