# Instructions - Following Playwright test failed. - Explain why, be concise, respect Playwright best practices. - Provide a snippet of code with the fix, if possible. # Test info - Name: 4147/dev/privacy-masking-regression.spec.ts >> [4147][dev] [QA] 개인정보 마스킹 및 원문 조회 역할별 회귀 검증 >> [BO] 지갑입출금내역 / Excel 기본 마스킹 및 PIN 원문 다운로드 - Location: src/qa/scenarios/privacyMaskingRegression.ts:116:11 # Error details ``` Error: BO 지갑입출금내역 Excel 조회결과 다운로드 메뉴가 없습니다. ``` # Test source ```ts 323 | const inputCount = await inputs.count(); 324 | let maskedInputs = 0; 325 | let editableMaskedInputs = 0; 326 | for (let index = 0; index < inputCount; index += 1) { 327 | const input = inputs.nth(index); 328 | const value = await input.inputValue().catch(() => ""); 329 | if (!/[＊*•]/.test(value)) continue; 330 | maskedInputs += 1; 331 | if (await input.isEditable().catch(() => false)) editableMaskedInputs += 1; 332 | } 333 | 334 | await closeSurface(page, opened.surface); 335 | if (maskedInputs === 0) { 336 | blocked(`${definition.name} 수정 모달에 수정 차단을 검증할 마스킹 입력값이 없습니다.`); 337 | } 338 | expect(editableMaskedInputs, `${definition.name} 수정 모달의 마스킹 개인정보는 인증 전에 편집할 수 없어야 합니다.`).toBe(0); 339 | return { maskedInputs, editableMaskedInputs }; 340 | } 341 | 342 | async function openEditModal(page: Page): Promise<{ surface: Locator } | undefined> { 343 | const root = await interactionRoot(page); 344 | const editCandidates = root.locator( 345 | "button[aria-label*='수정'], button[title*='수정'], button:has(svg.lucide-pencil), [role='button']:has(svg.lucide-pencil), svg.lucide-pencil" 346 | ); 347 | const count = Math.min(await editCandidates.count(), 20); 348 | for (let index = 0; index < count; index += 1) { 349 | const candidate = editCandidates.nth(index); 350 | if (!(await candidate.isVisible().catch(() => false))) continue; 351 | if (!(await isActiveElement(candidate))) continue; 352 | await candidate.click({ force: true }); 353 | await page.waitForTimeout(700); 354 | const unmask = await firstVisible(page.getByRole("button", { name: /^마스킹 해제$/ })); 355 | if (unmask) { 356 | const dialog = unmask.locator("xpath=ancestor::*[@role='dialog'][1]"); 357 | return { surface: (await dialog.count()) > 0 ? dialog : page.locator("body") }; 358 | } 359 | await page.keyboard.press("Escape").catch(() => undefined); 360 | } 361 | return undefined; 362 | } 363 | 364 | async function verifyExcelMasking( 365 | page: Page, 366 | runtime: RuntimeQaEnv, 367 | definition: PrivacyPageDefinition 368 | ): Promise<{ 369 | masked: ExcelDocument; 370 | unmasked: ExcelDocument; 371 | maskedStars: number; 372 | unmaskedStars: number; 373 | }> { 374 | if (!(await hasActionableRows(page))) { 375 | blocked(`${runtime.role} ${definition.name}은 기간 확장 후에도 Excel 검증 데이터가 없습니다.`); 376 | } 377 | 378 | const maskedRequest = await requestExcelDocument(page, runtime, definition, false); 379 | await openTargetPage(page, runtime, definition); 380 | await ensureSearchData(page); 381 | const unmaskedRequest = await requestExcelDocument(page, runtime, definition, true); 382 | 383 | const documents = await waitForExcelDocuments(page, runtime, [maskedRequest.id, unmaskedRequest.id]); 384 | const masked = requireDocument(documents, maskedRequest.id); 385 | const unmasked = requireDocument(documents, unmaskedRequest.id); 386 | expect(normalizeMode(masked.exposureMode), `${definition.name} 기본 Excel은 MASKED여야 합니다.`).toBe("MASKED"); 387 | expect(normalizeMode(unmasked.exposureMode), `${definition.name} 원문 Excel은 UNMASKED여야 합니다.`).toBe("UNMASKED"); 388 | 389 | const maskedBuffer = await downloadDocument(page, masked); 390 | const unmaskedBuffer = await downloadDocument(page, unmasked); 391 | const maskedText = extractDownloadBufferText(maskedBuffer, masked.filename ?? "masked.xlsx"); 392 | const unmaskedText = extractDownloadBufferText(unmaskedBuffer, unmasked.filename ?? "unmasked.xlsx"); 393 | const maskedStars = countMaskCharacters(maskedText); 394 | const unmaskedStars = countMaskCharacters(unmaskedText); 395 | 396 | if (maskedStars === 0) { 397 | blocked(`${runtime.role} ${definition.name} 기본 Excel에 마스킹 검증이 가능한 개인정보 값이 없습니다.`); 398 | } 399 | expect(unmaskedStars, `${definition.name} 원문 Excel은 기본 Excel보다 마스킹 문자가 적어야 합니다.`).toBeLessThan(maskedStars); 400 | return { masked, unmasked, maskedStars, unmaskedStars }; 401 | } 402 | 403 | async function requestExcelDocument( 404 | page: Page, 405 | runtime: RuntimeQaEnv, 406 | definition: PrivacyPageDefinition, 407 | unmasked: boolean 408 | ): Promise { 409 | const interaction = await interactionRoot(page); 410 | const excelButton = await firstVisible(interaction.locator("button:visible").filter({ hasText: /^엑셀$/ })); 411 | if (!excelButton) { 412 | throw new Error(`${runtime.role} ${definition.name} 화면에 Excel 버튼이 표시되지 않습니다.`); 413 | } 414 | await domClick(excelButton); 415 | await page.waitForTimeout(300); 416 | 417 | let dialog = await findExcelDialog(page); 418 | if (!dialog) { 419 | const menu = await firstVisible( 420 | page.locator("li:visible, [role='menuitem']:visible, button:visible, a:visible") 421 | .filter({ hasText: /조회결과\s*다운로드|엑셀\s*다운로드/ }) 422 | ); > 423 | if (!menu) throw new Error(`${runtime.role} ${definition.name} Excel 조회결과 다운로드 메뉴가 없습니다.`); | ^ Error: BO 지갑입출금내역 Excel 조회결과 다운로드 메뉴가 없습니다. 424 | await domClick(menu); 425 | dialog = await findExcelDialog(page, 10_000); 426 | } 427 | if (!dialog) throw new Error(`${definition.name} Excel 마스킹 안내 모달이 표시되지 않았습니다.`); 428 | const root = dialog; 429 | const checkbox = root.getByLabel(/마스킹 해제 후 다운로드/).last(); 430 | if (unmasked) { 431 | await expect(checkbox, `${definition.name} Excel 원문 다운로드 선택 항목이 표시되어야 합니다.`).toBeVisible(); 432 | await checkbox.check(); 433 | } 434 | 435 | const responses: Response[] = []; 436 | const observedRequests: string[] = []; 437 | const requestListener = (request: { method: () => string; url: () => string }): void => { 438 | if (/excel|masking|authentication/i.test(request.url())) { 439 | observedRequests.push(`${request.method()} ${new URL(request.url()).pathname}`); 440 | } 441 | }; 442 | const listener = (response: Response): void => { 443 | const request = response.request(); 444 | if (request.method() !== "POST") return; 445 | if (!/\/api\/v1\/excel(?:[/?]|$)/.test(response.url())) return; 446 | if (/export-authorizations/.test(response.url())) return; 447 | responses.push(response); 448 | }; 449 | page.on("request", requestListener); 450 | page.on("response", listener); 451 | try { 452 | const downloadButton = await firstVisible(root.getByRole("button", { name: /다운로드/ })); 453 | if (!downloadButton) throw new Error(`${definition.name} Excel 다운로드 실행 버튼을 찾지 못했습니다.`); 454 | await domClick(downloadButton); 455 | 456 | if (unmasked) { 457 | const pin = await firstVisible(page.locator("input[placeholder*='PIN'], input[name='pin'], input[type='password']"), 10_000); 458 | if (!pin) throw new Error(`${definition.name} 원문 Excel 선택 후 PIN 인증창이 표시되지 않았습니다.`); 459 | await pin.fill(runtime.twoFactorCode ?? "secret-redacted"); 460 | const pinDialog = pin.locator("xpath=ancestor::*[@role='dialog'][1]"); 461 | const pinRoot = (await pinDialog.count()) > 0 ? pinDialog : page.locator("body"); 462 | const confirm = await firstVisible(pinRoot.locator("button:visible").filter({ hasText: /^(확인|인증)$/ }), 5_000); 463 | if (!confirm) { 464 | const buttonNames = (await pinRoot.locator("button:visible").allTextContents()).map(normalize).filter(Boolean); 465 | throw new Error(`${definition.name} 원문 Excel PIN 확인 버튼을 찾지 못했습니다. 표시 버튼=${buttonNames.join(" | ")}`); 466 | } 467 | await confirm.click({ force: true }); 468 | } 469 | 470 | const response = await waitForCollectedExcelResponse(page, responses, observedRequests); 471 | const json = await response.json().catch(() => undefined); 472 | const id = findDocumentId(json); 473 | if (!id) throw new Error(`${definition.name} Excel 생성 응답에서 문서 ID를 찾지 못했습니다.`); 474 | await closeVisibleDialogs(page); 475 | return { id, mode: unmasked ? "UNMASKED" : "MASKED" }; 476 | } finally { 477 | page.off("request", requestListener); 478 | page.off("response", listener); 479 | } 480 | } 481 | 482 | async function findExcelDialog(page: Page, timeoutMs = 1_000): Promise { 483 | const checkbox = await firstVisible(page.getByLabel(/마스킹 해제 후 다운로드/), timeoutMs); 484 | if (!checkbox) return undefined; 485 | const dialog = checkbox.locator("xpath=ancestor::*[@role='dialog'][1]"); 486 | return (await dialog.count()) > 0 ? dialog : page.locator("body"); 487 | } 488 | 489 | async function waitForCollectedExcelResponse( 490 | page: Page, 491 | responses: Response[], 492 | observedRequests: string[] 493 | ): Promise { 494 | const deadline = Date.now() + 30_000; 495 | while (Date.now() < deadline) { 496 | if (responses.length > 0) return responses.at(-1)!; 497 | await page.waitForTimeout(200); 498 | } 499 | throw new Error(`Excel 생성 POST 응답을 30초 안에 확인하지 못했습니다. 관련 요청=${observedRequests.join(" | ") || "없음"}`); 500 | } 501 | 502 | async function waitForExcelDocuments( 503 | page: Page, 504 | runtime: RuntimeQaEnv, 505 | ids: string[] 506 | ): Promise { 507 | if (!runtime.baseUrl) blocked(`${runtime.role} baseUrl이 없습니다.`); 508 | const documentUrl = new URL("/document", ensureTrailingSlash(runtime.baseUrl!)); 509 | if (runtime.tenantId) documentUrl.searchParams.set("tenantId", runtime.tenantId); 510 | const deadline = Date.now() + 120_000; 511 | let latest: ExcelDocument[] = []; 512 | 513 | while (Date.now() < deadline) { 514 | const responsePromise = page.waitForResponse( 515 | (response) => response.request().method() === "GET" && /\/api\/v1\/excel\?/.test(response.url()), 516 | { timeout: 15_000 } 517 | ).catch(() => undefined); 518 | await page.goto(documentUrl.toString(), { waitUntil: "domcontentloaded", timeout: 30_000 }); 519 | const response = await responsePromise; 520 | await settle(page); 521 | if (response) { 522 | const json = await response.json().catch(() => undefined); 523 | latest = collectDocuments(json); ```