Porównanie między npm PDFKit a IronPDF dla Node.js

Kluczowe cechy PDFKit

• Elastyczne generowanie PDF

  PDFKit nie polega na konwersji HTML do PDF; zamiast tego generuje PDF-y bezpośrednio za pomocą kodu JavaScript. To podejście daje deweloperom precyzyjną kontrolę nad układem, stylami oraz treścią plików PDF, które tworzą, więc generowanie skomplikowanych dokumentów jest łatwiejsze.

• Grafika i formatowanie tekstu

  Biblioteka obsługuje zaawansowane możliwości graficzne, w tym linie, krzywe, prostokąty, okręgi i więcej. Funkcje formatowania tekstu takie jak niestandardowe czcionki, rozmiary i kolory umożliwiają tworzenie wizualnie przyjemnych dokumentów.

• Osadzanie obrazów i grafika wektorowa

  PDFKit pozwala na osadzanie obrazów w różnych formatach i obsługuje grafikę wektorową, czyniąc go idealnym dla dokumentów do druku w wysokiej jakości. Osadzanie obrazów obsługuje pliki JPEG i PNG.

• Zaawansowane funkcje dokumentów

  Deweloperzy mogą dodawać adnotacje, zakładki i hiperłącza do swoich PDF-ów. Biblioteka obsługuje również tworzenie nagłówków i stopek oraz wprowadzanie numeracji stron i niestandardowego JavaScript.

• Komponenty dostosowywalne i wielokrotnego użytku

  API PDFKit ułatwia tworzenie komponentów wielokrotnego użytku, usprawniając proces tworzenia dokumentów o powtarzalnych strukturach, takich jak faktury czy raporty.

• Grafika wektorowa

PDFKit oferuje API podobne do HTML5 canvas dla grafiki wektorowej, w tym operacje na ścieżkach, parsowanie ścieżek SVG, transformacje i gradienty. Jest to idealne do tworzenia skalowalnej, wysokiej jakości grafiki w plikach PDF. Biblioteka obsługuje zawijanie tekstu, różne wyrównania tekstu oraz listy punktowane.

• Zagnieżdżone czcionki

PDFKit obsługuje szeroki zakres formatów czcionek, takich jak TrueType, OpenType, WOFF i inne, co pozwala na spójną typografię w plikach PDF. Dostępna jest także redukcja czcionek, co zapewnia, że rozmiar dokumentu pozostaje możliwy do zarządzania.

Kluczowe funkcje IronPDF dla Node.js

Konfiguracja środowiska programistycznego

Zanim zanurzysz się w świat generowania PDF, musisz skonfigurować środowisko projektu. Visual Studio Code (VS Code) zapewnia idealną, przyjazną dla użytkownika platformę do tego. Rozpocznij od uruchomienia VS Code i utworzenia nowego projektu JavaScript. Możesz to zrobić, tworząc nowy folder dla swojego projektu i otwierając go w VS Code. To środowisko będzie miejscem, w którym będziesz pisać kod i zarządzać plikami projektu.

Inicjacja projektu

Gdy folder jest już otwarty w VS Code, następnym krokiem jest zainicjowanie nowego projektu JavaScript. Otwórz zintegrowany terminal w programie VS Code (zwykle znajduje się w menu pod Terminal > Nowy Terminal) i wpisz npm init. To polecenie przeprowadzi cię przez tworzenie pliku package.json, który jest kluczowy dla zarządzania zależnościami i metadanymi projektu.

Dodawanie IronPDF do projektu

Po skonfigurowaniu projektu JavaScript, czas zainstalować bibliotekę IronPDF. W terminalu VS Code uruchom następujące polecenie:

npm install ironpdf

npm install ironpdf

To polecenie pobiera i instalując bibliotekę IronPDF, dodając ją do zależności projektu.

Weryfikacja instalacji

Po instalacji upewnij się, że IronPDF jest wymieniony w pliku package.json w sekcji zależności. To zapewnia, że IronPDF jest prawidłowo zintegrowany z projektem, otwierając możliwości tworzenia i manipulowania PDF-ami.

Integracja PDFKit

Kolejnym krokiem jest PDFKit, solidna i wszechstronna biblioteka do generowania dokumentów PDF. Aby dodać PDFKit do swojego projektu, wykonaj następujące polecenie w terminalu w VS Code:

npm install pdfkit

npm install pdfkit

To zainstaluje PDFKit i doda do zależności twojego projektu.

Zapewnienie poprawnej konfiguracji

Po pomyślnej instalacji zweryfikuj, czy PDFKit pojawia się w zależnościach pliku package.json. To potwierdzenie jest kluczowe, aby upewnić się, że twój projekt jest teraz wyposażony w narzędzia niezbędne do tworzenia skomplikowanych, szczegółowych i wizualnie atrakcyjnych plików PDF.

Konwersja HTML na PDF w IronPDF

import { PdfDocument, PdfGenerator } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";
import fs from "fs";

(async function createPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };
    // Set the config with the license key
    IronPdfGlobalConfig.setConfig(IronPdfConfig);
    // Create a PDF from the HTML String
    const pdf = await PdfDocument.fromHtml(
      "<h1>Hello JavaScript Developers! This is an Example PDF created with IronPDF Node.js!</h1>"
    );
    // Save the PDF document to the file system.
    await pdf.saveAs("HtmlStringToPDF.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

import { PdfDocument, PdfGenerator } from "@ironsoftware/ironpdf";
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";
import fs from "fs";

(async function createPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };
    // Set the config with the license key
    IronPdfGlobalConfig.setConfig(IronPdfConfig);
    // Create a PDF from the HTML String
    const pdf = await PdfDocument.fromHtml(
      "<h1>Hello JavaScript Developers! This is an Example PDF created with IronPDF Node.js!</h1>"
    );
    // Save the PDF document to the file system.
    await pdf.saveAs("HtmlStringToPDF.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

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

(async function createPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };
    // Set the config with the license key
    IronPdfGlobalConfig.setConfig(IronPdfConfig);
    // Create a PDF from the HTML File"
    const pdf = await PdfDocument.fromFile("invoice.html");
    // Save the PDF document to the file system.
    await pdf.saveAs("invoice.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

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

(async function createPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };
    // Set the config with the license key
    IronPdfGlobalConfig.setConfig(IronPdfConfig);
    // Create a PDF from the HTML File"
    const pdf = await PdfDocument.fromFile("invoice.html");
    // Save the PDF document to the file system.
    await pdf.saveAs("invoice.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

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

(async function createPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };
    // Set the config with the license key
    IronPdfGlobalConfig.setConfig(IronPdfConfig);
    // URL of the web page to convert to PDF
    const url = "https://en.wikipedia.org/wiki/PDF";
    // Convert the Web Page to a pixel-perfect PDF file.
    const urlPDF = await PdfDocument.fromUrl(url);
    // Save the document.
    await urlPDF.saveAs("UrlToPdf.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

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

(async function createPDFs() {
  try {
    // Input the license key
    const IronPdfConfig = {
      licenseKey: "Your-License-Key",
    };
    // Set the config with the license key
    IronPdfGlobalConfig.setConfig(IronPdfConfig);
    // URL of the web page to convert to PDF
    const url = "https://en.wikipedia.org/wiki/PDF";
    // Convert the Web Page to a pixel-perfect PDF file.
    const urlPDF = await PdfDocument.fromUrl(url);
    // Save the document.
    await urlPDF.saveAs("UrlToPdf.pdf");
  } catch (error) {
    // Handle errors here
    console.error("An error occurred:", error);
  }
})();

Konwersja HTML na PDF w PDFKit

PDFKit, choć nie jest pierwotnie zaprojektowany do konwersji HTML na PDF jak IronPDF, nadal oferuje sposób na programowe tworzenie dokumentów PDF bezpośrednio z kodu JavaScript. Poniżej znajduje się przykład pokazujący, jak utworzyć prosty plik PDF:

const PDFDocument = require('pdfkit');
const fs = require('fs');

let doc = new PDFDocument();
doc.pipe(fs.createWriteStream('output.pdf'));
doc.fontSize(25)
   .text('PDFKit - Text to PDF Example', 100, 100);
doc.end();

const PDFDocument = require('pdfkit');
const fs = require('fs');

let doc = new PDFDocument();
doc.pipe(fs.createWriteStream('output.pdf'));
doc.fontSize(25)
   .text('PDFKit - Text to PDF Example', 100, 100);
doc.end();

Ten fragment kodu tworzy plik PDF z tekstowym nagłówkiem. Chociaż PDFKit nie konwertuje HTML na PDF bezpośrednio, pozwala na szczegółową kontrolę nad umiejscowieniem i formatowaniem tekstu.

Oto plik wyjściowy wygenerowany przez PDFKit:

IronPDF Node.js

Hasła, bezpieczeństwo i metadane: IronPDF umożliwia deweloperom wzmacnianie bezpieczeństwa plików PDF dzięki różnym funkcjom. Pozwala na ustawienie haseł, dodając dodatkową warstwę ochrony, która wymaga od użytkowników wpisania hasła, aby wyświetlić dokument. Dodatkowo IronPDF dostarcza możliwości osadzania metadanych w pliku PDF, które mogą zawierać informacje o autorze, tytuły i słowa kluczowe, zwiększając tym samym zarządzanie i organizację dokumentów.

import { PdfDocument } from "@ironsoftware/ironpdf";
(async () => {
  // Import a PDF document or create a new PDF from Html
  const pdf = await PdfDocument.open("encrypted.pdf", "password");
  // Create an empty Map
  const newMetadata = new Map();
  // Add key-value pairs of metadata
  newMetadata.set("Author", "Satoshi Nakamoto");
  newMetadata.set("Keywords", "SEO, Friendly");
  await pdf.overrideMetadata(newMetadata);
  await pdf.removePasswordsAndEncryption();
  // Make PDF read-only
  await pdf.makePdfDocumentReadOnly("secret-key");
  // Configure permissions
  const permissions = {
    AllowAnnotations: false,
    AllowExtractContent: false,
    AllowFillForms: false,
    AllowPrint: true,
  };
  await pdf.setPermission(permissions);
  // Change or set the document encryption password
  await pdf.saveAs("secured.pdf", {
    ownerPassword: "top-secret",
    userPassword: "my-password",
  });
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
(async () => {
  // Import a PDF document or create a new PDF from Html
  const pdf = await PdfDocument.open("encrypted.pdf", "password");
  // Create an empty Map
  const newMetadata = new Map();
  // Add key-value pairs of metadata
  newMetadata.set("Author", "Satoshi Nakamoto");
  newMetadata.set("Keywords", "SEO, Friendly");
  await pdf.overrideMetadata(newMetadata);
  await pdf.removePasswordsAndEncryption();
  // Make PDF read-only
  await pdf.makePdfDocumentReadOnly("secret-key");
  // Configure permissions
  const permissions = {
    AllowAnnotations: false,
    AllowExtractContent: false,
    AllowFillForms: false,
    AllowPrint: true,
  };
  await pdf.setPermission(permissions);
  // Change or set the document encryption password
  await pdf.saveAs("secured.pdf", {
    ownerPassword: "top-secret",
    userPassword: "my-password",
  });
})();

Szyfrowanie i deszyfrowanie plików PDF: Szyfrowanie i deszyfrowanie to kluczowe elementy bezpieczeństwa dokumentów, a IronPDF radzi sobie z tym z łatwością. Oferuje różne poziomy szyfrowania, od prostego zabezpieczenia hasłem po zaawansowane standardy szyfrowania, zapewniając, że poufne informacje pozostają bezpieczne. Funkcja deszyfrowania jest równie solidna, zapewniając upoważnionym użytkownikom środki do uzyskania dostępu i modyfikacji zaszyfrowanych dokumentów.

Podpisy cyfrowe: W erze dokumentacji cyfrowej autentyczność i integralność są najważniejsze. Funkcjonalność podpisów cyfrowych IronPDF umożliwia użytkownikom podpisywanie PDF-ów cyfrowo, co nie tylko weryfikuje tożsamość pochodzenia dokumentu, ale również wskazuje, że dokument nie został zmieniony od momentu zastosowania podpisu, co zapewnia jego autentyczność.

import { PdfDocument } from "@ironsoftware/ironpdf";
(async () => {
  // Step 1. Import a PDF
  const pdf = await PdfDocument.open("sample.pdf");
  // Step 2. Sign the PDF with digital certificate
  await pdf.signDigitalSignature({
    certificatePath: "IronSoftware.pfx",
    certificatePassword: "123456",
    signingReason: "To show how to sign a PDF",
    signingLocation: "Chicago, USA",
    signatureImage: {
      SignatureImagePath: "logo.png",
    },
  });
  // Step 3. The PDF is not signed until saved to file.
  await pdf.saveAs("signed.pdf");
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
(async () => {
  // Step 1. Import a PDF
  const pdf = await PdfDocument.open("sample.pdf");
  // Step 2. Sign the PDF with digital certificate
  await pdf.signDigitalSignature({
    certificatePath: "IronSoftware.pfx",
    certificatePassword: "123456",
    signingReason: "To show how to sign a PDF",
    signingLocation: "Chicago, USA",
    signatureImage: {
      SignatureImagePath: "logo.png",
    },
  });
  // Step 3. The PDF is not signed until saved to file.
  await pdf.saveAs("signed.pdf");
})();

Kompresja plików PDF: IronPDF rozumie potrzebę wydajnego przechowywania i szybkiego udostępniania dokumentów. Zawiera funkcję kompresji PDF, która znacznie zmniejsza rozmiar pliku, co jest kluczowe dla optymalizacji przestrzeni magazynowej i przyspieszenia transmisji dokumentu bez utraty jakości i integralności zawartości wewnątrz PDF-ów.

import { PdfDocument } from "@ironsoftware/ironpdf";
(async () => {
  // Load the existing PDF document
  const pdf = await PdfDocument.fromFile("my-content.pdf");
  // Compress images with quality parameter (1-100)
  await pdf.compressSize(60);
  // Save the compressed PDF
  await pdf.saveAs("document_compressed.pdf");
  // Compress images and scale down based on visible size in the PDF document
  await pdf.compressSize(90, true);
  // Save the scaled and compressed PDF
  await pdf.saveAs("document_scaled_compressed.pdf");
})();

import { PdfDocument } from "@ironsoftware/ironpdf";
(async () => {
  // Load the existing PDF document
  const pdf = await PdfDocument.fromFile("my-content.pdf");
  // Compress images with quality parameter (1-100)
  await pdf.compressSize(60);
  // Save the compressed PDF
  await pdf.saveAs("document_compressed.pdf");
  // Compress images and scale down based on visible size in the PDF document
  await pdf.compressSize(90, true);
  // Save the scaled and compressed PDF
  await pdf.saveAs("document_scaled_compressed.pdf");
})();

Łączenie dwóch lub więcej plików PDF: IronPDF zapewnia prostą możliwość połączenia wielu dokumentów PDF w jeden plik. Funkcja ta jest niezwykle użyteczna przy łączeniu różnych dokumentów takich jak raporty, umowy czy serie formularzy, ułatwiając lepsze zarządzanie i dystrybucję dokumentów.

Usuwanie konkretnych stron z pliku PDF: Elastyczność w edycji jest kluczowa dla każdego narzędzia do obsługi PDF, a IronPDF oferuje możliwość usunięcia konkretnych stron z dokumentu PDF. Jest to szczególnie przydatne podczas dopasowywania zawartości dla różnych odbiorców lub omijania niepotrzebnych stron, aby stworzyć bardziej zwięzły dokument.

Zaawansowane funkcje i rozbudowa PDFKit

Dostosowywalny silnik układu: PDFKit funkcjonuje jako dostosowywalny silnik układu, dając deweloperom kontrolę nad każdym aspektem układu PDF, od umiejscowienia tekstu po złożone elementy graficzne.

const PDFDocument = require('pdfkit');
const fs = require('fs');

let doc = new PDFDocument({ margin: 50 });
// Custom layouts
doc.text('Customized Layout Text', {
  align: 'center',
  valign: 'center',
});
doc.end();
doc.pipe(fs.createWriteStream('custom-layout.pdf'));

const PDFDocument = require('pdfkit');
const fs = require('fs');

let doc = new PDFDocument({ margin: 50 });
// Custom layouts
doc.text('Customized Layout Text', {
  align: 'center',
  valign: 'center',
});
doc.end();
doc.pipe(fs.createWriteStream('custom-layout.pdf'));

W tym przykładzie, PDFDocument jest używany do stworzenia niestandardowego układu z wycentrowanym tekstem.

Zaawansowane funkcje grafiki i tekstu: PDFKit oferuje zaawansowane funkcje grafiki i tekstu, umożliwiając skomplikowane projektowanie i stylizację w plikach PDF. Pozwala na rysowanie kształtów oraz dodawanie obrazów i SVG-ów. Jeśli chodzi o tekst, PDFKit oferuje pełny zakres opcji układu, od podstawowych pól tekstowych po zaawansowane kontrole typografii, zapewniając, że układ każdej strony jest dokładnie taki, jak zamierzono.

const PDFDocument = require('pdfkit');
const fs = require('fs');

let doc = new PDFDocument();
// Advanced graphics
doc.moveTo(100, 150)
   .lineTo(100, 250)
   .lineTo(200, 250)
   .fill("#FF3300");
// Advanced text
doc.fontSize(15)
   .font('Times-Roman')
   .text('Advanced Text Features', 100, 300);
doc.end();
doc.pipe(fs.createWriteStream('advanced-graphics-text.pdf'));

const PDFDocument = require('pdfkit');
const fs = require('fs');

let doc = new PDFDocument();
// Advanced graphics
doc.moveTo(100, 150)
   .lineTo(100, 250)
   .lineTo(200, 250)
   .fill("#FF3300");
// Advanced text
doc.fontSize(15)
   .font('Times-Roman')
   .text('Advanced Text Features', 100, 300);
doc.end();
doc.pipe(fs.createWriteStream('advanced-graphics-text.pdf'));

Obsługa strumieni i buforów: PDFKit wyróżnia się w obsłudze strumieni i buforów, umożliwiając efektywne zarządzanie dużymi plikami PDF i ich danymi.

const PDFDocument = require('pdfkit');
const fs = require('fs');
const stream = require('stream');

let doc = new PDFDocument();
let buffers = [];
let writableStream = new stream.Writable();
writableStream._write = (chunk, encoding, done) => {
  buffers.push(chunk);
  done();
};

doc.pipe(writableStream);
doc.text('Streaming PDF Content');
doc.end();
writableStream.on('finish', () => {
  let pdfData = Buffer.concat(buffers);
  fs.writeFileSync('streamed.pdf', pdfData);
});

const PDFDocument = require('pdfkit');
const fs = require('fs');
const stream = require('stream');

let doc = new PDFDocument();
let buffers = [];
let writableStream = new stream.Writable();
writableStream._write = (chunk, encoding, done) => {
  buffers.push(chunk);
  done();
};

doc.pipe(writableStream);
doc.text('Streaming PDF Content');
doc.end();
writableStream.on('finish', () => {
  let pdfData = Buffer.concat(buffers);
  fs.writeFileSync('streamed.pdf', pdfData);
});

Dostosowywalne nagłówki i stopki: Tworzenie profesjonalnie wyglądającego PDF-a wymaga dbałości o detale. PDFKit oferuje funkcję dostosowywalnych nagłówków i stopek, umożliwiając precyzyjne umieszczanie tekstu i grafiki na górze i dole stron. Jest to szczególnie przydatne do dodawania spójnego charakteru, tytułów dokumentów i numeracji stron w wielostronicowym dokumencie.

Interaktywne formularze: PDFKit rozbudowuje swoje możliwości do interaktywnych formularzy w plikach PDF, umożliwiając tworzenie pól tekstowych, pól wyboru i przycisków radiowych. Funkcja ta jest nieoceniona dla użytkowników, którzy chcą zbierać informacje lub dostarczać interaktywną zawartość, poprawiając doświadczenia użytkownika i funkcjonalność pliku PDF.

Dokumentacja i wsparcie IronPDF Node.js

Jakość i dostępność dokumentacji PDFKit

Licencja IronPDF

IronPDF działa na modelu licencjonowania komercyjnego, co oznacza, że deweloperzy lub firmy muszą zakupić licencję, aby używać biblioteki w swoich projektach bez ograniczeń.

Lite: Kosztująca $999, ta jednorazowa opłata zapewnia podstawowy pakiet odpowiedni dla mniejszych projektów.

Professional: W cenie $1,499, ta wersja jest przeznaczona do użytku profesjonalnego, oferując więcej funkcji i możliwości.

Unlimited: Wersja Unlimited kosztuje $2,999 i jest idealna do dużych wdrożeń, zapewniając pełny dostęp do wszystkich funkcji bez ograniczeń.

IronPDF oferuje również bezpłatną wersję próbną, umożliwiającą deweloperom ocenę biblioteki przed dokonaniem zakupu. Nie ma dostępnej bezpłatnej lub freemium wersji, a premium konsultacje lub usługi integracji nie są oferowane.

Licencja PDFKit

PDFKit jest biblioteką open-source, dostępną na licencji MIT. Ta liberalna licencja pozwala na bezpłatne użycie, modyfikację i dystrybucję oprogramowania. Jako projekt open-source, PDFKit nie posiada struktury cenowej. Można go swobodnie wprowadzać do każdego projektu, a użytkownicy mogą przyczynić się do jego rozwoju poprzez GitHub. Projekt akceptuje dotacje, które nie są obowiązkowe, ale wspierają bieżący rozwój i utrzymanie biblioteki.