Node.js에서 Puppeteer를 사용하여 HTML을 PDF로 변환하는 방법

왜 Puppeteer인가?

• 사용의 용이성: Puppeteer는 무인 브라우저를 사용하는 복잡성을 숨기고 간단하고 사용하기 쉬운 API를 제공합니다.
• 강력함: Puppeteer는 웹 페이지를 조작하고 브라우저 요소와 상호작용하는 데 광범위한 기능을 제공합니다.
• 확장 가능성: Puppeteer를 사용하면 여러 브라우저 인스턴스를 병렬로 실행하여 PDF 생성 프로세스를 쉽게 확장할 수 있습니다.

Puppeteer와 fs 가져오기

const puppeteer = require('puppeteer');
const fs = require('fs');

코드는 두 가지 필수 라이브러리: Chrome 및 Chromium과 같은 헤드리스 브라우저를 제어하기 위한 다목적 도구 puppeteer와(과) 파일 시스템 작업을 처리하기 위한 Node.js 내장 모듈 fs를(을) 임포트하여 시작합니다. Puppeteer는 HTML 렌더링, 스크린샷 캡처, PDF 파일 생성 등 다양한 웹 관련 작업을 자동화할 수 있게 합니다.

exportWebsiteAsPdf 함수 정의하기

async function exportWebsiteAsPdf(html, outputPath) {
  // Create a browser instance
  const browser = await puppeteer.launch({
    headless: true // Launches the browser in headless mode
  });

  // Create a new page
  const page = await browser.newPage();

  // Set the HTML content for the page, waiting for DOM content to load
  await page.setContent(html, { waitUntil: 'domcontentloaded' });

  // To reflect CSS used for screens instead of print
  await page.emulateMediaType('screen');

  // Download the PDF
  const PDF = await page.pdf({
    path: outputPath,
    margin: { top: '100px', right: '50px', bottom: '100px', left: '50px' },
    printBackground: true,
    format: 'A4',
  });

  // Close the browser instance
  await browser.close();

  return PDF;
}

exportWebsiteAsPdf 함수는 코드 스니펫의 핵심 역할을 합니다. 이 비동기 함수는 html 문자열과 outputPath를 입력 매개변수로 받아 PDF 파일을 반환합니다. 함수는 다음의 단계를 수행합니다:

1. Puppeteer를 사용하여 새로운 헤드리스 브라우저 인스턴스를 시작합니다.
2. 새로운 브라우저 페이지를 생성합니다.
3. 제공된 html 문자열을 페이지 내용으로 설정하고 DOM 콘텐츠가 로드될 때까지 기다립니다.
4. 'screen' 미디어 타입을 사용하도록 에뮬레이트하여, 인쇄용 스타일 대신 화면용 CSS가 적용되도록 합니다.
5. 로드된 HTML 콘텐츠로부터 PDF 파일을 생성하며, 여백, 배경 인쇄, 포맷(A4)을 지정합니다.
6. 브라우저 인스턴스를 종료합니다.
7. 생성된 PDF 파일을 반환합니다.

exportWebsiteAsPdf 함수 사용하기

// Usage example
// Get HTML content from HTML file
const html = fs.readFileSync('test.html', 'utf-8');

// Convert the HTML content into a PDF and save it to the specified path
exportWebsiteAsPdf(html, 'result.pdf').then(() => {
  console.log('PDF created successfully.');
}).catch((error) => {
  console.error('Error creating PDF:', error);
});

코드의 마지막 섹션은 exportWebsiteAsPdf 함수를 사용하는 방법을 설명합니다. 다음 단계를 수행합니다:

1. fs 모듈의 readFileSync 메서드를 사용하여 HTML 파일에서 HTML 콘텐츠를 읽습니다.
2. 로드된 html 문자열과 원하는 outputPath로 exportWebsiteAsPdf 함수를 호출합니다.
3. 성공적인 PDF 생성을 처리하기 위해 .then 블록을 활용하여 콘솔에 성공 메시지를 기록합니다.
4. HTML을 PDF로 변환하는 과정에서 발생하는 오류를 처리하기 위해 .catch 블록을 사용하여 콘솔에 오류 메시지를 기록합니다.

이 코드 스니펫은 Node.js와 Puppeteer를 사용하여 HTML 템플릿을 PDF 파일로 변환하는 포괄적인 예시를 제공합니다. 이 솔루션을 구현함으로써 다양한 애플리케이션 및 사용자의 요구를 충족하는 고품질의 PDF를 효율적으로 생성할 수 있습니다.

Puppeteer 가져오기

const puppeteer = require('puppeteer');

코드는 Chrome 및 Chromium과 같은 헤드리스 브라우저를 제어하는 강력한 도구인 Puppeteer 라이브러리를 가져오는 것으로 시작합니다. Puppeteer는 HTML 코드 렌더링, 스크린샷 캡처, PDF 파일 생성 등 다양한 웹 기반 작업을 자동화할 수 있게 합니다.

exportWebsiteAsPdf 함수 정의하기

async function exportWebsiteAsPdf(websiteUrl, outputPath) {
  // Create a browser instance
  const browser = await puppeteer.launch({
    headless: true // Launches the browser in headless mode
  });

  // Create a new page
  const page = await browser.newPage();

  // Open the URL in the current page
  await page.goto(websiteUrl, { waitUntil: 'networkidle0' });

  // To reflect CSS used for screens instead of print
  await page.emulateMediaType('screen');

  // Download the PDF
  const PDF = await page.pdf({
    path: outputPath,
    margin: { top: '100px', right: '50px', bottom: '100px', left: '50px' },
    printBackground: true,
    format: 'A4',
  });

  // Close the browser instance
  await browser.close();

  return PDF;
}

exportWebsiteAsPdf 함수는 코드 스니펫의 핵심입니다. 이 비동기 함수는 websiteUrl와(과) outputPath를 입력 매개변수로 받아 PDF 파일을 반환합니다. 함수는 다음의 단계를 수행합니다:

1. Puppeteer를 사용하여 새로운 헤드리스 브라우저 인스턴스를 시작합니다.
2. 새로운 브라우저 페이지를 생성합니다.
3. 제공된 websiteUrl로 이동하고 waitUntil 옵션을 networkidle0로 설정하여 네트워크가 유휴 상태가 될 때까지 기다립니다.
4. 'screen' 미디어 타입을 사용하도록 에뮬레이트하여, 인쇄용 스타일 대신 화면용 CSS가 적용되도록 합니다.
5. 지정된 여백, 배경 인쇄, 포맷(A4)을 사용하여 로드된 웹 페이지를 PDF 파일로 변환합니다.
6. 브라우저 인스턴스를 종료합니다.
7. 생성된 PDF 파일을 반환합니다.

exportWebsiteAsPdf 함수 사용하기

// Usage example
// Convert the URL content into a PDF and save it to the specified path
exportWebsiteAsPdf('https://ironpdf.com/', 'result.pdf').then(() => {
  console.log('PDF created successfully.');
}).catch((error) => {
  console.error('Error creating PDF:', error);
});

코드의 마지막 섹션은 exportWebsiteAsPdf 함수를 사용하는 방법을 보여줍니다. 다음 단계를 실행합니다:

1. 원하는 websiteUrl 및 outputPath으로 exportWebsiteAsPdf 함수를 호출합니다.
2. 성공적인 PDF 생성을 처리하기 위해 then 블록을 사용합니다. 이 블록에서는 콘솔에 성공 메시지를 기록합니다.
3. 웹사이트를 PDF로 변환하는 과정에서 발생하는 오류를 처리하기 위해 catch 블록을 사용합니다. 오류가 발생하면 콘솔에 오류 메시지를 기록합니다.

이 코드 스니펫을 프로젝트에 통합하면, Node.js와 Puppeteer를 사용하여 URL을 손쉽게 고품질의 PDF 파일로 변환할 수 있습니다.

IronPDF 의 주요 기능

IronPDF를 사용한 HTML에서 PDF로의 변환: IronPDF는 CSS를 포함한 HTML 콘텐츠를 PDF 파일로 변환할 수 있도록 합니다. 이 기능은 웹 페이지나 HTML 템플릿에서 픽셀 단위로 완벽한 PDF 문서를 생성할 수 있게 합니다.

URL 렌더링: IronPDF는 서버에서 URL을 사용하여 직접 웹 페이지를 가져와 PDF 파일로 변환할 수 있습니다. 이를 통해 웹 콘텐츠를 아카이브하거나 동적 웹 페이지에서 보고서를 생성하기 쉽습니다.

텍스트, 이미지 및 PDF 병합: IronPDF는 텍스트, 이미지 및 기존 PDF 파일을 하나의 PDF 문서로 병합할 수 있습니다. 이 기능은 여러 콘텐츠 소스가 있는 복잡한 문서를 생성하는 데 특히 유용합니다.

PDF 조작: IronPDF는 PDF 파일을 편집할 수 있는 도구를 제공하여 페이지 추가 또는 제거, 메타데이터 수정, PDF 문서에서 텍스트 및 이미지 추출 등을 수행할 수 있습니다.