미리보기 없이 PDF를 다운로드하는 방법

브라우저 사양에 따라 PDF 링크를 클릭하면 프리뷰 표시(PDF 뷰어)가 우선되어 파일이 다운로드되지 않는 경우가 있습니다. 본 절차에서는 단계를 Playwright 코드로 변환하고, Alt 키를 함께 사용하는 클릭을 시뮬레이션하여 직접 다운로드를 강제합니다.

절차

1. 대상 시나리오 열기: 편집하려는 테스트 시나리오를 선택합니다.

2. 대상 단계 선택: PDF 링크를 클릭하고 있는 '클릭 단계'를 선택합니다.

3. Playwright 코드 단계로 변환: 단계 메뉴에서 [Playwright 코드 단계로 변환]을 실행합니다.

4. 코드 수정 (Alt 키 지정): 표시된 코드 내의 click 메서드에 { modifiers: ['Alt'] }를 추가합니다.

   // 수정 전
   await page.getByRole("link", {name: "자료 PDF"}).click();
   // 수정 후 (Alt 키 병용 지정)
   await page.getByRole("link", {name: "자료 PDF"}).click({ modifiers: ['Alt'] }); 

5. (선택 사항) 다운로드 완료 대기를 위한 대기 단계 추가: Playwright 코드에 의한 클릭 액션은 실행 자체가 매우 짧은 시간에 종료됩니다. PDF 파일 크기가 크거나 통신 환경의 영향으로 다운로드 완료 전에 테스트가 종료(또는 다음으로 전이)되는 경우, 코드 단계 직후에 '대기 단계(예: 5초~10초 정도)'를 추가해 주세요.

6. 저장: 화면 오른쪽 상단의 [저장]을 클릭합니다.

확인 방법

시나리오를 실행하여 해당 단계에서 다음의 동작을 확인합니다.

• 브라우저에서 PDF 프리뷰가 열리지 않을 것.

• 파일이 정상적으로 다운로드될 것.

• 필요에 따라 [테스트 결과] 상세 화면에서 해당 단계가 정상 종료되었는지 확인합니다.

유의 사항

• 브라우저 단축키 활용: 본 절차는 'Alt 키를 누른 채 링크를 클릭하면 링크 대상을 저장한다'는 브라우저의 일반적인 단축키 동작을 이용하고 있습니다.

• 대기 판단 기준: 일반적으로는 대기 단계 없이도 동작하지만, 실행 결과에서 '다운로드가 제때 완료되지 않은 것'으로 보이는 동작(파일이 저장되지 않은 채 브라우저가 닫히는 등)이 나타나는 경우에만 5단계 추가를 검토해 주세요.