Uma comparação entre PDFKit npm e IronPDF for Node.js

Principais funcionalidades do PDFKit

• Geração flexível de PDFs

  O PDFKit não depende da conversão de HTML para PDF; Em vez disso, ele gera PDFs diretamente por meio de código JavaScript . Essa abordagem oferece aos desenvolvedores controle preciso sobre o layout, o estilo e o conteúdo dos arquivos PDF que criam, facilitando a geração de documentos complexos.

• Formatação de gráficos e texto

  A biblioteca oferece suporte a recursos gráficos avançados, incluindo linhas, curvas, retângulos, círculos e muito mais. Recursos de formatação de texto, como fontes, tamanhos e cores personalizados, permitem a criação de documentos visualmente atraentes.

• Incorporação de imagens e gráficos vetoriais

  O PDFKit permite a incorporação de imagens em vários formatos e suporta gráficos vetoriais, sendo ideal para documentos de impressão de alta qualidade. A incorporação de imagens suporta arquivos JPEG e PNG.

• Recursos avançados de documentos

  Os desenvolvedores podem adicionar anotações, marcadores e hiperlinks aos seus PDFs. A biblioteca também suporta a criação de cabeçalhos e rodapés, bem como a inclusão de números de página e JavaScript personalizado.

• Componentes personalizáveis ​​e reutilizáveis

  A API do PDFKit facilita a criação de componentes reutilizáveis, agilizando o processo de desenvolvimento de documentos com estruturas repetitivas, como faturas ou relatórios.

• Gráficos vetoriais

  O PDFKit oferece uma API semelhante à tela HTML5 para gráficos vetoriais, incluindo operações de caminho, análise de caminhos SVG, transformações e gradientes. Esta ferramenta é ideal para criar gráficos escaláveis ​​e de alta qualidade em PDFs. A biblioteca suporta quebra automática de linha, vários alinhamentos de texto e listas com marcadores.

• Fontes incorporadas

  O PDFKit suporta uma ampla variedade de formatos de fonte, como TrueType, OpenType, WOFF e muitos outros, permitindo uma tipografia consistente em PDFs. A possibilidade de selecionar fontes específicas também está disponível, garantindo que o tamanho do documento permaneça gerenciável.

Principais funcionalidades do IronPDF for Node.js

Configurando seu ambiente de desenvolvimento

Antes de mergulhar no mundo da geração de PDFs, você precisa configurar o ambiente do seu projeto. O Visual Studio Code (VS Code) oferece uma plataforma ideal e fácil de usar para isso. Comece por abrir o VS Code e criar um novo projeto JavaScript . Você pode fazer isso criando uma nova pasta para o seu projeto e abrindo-a no VS Code. Este ambiente será onde você escreverá seu código e gerenciará os arquivos do seu projeto.

Inicializando seu projeto

Depois de abrir a pasta no VS Code, o próximo passo é inicializar um novo projeto JavaScript . Abra o terminal integrado no VS Code (normalmente encontrado em Terminal > Novo Terminal no menu) e digite npm init. Este comando irá orientá-lo na criação de um arquivo package.json, que é crucial para gerenciar as dependências e os metadados do seu projeto.

Adicionando o IronPDF ao seu projeto

Com seu projeto JavaScript configurado, é hora de instalar a biblioteca IronPDF . No terminal do VS Code, execute o seguinte comando:

npm install ironpdf

npm install ironpdf

Este comando baixa e instala a biblioteca IronPDF , adicionando-a às dependências do seu projeto.

Verificando a instalação

Após a instalação, certifique-se de que o IronPDF esteja listado no seu arquivo package.json na seção de dependências. Isso garante que o IronPDF seja integrado corretamente ao seu projeto, abrindo caminho para a geração e manipulação perfeitas de PDFs.

Integrando o PDFKit

Em seguida, temos o PDFKit, uma biblioteca robusta e versátil para geração de documentos PDF. Para adicionar o PDFKit ao seu projeto, execute o seguinte comando no terminal do VS Code:

npm install pdfkit

npm install pdfkit

Isso instalará o PDFKit e o adicionará às dependências do seu projeto.

Garantir a configuração correta

Após a instalação bem-sucedida, verifique se o PDFKit aparece nas dependências do seu arquivo package.json . Essa confirmação é crucial para garantir que seu projeto agora possui as ferramentas necessárias para criar arquivos PDF complexos, detalhados e visualmente atraentes.

Conversão de HTML para PDF com 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);
  }
})();

Conversão de HTML para PDF com PDFKit

O PDFKit, embora não tenha sido projetado principalmente para conversão de HTML para PDF como o IronPDF, ainda oferece uma maneira de criar documentos PDF programaticamente diretamente a partir de código JavaScript . Abaixo segue um exemplo que demonstra como criar um arquivo PDF simples:

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();

Este trecho de código cria um arquivo PDF com um título em texto. Embora o PDFKit não converta HTML em PDF diretamente, ele permite um controle detalhado sobre o posicionamento e a formatação do texto.

Aqui está o arquivo de saída gerado pelo PDFKit:

IronPDF Node.js

Senhas, segurança e metadados : o IronPDF permite que os desenvolvedores reforcem a segurança de seus arquivos PDF por meio de diversos recursos. Permite a definição de senhas, adicionando uma camada extra de proteção que exige que os usuários insiram uma senha para visualizar o documento. Além disso, o IronPDF oferece a capacidade de incorporar metadados no PDF, que podem incluir informações sobre o autor, títulos e palavras-chave, aprimorando assim o gerenciamento e a organização de documentos.

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",
  });
})();

Criptografia e descriptografia de PDFs: A criptografia e a descriptografia são componentes vitais da segurança de documentos, e o IronPDF lida com isso com facilidade. Oferece diferentes níveis de criptografia, desde a simples proteção por senha até padrões avançados de criptografia, garantindo que as informações confidenciais permaneçam seguras. O recurso de descriptografia é igualmente robusto, fornecendo aos usuários autorizados os meios para acessar e modificar documentos criptografados.

Assinaturas digitais: na era da documentação digital, autenticidade e integridade são fundamentais. A funcionalidade de assinaturas digitais do IronPDF permite que os usuários assinem seus PDFs digitalmente, o que não só verifica a identidade do autor do documento, mas também indica que o documento não foi alterado desde a aplicação da assinatura, garantindo assim sua autenticidade.

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");
})();

Compressão de PDF: O IronPDF reconhece a necessidade de armazenamento eficiente e compartilhamento rápido de documentos. Inclui um recurso de compressão de PDF que reduz significativamente o tamanho dos arquivos, o que é crucial para otimizar o espaço de armazenamento e agilizar a transmissão de documentos sem comprometer a qualidade e a integridade do conteúdo dos PDFs.

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");
})();

Mesclar dois ou mais PDFs: O IronPDF oferece uma solução simples para mesclar vários documentos PDF em um único arquivo . Essa funcionalidade é extremamente útil para combinar diversos documentos, como relatórios, contratos ou séries de formulários, facilitando o gerenciamento e a distribuição de documentos.

Remover páginas específicas de um PDF: A flexibilidade na edição é fundamental para qualquer ferramenta de PDF, e o IronPDF oferece a capacidade de remover páginas específicas de um documento PDF . Isso é especialmente útil ao adaptar o conteúdo para diferentes públicos ou ao omitir páginas desnecessárias para criar um documento mais conciso.

Recursos avançados e extensibilidade do PDFKit

Mecanismo de layout personalizável: O PDFKit apresenta um mecanismo de layout personalizável, dando aos desenvolvedores controle sobre todos os aspectos do layout do PDF, desde o posicionamento do texto até elementos gráficos complexos.

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'));

Neste exemplo, PDFDocument é usado para criar um layout personalizado com texto centralizado.

Recursos avançados de gráficos e texto: O PDFKit oferece recursos avançados de gráficos e texto, permitindo design e estilização complexos em arquivos PDF. Permite desenhar formas e adicionar imagens e arquivos SVG. No que diz respeito ao texto, o PDFKit oferece um conjunto completo de opções de layout, desde caixas de texto básicas até controles tipográficos avançados, garantindo que o layout de cada página seja exatamente como foi idealizado.

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'));

Manipulação de fluxos e buffers: O PDFKit se destaca na manipulação de fluxos e buffers, permitindo o gerenciamento eficiente de arquivos PDF grandes e seus dados.

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);
});

Cabeçalhos e rodapés personalizáveis: Criar um PDF com aparência profissional exige atenção aos detalhes. O recurso de cabeçalhos e rodapés personalizáveis ​​do PDFKit permite o posicionamento preciso de texto e gráficos na parte superior e inferior das páginas. Isso é particularmente útil para adicionar identidade visual consistente, títulos de documentos e paginação em um documento com várias páginas.

Formulários interativos: O PDFKit amplia suas funcionalidades para formulários interativos em seus arquivos PDF, permitindo a criação de campos de texto, caixas de seleção e botões de opção. Essa funcionalidade é essencial para usuários que desejam coletar informações ou fornecer conteúdo interativo, aprimorando a experiência do usuário e a funcionalidade do PDF.

Documentação e suporte do IronPDF for Node.js

Qualidade e disponibilidade da documentação do PDFKit

Licença do IronPDF

O IronPDF opera com um modelo de licenciamento comercial, o que significa que desenvolvedores ou empresas precisam adquirir uma licença para usar a biblioteca em seus projetos sem limitações.

Lite: Com preço de $799, esta taxa única oferece um pacote básico adequado para projetos menores.

Profissional: Na $1,199, este nível é para uso profissional, oferecendo mais recursos e capacidades.

Ilimitado: O plano ilimitado tem o preço de $2,399 e é ideal para implantações em larga escala, fornecendo acesso total a todos os recursos sem restrições.

O IronPDF também oferece uma versão de avaliação gratuita , permitindo que os desenvolvedores avaliem a biblioteca antes de efetuar a compra. Não existe versão gratuita ou freemium disponível, e serviços premium de consultoria ou integração não são oferecidos.

Licença PDFKit

O PDFKit é uma biblioteca de código aberto disponível sob a Licença MIT. Esta licença permissiva permite o uso, a modificação e a distribuição gratuitos do software. Por ser um projeto de código aberto, o PDFKit não possui uma estrutura de preços. Ele pode ser incorporado livremente em qualquer projeto, e os usuários podem contribuir para o seu desenvolvimento através do GitHub. O projeto aceita doações, que não são obrigatórias, mas contribuem para o desenvolvimento e a manutenção contínuos da biblioteca.