JavaScript API

PDFkind.fit(file, { max })로 직접 작성한 코드에서 PDF나 이미지를 용량 제한에 맞게 줄이고, 모든 결과를 처리합니다.

스크립트는 전역 PDFkind 객체를 추가합니다. 붙여넣기, 카메라, 사용자 정의 선택기처럼 자동 모드가 감지하지 못하는 곳에서 파일이 들어올 때 사용하세요.

PDFkind.fit(file, options)

JavaScript

try {
  const small = await PDFkind.fit(file, { max: '5MB' });
  upload(small);
} catch (err) {
  if (err.reason === 'too-big') alert('파일이 너무 큽니다. 용량을 줄여도 제한을 넘습니다.');
  else upload(file);   // 원본 파일로 대체
}

옵션	유형	설명
`max`	문자열 또는 숫자	필수. `data-pdfkind-max`와 같은 형식입니다: `5MB`, `500KB` 또는 바이트 수.
`el`	Element	선택. 이 요소(또는 상위 요소)의 `data-lang`이 창의 언어를 정합니다.

반환되는 Promise는 File로 이행됩니다. 줄어든 파일, HEIC 사진의 경우 변환된 JPG, 이미 제한에 맞는 경우 원본 파일(이때는 창이 열리지 않음)입니다. 거부될 때는 reason이 다음 중 하나인 오류를 반환합니다.

reason	의미
`too-big`	용량을 줄여도 파일이 제한을 넘습니다.
`unsupported`	도우미가 줄일 수 있는 PDF나 이미지가 아닙니다.
`cancel`	방문자가 창을 닫았습니다.
`unavailable`	PDFkind 창이 8초 안에 로드되지 않았습니다.
`timeout`	처리 시간이 3분을 넘었습니다.
`failed`	파일이 손상되었거나 다른 문제가 발생했습니다.
`bad-call`	File 없이 또는 max 없이 호출되었습니다.

PDFkind.mount(root)

data-pdfkind-tool 요소를 도구로 바꿉니다. 페이지 로드 시 자동으로 실행되며, 단일 페이지 앱처럼 나중에 도구를 추가한 경우에는 다시 호출하세요. root는 선택 사항이며 기본값은 페이지 전체입니다.

JavaScript

container.innerHTML = '<div data-pdfkind-tool="split-pdf"></div>';
PDFkind.mount(container);

PDFkind.version

스크립트 버전이며, 현재 값은 3입니다. 스크립트가 로드되었는지 확인할 때 유용합니다. 브라우저 콘솔에 PDFkind.version을 입력해 보세요.

이전WordPress 및 폼 빌더 다음 도구 임베드

최종 업데이트: 2026년 11월 3일 · 문의: contact@pdfkind.com