Node.js PDF 程式庫

HTML 轉 PDF

import {PdfDocument} from "@ironsoftware/ironpdf";

(async () => {
    // Create a PDF from an HTML string
    const pdf = await PdfDocument.fromHtml("<h1>Hello World</h1>");

    // Export the PDF to a file
    await pdf.saveAs("output.pdf");

    // Advanced Example with HTML Assets
    // Load external HTML assets: Images, CSS, and JavaScript.
    const htmlContentWithAssets = "<img src='icons/iron.png'>";
    const advancedPdf = await PdfDocument.fromHtml(htmlContentWithAssets);

    // Save the PDF with loaded assets
    await advancedPdf.saveAs("html-with-assets.pdf");
})();

import {PdfDocument} from "@ironsoftware/ironpdf";

(async () => {
    // Create a PDF from an HTML string
    const pdf = await PdfDocument.fromHtml("<h1>Hello World</h1>");

    // Export the PDF to a file
    await pdf.saveAs("output.pdf");

    // Advanced Example with HTML Assets
    // Load external HTML assets: Images, CSS, and JavaScript.
    const htmlContentWithAssets = "<img src='icons/iron.png'>";
    const advancedPdf = await PdfDocument.fromHtml(htmlContentWithAssets);

    // Save the PDF with loaded assets
    await advancedPdf.saveAs("html-with-assets.pdf");
})();

NODE 說明

Prettier - NPM（開發者的使用方法）

Curtis Chau

Updated: 2026年4月21日

在現代的軟體開發中，維持乾淨且一致的程式碼風格對於可讀性、協作性及可維護性至關重要。工具如Prettier，包含了TypeScript的內建型別聲明，在此追求中已成不可或缺的工具，能自動化程式碼格式化這個常常繁瑣的任務。在這篇文章中，我們深入探討Prettier，探索其特點、優勢、整合及最佳實踐。此外，我們將探討IronPDF PDF生成程式庫，從網站URL生成PDF。

Prettier介紹

Prettier是一個有主見的程式碼格式化工具，會根據預定義的規則（如最大行長度）自動調整您的程式碼風格和格式。它支持多種程式語言，包括JavaScript、TypeScript、HTML、CSS、JSON等，使其在不同技術堆疊和專案型別中都非常通用。Prettier最初由James Long開發，由於其強大的功能及易用性，在開發者社群中獲得了顯著的關注。

主要特點和優勢

一致性程式碼風格： Prettier在整個程式碼庫中強制執行一致的編碼風格，消除對格式偏好的爭論，確保程式碼外觀的一致性，從而加快程式碼審核過程。
自動格式化： 通過與編輯器或建置過程整合，Prettier在您鍵入或提交之前自動格式化程式碼，為開發者節省寶貴的時間和精力。它可以配置為在保存時運行或僅應用於特定目錄。
可配置性： 雖然Prettier預設是有主見的，但它提供了一些可配置性來調整某些格式規則以適應專案特定需求。
語言支持： 它支持多種程式語言和格式，確保與多樣的開發環境相容。
程式碼質量： 改善的程式碼可讀性導致更好的理解，並減少因不一致格式引起的語法錯誤或漏洞。

Prettier快速入門

安裝

要在您的專案中使用Prettier，您可以通過NPM或yarn安裝它：

npm install prettier --save-dev

npm install prettier --save-dev

SHELL

yarn add --dev prettier

yarn add --dev prettier

SHELL

用法

命令行介面（CLI）： Prettier提供一個CLI工具來手動格式化文件或將其整合到腳本中以進行自動格式化任務。
編輯器整合： 提供的插件適用於熱門的編輯器如Visual Studio Code、Sublime Text、Atom等，實現實時格式化。
Git Hooks： 使用Git Hooks設置Prettier在提交之前運行，以確保所有程式碼修改遵循已定格式規則。

整合與生態系統

Prettier無縫整合各種開發工具和工作流程：

IDE插件： 與IDEs和文字編輯器整合，實現即時程式碼格式化，提高開發者生產力並維持編碼標準。
建置系統： 整合到建立管道和持續整合（CI）工作流程中，強制執行跨團隊專案一致的程式碼格式化。
版本控制： 與版本控制系統如Git和諧工作，確保已格式化的程式碼在整個協作過程中得到一貫保留。

Prettier最佳實踐

使用預設值： 初步採用Prettier預設設置以促成您的程式碼庫一致性，避免不必要的自定義。
版本控制： 定期更新Prettier來利用新功能、錯誤修復以及改善的語言支持。
配置： 微調Prettier配置以配合專案特定約定或團隊偏好，同時維持一致性。
教育與採用： 鼓勵團隊成員採用Prettier，並教育他們它的優勢，以促進統一的程式碼格式化方法。

IronPDF介紹

Prettier - NPM（開發者如何運作）：圖1 - IronPDF

IronPDF是一個廣受歡迎的PDF生成程式庫，用於生成、編輯和轉換PDF文件。 IronPDF NPM程式包是專門為Node.js應用程式設計的。以下是IronPDF NPM套裝的重要特點和詳細資訊：

主要功能

HTML到PDF轉換

輕鬆將 HTML 內容轉換為 PDF 文件。此功能特別適合從網頁內容生成動態 PDF。

URL到PDF轉換

直接從 URL 生成 PDF，允許您程式化地捕捉網頁內容並將其儲存為 PDF 檔案。

PDF 操作

輕鬆合併、分割和操作現有的 PDF 文件。 IronPDF 提供如新增頁面、分割文件等功能。

PDF 安全

通過密碼加密或應用數位簽名來保護您的 PDF 文件。 IronPDF 提供選項來保護您的敏感文件免受未經授權的存取。

高品質輸出

生產高品質的 PDF 文件，以精確的文字、圖像和格式渲染。 IronPDF 確保您生成的 PDF 保持原始內容的忠實度。

跨平台相容性

IronPDF可以與多種平台相容，包括Windows，Linux和macOS，適合多種開發環境。

簡單整合

using npm 套件輕鬆將 IronPDF 整合到您的 Node.js 應用中。 API 文件完善，便於在您的專案中加入 PDF 生成功能。

安裝

要安裝IronPDF NPM套裝，請使用以下命令：

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64

SHELL

使用IronPDF生成PDF文件並使用Prettier NPM包

安裝相依性： 首先，按照這裡描述的命令建立一個新的Next.js專案。

npx create-next-app@latest prettier-pdf --use-npm --example "https://github.com/vercel/next-learn/tree/main/basics/learn-starter"

npx create-next-app@latest prettier-pdf --use-npm --example "https://github.com/vercel/next-learn/tree/main/basics/learn-starter"

SHELL

接下來，導航至您的專案目錄：

cd prettier-pdf

cd prettier-pdf

SHELL

安裝所需的套件：

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64
yarn add -D prettier

yarn add @ironsoftware/ironpdf @ironsoftware/ironpdf-engine-windows-x64
yarn add -D prettier

SHELL

建立一個空的配置文件，讓編輯器和其他工具知道您正在使用Prettier：

node --eval "require('fs').writeFileSync('.prettierrc','{}\n')"

node --eval "require('fs').writeFileSync('.prettierrc','{}\n')"

SHELL

建立一個.prettierignore文件，讓Prettier CLI和編輯器知道不應格式化哪些文件。以下是一個範例：

# Ignore artifacts:
build
coverage
# Ignore all HTML files:
**/*.html

# Ignore artifacts:
build
coverage
# Ignore all HTML files:
**/*.html

Text

建立 PDF

現在，讓我們建立一個使用 IronPDF 生成PDF的簡單範例。

**PDF生成API：**第一步是建立一個後端API來生成PDF文件。由於IronPDF僅運行在伺服器端，我們需要建立一個使用者在需要生成PDF時調用的API。在pages/api/pdf.js處建立一個文件，並新增以下內容。

IronPDF需要一個授權金鑰，可以從授權頁面獲得並在以下程式碼中使用。

// pages/api/pdf.js

import { IronPdfGlobalConfig, PdfDocument } from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Your license key";

export default async function handler(req, res) {
  try {
    const url = req.query.url;
    const pdf = await PdfDocument.fromUrl(url);
    const data = await pdf.saveAsBuffer();

    // Configure response headers to ensure the PDF file is downloaded
    res.setHeader("Content-Type", "application/pdf");
    res.setHeader(
      "Content-Disposition",
      "attachment; filename=awesomeIron.pdf"
    );
    res.send(data);
  } catch (error) {
    console.error("Error generating PDF:", error);
    res.status(500).end();
  }
}

// pages/api/pdf.js

import { IronPdfGlobalConfig, PdfDocument } from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Your license key";

export default async function handler(req, res) {
  try {
    const url = req.query.url;
    const pdf = await PdfDocument.fromUrl(url);
    const data = await pdf.saveAsBuffer();

    // Configure response headers to ensure the PDF file is downloaded
    res.setHeader("Content-Type", "application/pdf");
    res.setHeader(
      "Content-Disposition",
      "attachment; filename=awesomeIron.pdf"
    );
    res.send(data);
  } catch (error) {
    console.error("Error generating PDF:", error);
    res.status(500).end();
  }
}

JavaScript

現在修改index.js程式碼以如下所示的方式使用Prettier和IronPDF。

import Head from "next/head";
import styles from "../styles/Home.module.css";
import React, { useState } from "react";

export default function PrettierDemo() {
  const [text, setText] = useState("");

  // Function to generate PDF using the IronPDF backend API
  const generatePdf = async () => {
    try {
      const response = await fetch("/api/pdf?url=" + text);
      const blob = await response.blob();
      const url = window.URL.createObjectURL(new Blob([blob]));
      const link = document.createElement("a");
      link.href = url;
      link.setAttribute("download", "awesomeIron.pdf");
      document.body.appendChild(link);
      link.click();
      link.parentNode.removeChild(link);
    } catch (error) {
      console.error("Error generating PDF:", error);
    }
  };

  // Handle input changes, updating the state
  const handleChange = (event) => {
    setText(event.target.value);
  };

  return (
    <div className={styles.container}>
      <Head>
        <title>Generate PDF Using IronPDF</title>
        <link rel="icon" href="/favicon.ico" />
      </Head>
      <main>
        <h1>Demo Prettier and Generate PDF Using IronPDF</h1>
        <p>
          <span>Enter Url To Convert to PDF:</span>{" "}
          <input type="text" value={text} onChange={handleChange} />
        </p>
        <button style={{margin: 20, padding: 5}} onClick={generatePdf}>
          Generate PDF
        </button>
      </main>
      <style jsx>{`
        main {
          padding: 5rem 0;
          flex: 1;
          display: flex;
          flex-direction: column;
          justify-content: center;
          align-items: center;
        }
      `}</style>
      <style jsx global>{`
        html,
        body {
          padding: 0;
          margin: 0;
          font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto,
            Oxygen, Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue,
            sans-serif;
        }
        * {
          box-sizing: border-box;
        }
      `}</style>
    </div>
  );
}

import Head from "next/head";
import styles from "../styles/Home.module.css";
import React, { useState } from "react";

export default function PrettierDemo() {
  const [text, setText] = useState("");

  // Function to generate PDF using the IronPDF backend API
  const generatePdf = async () => {
    try {
      const response = await fetch("/api/pdf?url=" + text);
      const blob = await response.blob();
      const url = window.URL.createObjectURL(new Blob([blob]));
      const link = document.createElement("a");
      link.href = url;
      link.setAttribute("download", "awesomeIron.pdf");
      document.body.appendChild(link);
      link.click();
      link.parentNode.removeChild(link);
    } catch (error) {
      console.error("Error generating PDF:", error);
    }
  };

  // Handle input changes, updating the state
  const handleChange = (event) => {
    setText(event.target.value);
  };

  return (
    <div className={styles.container}>
      <Head>
        <title>Generate PDF Using IronPDF</title>
        <link rel="icon" href="/favicon.ico" />
      </Head>
      <main>
        <h1>Demo Prettier and Generate PDF Using IronPDF</h1>
        <p>
          <span>Enter Url To Convert to PDF:</span>{" "}
          <input type="text" value={text} onChange={handleChange} />
        </p>
        <button style={{margin: 20, padding: 5}} onClick={generatePdf}>
          Generate PDF
        </button>
      </main>
      <style jsx>{`
        main {
          padding: 5rem 0;
          flex: 1;
          display: flex;
          flex-direction: column;
          justify-content: center;
          align-items: center;
        }
      `}</style>
      <style jsx global>{`
        html,
        body {
          padding: 0;
          margin: 0;
          font-family: -apple-system, BlinkMacSystemFont, Segoe UI, Roboto,
            Oxygen, Ubuntu, Cantarell, Fira Sans, Droid Sans, Helvetica Neue,
            sans-serif;
        }
        * {
          box-sizing: border-box;
        }
      `}</style>
    </div>
  );
}

JavaScript

使用yarn prettier格式化程式碼：

yarn prettier . --write

yarn prettier . --write

SHELL

Prettier - NPM（開發者如何運作）：圖2 - 執行Prettier

現在使用以下命令運行應用程式：

yarn dev

yarn dev

SHELL

輸出

Prettier - NPM（開發者如何運作）：圖3 - Prettier與IronPDF輸出

PDF

Prettier - NPM（開發者如何運作）：圖4 - PDF輸出

IronPDF 授權

IronPDF npm包以授權金鑰運行。 IronPDF提供免費試用授權金鑰，讓使用者在購買前體驗其功能。

將授權金鑰放置在以下占位符中：

import { IronPdfGlobalConfig, PdfDocument } from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Add Your key here";

import { IronPdfGlobalConfig, PdfDocument } from "@ironsoftware/ironpdf";
// Apply your IronPDF license key
IronPdfGlobalConfig.getConfig().licenseKey = "Add Your key here";

JavaScript

結論

Prettier作為現代軟體開發中的基石工具，以精準和高效簡化程式碼格式化。它能夠在不同語言間執行一致的編碼風格，並無縫整合到現有工作流程中，對於追求乾淨且可維護程式碼庫的團隊來說是不可或缺的。通過自動化程式碼格式化任務，Prettier使開發人員能夠把重心放在撰寫優質程式碼上，減少對風格細節的關注，最終提升了軟體專案的生產力和協作性。今天就採用Prettier提升您的程式碼風格質量並精簡開發流程。

IronPDF賦予Node.js開發人員加強其應用程式內PDF處理能力，提供無與倫比的功能、可靠性和性能。通過利用IronPDF的先進功能進行PDF生成、轉換和操作，開發人員可以順利簡化文件工作流程，提升使用者體驗，並滿足多樣的業務需求。採用IronPDF解鎖Node.js專案中PDF處理的全部潛力，輕鬆交付專業級文件解決方案。