Node.jsでPuppeteerを使用してHTMLをPDFに変換する方法

なぜPuppeteerなのか？

• 使いやすさ： Puppeteerは、ヘッドレスブラウザでの作業の複雑さを抽象化する、シンプルで使いやすいAPIを提供します。
• 強力： Puppeteerは、ウェブページの操作やブラウザ要素との相互作用に対する広範な機能を提供します。
• スケーラブル： Puppeteerを使用することで、複数のブラウザインスタンスを並行して実行することで、PDF生成プロセスを簡単にスケールアップできます。

Puppeteerとfsのインポート

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

コードはまず、ChromeやChromiumのようなヘッドレスブラウザを制御する多目的ツールであるfsの2つの重要なライブラリをインポートすることから始まります。 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関数は、コードスニペットの核心を成します。 この非同期関数は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. readFileSyncメソッドを使用してHTMLファイルからHTMLコンテンツを読み込みます。
2. 読み込んだexportWebsiteAsPdf関数を呼び出します。
3. .thenブロックを利用して、PDF作成が成功した場合の処理を行い、コンソールに成功メッセージを記録します。
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関数は、コードスニペットの核心を成します。 この非同期関数はoutputPathを入力パラメーターとして受け取り、PDFファイルを返します。関数は次のステップを実行します。

1. Puppeteerを使用して新しいヘッドレスブラウザーインスタンスを起動します。
2. 新しいブラウザーページを作成します。
3. 提供されたnetworkidle0に設定してネットワークがアイドル状態になるのを待ちます。
4. 画面専用スタイルが適用されるように"screen"メディアタイプをエミュレートします。
5. 読み込まれたWebページを指定された余白、背景印刷、および形式（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. 希望するexportWebsiteAsPdf関数を呼び出します。
2. 成功したPDF作成を処理するためにthenブロックを使用します。 このブロックでは、コンソールに成功メッセージをログに記録します。
3. ウェブサイトからPDFへの変換プロセス中に発生したエラーを処理するためにcatchブロックを使用します。 エラーが発生した場合、コンソールにエラーメッセージをログに記録します。

このコードスニペットをプロジェクトに統合することで、Node.jsとPuppeteerを使用して簡単に高品質のPDFファイルにURLを変換できます。

IronPDFの主な機能

IronPDFによるHTMLからPDFへの変換： IronPDFを使用すると、CSSを含むHTMLコンテンツをPDFファイルに変換できます。 この機能によりウェブページやHTMLテンプレートからピクセルパーフェクトなPDFドキュメントを作成できます。

URLレンダリング：IronPDFは、URLを使用してサーバーから直接ウェブページを取得し、PDFファイルに変換できます。これにより、ウェブコンテンツのアーカイブや動的なウェブページからのレポートの生成が簡単になります。

テキスト、画像、PDFのマージ：IronPDFを使用すると、テキスト、画像、既存のPDFファイルを1つのPDFドキュメントに統合できます。 この機能は、複数のコンテンツソースを持つ複雑なドキュメントを作成するのに特に便利です。

PDF操作：IronPDFは、既存のPDFファイルを編集するためのツールを提供します。これには、ページの追加または削除、メタデータの変更、PDFドキュメントからのテキストや画像の抽出などが含まれます。