Comment fusionner des fichiers PDF en un seul PDF à l'aide de Node.js

Comment fusionner plusieurs fichiers PDF dans Node.js ?

PdfDocument.merge() accepte un tableau d'objets PdfDocument et retourne un nouveau document contenant chaque page dans l'ordre où les documents sources apparaissent dans le tableau. L'opération est non destructive ; les objets de fichier originaux ne sont pas modifiés.

//: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() charge les fichiers sources en parallèle plutôt qu'un par un, ce qui est important lors du traitement de collections plus importantes. L'appel merge() concatène les documents dans l'ordre du tableau, alors placez les fichiers dans le tableau dans la séquence dans laquelle vous voulez qu'ils apparaissent dans le résultat.

Comment fusionner des pages spécifiques de chaque PDF ?

Passer chaque page de chaque document source n'est pas toujours l'objectif. Pour fusionner les plages de pages sélectives de chaque fichier d'entrée, extrayez les pages souhaitées avant de passer les documents à 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) accepte des indices de pages basés sur zéro. Passer 0, 0 extrait uniquement la première page, tandis que 0, 2 extrait les trois premières pages. La boucle construit un tableau de documents de plage de pages dans l'ordre où ils apparaissent dans ranges, puis merge() les concatène dans le résultat final.

Ce modèle est utile lors de l'assemblage de contrats à partir d'une page de signature, d'une annexe et d'une page de couverture stockées dans des fichiers séparés. Vous pouvez collecter exactement les pages importantes de chaque source sans dupliquer les fichiers sur le disque.

Ma bibliothèque préférée de ce genre est IronPDF. Elle permet une manipulation rapide et efficace des fichiers PDF. Elle dispose également de nombreuses fonctionnalités précieuses, comme l'exportation au format PDF/A et la signature numérique des documents PDF.

Milan Jovanovic

Microsoft MVP

Voir l'étude de cas

IronOCR signifie que nous pouvons économiser 40 000 $ par an grâce au traitement manuel, tout en améliorant la productivité et en libérant des ressources pour des tâches à fort impact. Je le recommande vivement.

Brent Matzelle

Directeur technique, OPYN

Voir l'étude de cas

Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.

David Jones

Ingénieur logiciel principal, Agorus Build

Voir l'étude de cas

Comment ajouter des en-têtes et des pieds de page à un PDF fusionné ?

Après la fusion, appelez addHtmlHeader() et addHtmlFooter() sur le document résultant pour appliquer des en-têtes et pieds de page cohérents sur toutes les pages. Ces méthodes acceptent une chaîne HTML et un objet options.

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

Les espaces réservés {page} et {total-pages} sont résolus au moment du rendu en fonction du nombre de pages du document fusionné. Utilisez drawDividerLine: true pour séparer visuellement l'en-tête ou le pied de page du contenu de la page.

Appliquer des en-têtes et pieds de page après la fusion signifie que chaque page du document combiné reçoit le même traitement, peu importe de quel fichier source elle provient. Pour connaître toutes les options de configuration des en-têtes et des pieds de page, consultez les exemples d'en-têtes et de pieds de page HTML.

Comment protéger un PDF fusionné par mot de passe ?

Appliquez une protection par mot de passe et des restrictions de permission après la fusion en appelant saveAs() avec un objet d'options de sécurité. Cela empêche tout accès non autorisé au document combiné.

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

Le userPassword est requis pour ouvrir le document ; le ownerPassword contrôle les paramètres de permission eux-mêmes. Définir allowUserPrinting: true tout en désactivant d'autres indicateurs d'autorisation permet aux destinataires d'imprimer le document mais empêche l'édition, la copie et l'annotation. Pour une liste complète des indicateurs de permission disponibles, consultez la référence API IronPDF Node.js.

Comment fusionner des PDF et ajouter une signature numérique ?

La fusion de PDF et la signature immédiate du résultat produisent un document unique signé qui couvre tout le contenu source. Appliquez applySignature() après merge() pour attacher un certificat numérique à la sortie combinée.

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

La méthode applySignature() intègre le certificat dans les métadonnées du PDF afin que les lecteurs puissent vérifier l'intégrité du document. Ce flux de travail est courant dans les pipelines d'assemblage de contrats où plusieurs sections sont combinées puis co-signées avant distribution. Pour une visite complète de la signature basée sur certificat, consultez les exemples de signatures numériques.

Comment résoudre les erreurs de fusion PDF courantes ?

La plupart des erreurs lors de la fusion appartiennent à quatre catégories : fichiers manquants, épuisement de la mémoire, entrées corrompues et problèmes de permission. Le tableau ci-dessous répertorie les causes les plus fréquentes et comment y remédier.

Pour les problèmes de configuration spécifiques à l'environnement, le changelog IronPDF documente les problèmes connus et les correctifs. Si des problèmes persistent après avoir vérifié le tableau ci-dessus, encadrez l'appel de fusion dans un bloc try-catch pour afficher le message d'erreur complet de la bibliothèque.

Node.js lui-même fournit des outils utiles pour la validation de chemin pré-vol. La méthode Node.js fs.promises.access vous permet de vérifier si un fichier est lisible avant de le transmettre à IronPDF. Pour des questions sur la façon dont les développeurs de la communauté gèrent des scénarios d'erreur de fusion similaires, le fil de discussion sur Stack Overflow concernant la fusion de PDF dans Node.js fournit un contexte supplémentaire.

Quelles sont les prochaines étapes pour fusionner des PDF dans Node.js ?

Les exemples ci-dessus couvrent les scénarios de fusion les plus courants : combinaison de fichiers simple, sélection de plage de pages, injection d'en-têtes et de pieds de page, protection par mot de passe et signature numérique. IronPDF prend également en charge la gestion des formulaires PDF sur des pages fusionnées, l'estampillage de nouveau contenu sur le document combiné, et la production d'images rasterisées à partir de la sortie finale pour la génération de prévisualisation.

Commencez votre essai gratuit de 30 jours pour tester les fusions sans filigrane, ou consultez les options de licence si vous êtes prêt à déployer.

Prêt à voir ce qu'IronPDF peut faire d'autre ? Visitez la documentation IronPDF for Node.js pour une visite complète de l'API et des guides pratiques supplémentaires.