File.openPDFViewer

함수형 API openPDFViewer로도 같은 기능을 쓸 수 있어요.

기능 설명

Base64로 인코딩된 PDF 데이터를 네이티브 PDF 뷰어로 열어요. 사용자가 뷰어를 닫으면 'CLOSE'를 반환해요.

토스앱 Android/iOS 5.261.0 이상에서 사용할 수 있어요. 호출 전에 File.openPDFViewer.isSupported()로 지원 여부를 확인할 수 있어요. 미지원 버전에서 호출하면 UNSUPPORTED_APP_VERSION 에러가 발생해요.

타입

File.openPDFViewer(params: OpenPDFViewerParams): Promise<OpenPDFViewerResult>;

Params

type OpenPDFViewerParams = {
  data: string;
  filename?: string;
};

Response

type OpenPDFViewerResult = "CLOSE";

에러 코드

에러 코드는 catch한 에러의 error.code 값이에요.

코드	설명
UNSUPPORTED_APP_VERSION	실행 중인 토스앱 버전이 이 기능을 지원하지 않으면 호출 즉시 발생해요. File.openPDFViewer.isSupported()로 사전 확인하고, 발생 시 error.message(업데이트 안내 문구)를 사용자에게 보여주세요.
INVALID_REQUEST	요청 파라미터가 올바르지 않은 경우예요.
INVALID_DATA	PDF 데이터가 유효하지 않은 경우예요.
PDF_VIEWER_ERROR	PDF 뷰어를 여는 과정에서 오류가 발생한 경우예요.

예시 코드

import { File } from "@apps-in-toss/web-framework";

async function handleOpenPdf() {
  if (!File.openPDFViewer.isSupported()) {
    console.log("현재 토스앱 버전에서는 PDF 뷰어를 사용할 수 없어요.");
    return;
  }

  try {
    const result = await File.openPDFViewer({
      data: "JVBERi0xLjQK...",
      filename: "document.pdf",
    });

    if (result === "CLOSE") {
      console.log("PDF 뷰어가 닫혔어요.");
    }
  } catch (error) {
    console.error("PDF 뷰어 오류:", error);
  }
}

document.querySelector("#open-pdf").addEventListener("click", handleOpenPdf);