Cómo combinar archivos PDF en un único PDF con Node.js

¿Cómo fusiono varios archivos PDF en Node.js?

PdfDocument.merge() acepta un conjunto de objetos PdfDocument y devuelve un nuevo documento que contiene cada página en el orden en que aparecen los documentos fuente en el conjunto. La operación no es destructiva; los objetos de archivo originales no se modifican.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-pdfs.js
const IronPdf = require('ironpdf');

async function mergePdfs(outputFilePath, inputFiles) {
  // Load all source documents in parallel
  const pdfDocs = await Promise.all(
    inputFiles.map(file => IronPdf.PdfDocument.fromFile(file))
  );

  // Combine into one document, preserving page order
  const mergedPdf = await IronPdf.PdfDocument.merge(pdfDocs);

  // Write the result to disk
  await mergedPdf.toFile(outputFilePath);
  console.log(`Merged PDF saved to ${outputFilePath}`);
}

(async () => {
  const inputFiles = ['report-jan.pdf', 'report-feb.pdf', 'report-mar.pdf'];
  await mergePdfs('quarterly-report.pdf', inputFiles);
})();

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-pdfs.js
const IronPdf = require('ironpdf');

async function mergePdfs(outputFilePath, inputFiles) {
  // Load all source documents in parallel
  const pdfDocs = await Promise.all(
    inputFiles.map(file => IronPdf.PdfDocument.fromFile(file))
  );

  // Combine into one document, preserving page order
  const mergedPdf = await IronPdf.PdfDocument.merge(pdfDocs);

  // Write the result to disk
  await mergedPdf.toFile(outputFilePath);
  console.log(`Merged PDF saved to ${outputFilePath}`);
}

(async () => {
  const inputFiles = ['report-jan.pdf', 'report-feb.pdf', 'report-mar.pdf'];
  await mergePdfs('quarterly-report.pdf', inputFiles);
})();

Promise.all() carga los archivos fuente en paralelo en lugar de uno a la vez, lo cual es importante al procesar colecciones más grandes. La llamada merge() concatena los documentos en el orden del conjunto, por lo que coloque los archivos en el conjunto en la secuencia que desea que aparezcan en la salida.

¿Cómo fusiono páginas específicas de cada PDF?

Pasar cada página de cada documento fuente no siempre es el objetivo. Para fusionar rangos de páginas selectivos de cada archivo de entrada, extraiga las páginas deseadas antes de pasar los documentos a merge().

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-specific-pages.js
const IronPdf = require('ironpdf');

// Each entry specifies a file and the range of pages to include (zero-indexed)
const pageRanges = [
  { file: 'contract.pdf',  startPage: 0, endPage: 2 },
  { file: 'appendix.pdf',  startPage: 0, endPage: 0 },
  { file: 'signature.pdf', startPage: 0, endPage: 0 },
];

async function mergeSpecificPages(outputFile, ranges) {
  const pdfsToMerge = [];

  for (const range of ranges) {
    const pdf = await IronPdf.PdfDocument.fromFile(range.file);
    // extractPages returns a new PdfDocument with only the specified page range
    const pages = pdf.extractPages(range.startPage, range.endPage);
    pdfsToMerge.push(pages);
  }

  const merged = await IronPdf.PdfDocument.merge(pdfsToMerge);
  await merged.toFile(outputFile);
}

mergeSpecificPages('assembled-contract.pdf', pageRanges);

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-specific-pages.js
const IronPdf = require('ironpdf');

// Each entry specifies a file and the range of pages to include (zero-indexed)
const pageRanges = [
  { file: 'contract.pdf',  startPage: 0, endPage: 2 },
  { file: 'appendix.pdf',  startPage: 0, endPage: 0 },
  { file: 'signature.pdf', startPage: 0, endPage: 0 },
];

async function mergeSpecificPages(outputFile, ranges) {
  const pdfsToMerge = [];

  for (const range of ranges) {
    const pdf = await IronPdf.PdfDocument.fromFile(range.file);
    // extractPages returns a new PdfDocument with only the specified page range
    const pages = pdf.extractPages(range.startPage, range.endPage);
    pdfsToMerge.push(pages);
  }

  const merged = await IronPdf.PdfDocument.merge(pdfsToMerge);
  await merged.toFile(outputFile);
}

mergeSpecificPages('assembled-contract.pdf', pageRanges);

extractPages(startPage, endPage) acepta índices de páginas basados en cero. Pasar 0, 0 extrae solo la primera página, mientras que 0, 2 extrae las primeras tres páginas. El bucle construye un conjunto de documentos de rango de páginas en el orden en que aparecen en ranges, luego merge() los concatena en la salida final.

Este patrón es útil cuando se ensamblan contratos a partir de una página de firma, un apéndice y una hoja de portada almacenados en archivos separados. Puede recopilar exactamente las páginas que importan de cada fuente sin duplicar archivos en el disco.

Mi biblioteca favorita de este tipo es IronPDF. Permite una manipulación rápida y eficiente de archivos PDF. También tiene muchas funciones valiosas, como exportar al formato PDF/A y firmar documentos PDF digitalmente.

Milan Jovanovic

Microsoft MVP

Ver estudio de caso

IronOCR significa que podemos ahorrar $40,000 anualmente en el procesamiento manual, mientras mejoramos la productividad y liberamos recursos para tareas de alto impacto. Lo recomendaría encarecidamente.

Brent Matzelle

Director de Tecnología, OPYN

Ver estudio de caso

El Iron Suite juega un papel crucial en nuestras operaciones. Estas son herramientas que aumentan la eficiencia en toda la empresa, incluyendo la creación de planos y la mejora en la gestión de inventario.

David Jones

Ingeniero de Software Principal, Agorus Build

Ver estudio de caso

¿Cómo agrego encabezados y pies de página a un PDF fusionado?

Después de fusionar, llame a addHtmlHeader() y addHtmlFooter() en el documento resultante para aplicar encabezados y pies de página consistentes en todas las páginas. Estos métodos aceptan una cadena HTML y un objeto de opciones.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-headers-footers.js
const IronPdf = require('ironpdf');

async function mergeWithHeadersFooters(inputFiles, outputFile) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Apply a styled header to every page
  await mergedPdf.addHtmlHeader('<h3 style="color:#333;">Quarterly Report</h3>', {
    height: 25,
    drawDividerLine: true,
  });

  // Apply a page-numbering footer
  await mergedPdf.addHtmlFooter('<p style="font-size:10px;">Page {page} of {total-pages}</p>', {
    height: 20,
    drawDividerLine: true,
  });

  await mergedPdf.toFile(outputFile);
}

mergeWithHeadersFooters(['q1.pdf', 'q2.pdf', 'q3.pdf'], 'annual-report.pdf');

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-headers-footers.js
const IronPdf = require('ironpdf');

async function mergeWithHeadersFooters(inputFiles, outputFile) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Apply a styled header to every page
  await mergedPdf.addHtmlHeader('<h3 style="color:#333;">Quarterly Report</h3>', {
    height: 25,
    drawDividerLine: true,
  });

  // Apply a page-numbering footer
  await mergedPdf.addHtmlFooter('<p style="font-size:10px;">Page {page} of {total-pages}</p>', {
    height: 20,
    drawDividerLine: true,
  });

  await mergedPdf.toFile(outputFile);
}

mergeWithHeadersFooters(['q1.pdf', 'q2.pdf', 'q3.pdf'], 'annual-report.pdf');

Los marcadores de posición {page} y {total-pages} se resuelven en el momento de la renderización frente al recuento de páginas del documento fusionado. Utilice drawDividerLine: true para separar visualmente el encabezado o pie de página del contenido de la página.

Aplicar encabezados y pies de página después de la fusión significa que cada página en el documento combinado recibe el mismo tratamiento, sin importar de qué archivo fuente provenga. Para opciones completas de configuración de encabezados y pies de página, consulte los ejemplos de encabezados y pies de página HTML.

¿Cómo protejo un PDF fusionado con una contraseña?

Aplique protección por contraseña y restricciones de permisos después de fusionar llamando a saveAs() con un objeto de opciones de seguridad. Esto previene el acceso no autorizado al documento combinado.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-security.js
const IronPdf = require('ironpdf');

async function mergeWithSecurity(inputFiles, outputFile) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Restrict the merged document to print-only access
  await mergedPdf.saveAs(outputFile, {
    userPassword: 'viewerpass',
    ownerPassword: 'adminpass',
    allowUserAnnotations: false,
    allowUserCopyPasteContent: false,
    allowUserFormData: false,
    allowUserPrinting: true,
  });
}

mergeWithSecurity(['invoice-1.pdf', 'invoice-2.pdf'], 'secured-invoices.pdf');

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-security.js
const IronPdf = require('ironpdf');

async function mergeWithSecurity(inputFiles, outputFile) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Restrict the merged document to print-only access
  await mergedPdf.saveAs(outputFile, {
    userPassword: 'viewerpass',
    ownerPassword: 'adminpass',
    allowUserAnnotations: false,
    allowUserCopyPasteContent: false,
    allowUserFormData: false,
    allowUserPrinting: true,
  });
}

mergeWithSecurity(['invoice-1.pdf', 'invoice-2.pdf'], 'secured-invoices.pdf');

El userPassword es necesario para abrir el documento; el ownerPassword controla las configuraciones de permiso en sí mismas. Establecer allowUserPrinting: true mientras deshabilita otras banderas de permiso permite que los destinatarios impriman el documento, pero impide la edición, copia y anotación. Para una lista completa de las banderas de permiso disponibles, consulte la Referencia de API de IronPDF Node.js.

¿Cómo fusiono PDFs y agrego una firma digital?

Fusionar PDFs y luego firmar inmediatamente el resultado produce un único documento firmado que cubre todo el contenido fuente. Aplique applySignature() después de merge() para adjuntar un certificado digital a la salida combinada.

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-signature.js
const IronPdf = require('ironpdf');

async function mergeAndSign(inputFiles, outputFile, pfxPath, pfxPassword) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Attach a digital signature using a PFX certificate
  await mergedPdf.applySignature(pfxPath, pfxPassword);
  await mergedPdf.toFile(outputFile);
}

mergeAndSign(
  ['section-a.pdf', 'section-b.pdf'],
  'signed-report.pdf',
  'certificate.pfx',
  'certpass'
);

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-merge-pdf/merge-with-signature.js
const IronPdf = require('ironpdf');

async function mergeAndSign(inputFiles, outputFile, pfxPath, pfxPassword) {
  const docs = await Promise.all(
    inputFiles.map(f => IronPdf.PdfDocument.fromFile(f))
  );
  const mergedPdf = await IronPdf.PdfDocument.merge(docs);

  // Attach a digital signature using a PFX certificate
  await mergedPdf.applySignature(pfxPath, pfxPassword);
  await mergedPdf.toFile(outputFile);
}

mergeAndSign(
  ['section-a.pdf', 'section-b.pdf'],
  'signed-report.pdf',
  'certificate.pfx',
  'certpass'
);

El método applySignature() incrusta el certificado en los metadatos del PDF para que los lectores puedan verificar la integridad del documento. Este flujo de trabajo es común en tuberías de ensamblaje de contratos donde se combinan múltiples secciones y luego se co-firman antes de la distribución. Para una guía completa sobre la firma basada en certificados, consulte los ejemplos de firmas digitales.

¿Cómo soluciono los errores comunes al fusionar PDFs?

La mayoría de los errores durante la fusión pertenecen a cuatro categorías: archivos faltantes, agotamiento de memoria, entradas dañadas y problemas de permiso. La siguiente tabla enumera las causas más frecuentes y cómo abordar cada una.

Para problemas de configuración específicos del entorno, el cambios de IronPDF documentan problemas conocidos y soluciones. Si los problemas persisten después de revisar la tabla anterior, envuelva la llamada de fusión en un bloque try-catch para mostrar el mensaje completo de error de la biblioteca.

Node.js en sí proporciona herramientas útiles para la validación de rutas previa al vuelo. El método Node.js fs.promises.access le permite verificar si un archivo es legible antes de pasarlo a IronPDF. Para preguntas sobre cómo manejan escenarios de errores similares otros desarrolladores de la comunidad, el hilo de Stack Overflow sobre la fusión de PDFs en Node.js proporciona contexto adicional.

¿Cuáles son los próximos pasos para fusionar PDFs en Node.js?

Los ejemplos anteriores cubren los escenarios de fusión más comunes: combinación básica de archivos, selección de rango de páginas, inyección de encabezados y pies de página, protección con contraseña y firma digital. IronPDF también admite manejar formularios PDF a través de páginas fusionadas, estampar nuevo contenido en el documento combinado y producir imágenes rasterizadas del resultado final para la generación de vistas previas.

Inicie su prueba gratuita de 30 días para probar la fusión sin una marca de agua, o vea las opciones de licencia si está listo para implementarlo.

¿Listo para ver qué más puede hacer IronPDF? Visite la documentación de IronPDF for Node.js para un recorrido completo por la API y guías adicionales.