Jak scalic pliki PDF w jeden PDF za pomocą Node.js

Jak połączyć wiele plików PDF w Node.js?

PdfDocument.merge() akceptuje tablicę obiektów PdfDocument i zwraca nowy dokument zawierający każdą stronę w kolejności, w jakiej pojawiają się źródłowe dokumenty w tablicy. Operacja jest bezdestrukcyjna; oryginalne obiekty plików nie są modyfikowane.

//: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() ładuje pliki źródłowe równolegle, a nie jeden po drugim, co ma znaczenie przy przetwarzaniu większych kolekcji. Wywołanie merge() konkatenuje dokumenty w kolejności tablicy, więc umieść pliki w tablicy w sekwencji, w jakiej chcesz, aby pojawiły się w wyniku.

Jak połączyć wybrane strony z każdego PDF?

Przekazywanie każdej strony z każdego dokumentu źródłowego nie zawsze jest celem. Aby scalić wybiórcze zakresy stron z każdego pliku wejściowego, wyodrębnij pożądane strony przed przekazaniem dokumentów do 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) akceptuje indeksy stron zaczynające się od zera. Przekazanie 0, 0 wyodrębnia tylko pierwszą stronę, podczas gdy 0, 2 wyodrębnia pierwsze trzy strony. Pętla tworzy tablicę dokumentów zakresów stron w kolejności, w jakiej pojawiają się w ranges, następnie merge() konkatenuje je w finalny wynik.

Ten wzorzec jest przydatny podczas montażu umów z strony podpisu, dodatku i arkusza okładkowego przechowywanego w oddzielnych plikach. Możesz zebrać dokładnie te strony, które mają znaczenie z każdego źródła, bez powielania plików na dysku.

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak dodać nagłówki i stopki do połączonego PDF?

Po połączeniu, wywołaj addHtmlHeader() i addHtmlFooter() na wynikowym dokumencie, aby zastosować spójne nagłówki i stopki na wszystkich stronach. Te metody przyjmują ciąg HTML i obiekt opcji.

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

Zmienne {page} i {total-pages} są rozwiązywane podczas renderowania w odniesieniu do liczby stron scalonego dokumentu. Użyj drawDividerLine: true, aby wizualnie oddzielić nagłówek lub stopkę od treści strony.

Stosowanie nagłówków i stopek po połączeniu oznacza, że każda strona w połączonym dokumencie otrzymuje to samo traktowanie, niezależnie od tego, z którego pliku źródłowego pochodzi. Aby uzyskać pełne opcje konfiguracji nagłówków i stopek, zobacz przykłady HTML nagłówków i stopek.

Jak zabezpieczyć połączony PDF hasłem?

Zastosować ochronę hasłem i restrykcje uprawnień po łączeniu, wywołując saveAs() z obiektem opcji zabezpieczeń. To zapobiega nieautoryzowanemu dostępowi do połączonego dokumentu.

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

Do dokumentu wymagane jest userPassword; ownerPassword kontroluje same ustawienia uprawnień. Ustawienie allowUserPrinting: true przy jednoczesnym wyłączeniu innych flag uprawnień pozwala odbiorcom drukować dokument, ale zapobiega edycji, kopiowaniu i adnotacjom. Dla pełnej listy dostępnych flag uprawnień, zapoznaj się z dokumentacją API IronPDF Node.js.

Jak połączyć PDF i dodać podpis cyfrowy?

Łączenie PDF, a następnie natychmiastowe podpisywanie wyników, tworzy pojedynczy podpisany dokument, który obejmuje całą treść źródłową. Zastosować applySignature() po merge(), aby dołączyć certyfikat cyfrowy do połączonego rezultatu.

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

Metoda applySignature() osadza certyfikat w metadanych PDF, aby czytelnicy mogli zweryfikować integralność dokumentu. Ten przepływ pracy jest powszechny w procesach składania umów, gdzie łączone są różne sekcje, a następnie współpodpisane przed dystrybucją. Aby uzyskać pełny przewodnik po podpisywaniu na certyfikatach, zobacz przykłady podpisów cyfrowych.

Jak rozwiązywać najczęstsze błędy łączenia PDF?

Większość błędów podczas łączenia podzielona jest na cztery kategorie: brakujące pliki, wyczerpanie pamięci, uszkodzone wejścia i problemy z uprawnieniami. Poniższa tabela wymienia najczęstsze przyczyny i sposoby rozwiązania ich.

Dla problemów z konfiguracją specyficznego dla środowiska, changelog IronPDF dokumentuje znane problemy i ich naprawy. Jeśli problemy będą się utrzymywać po sprawdzeniu tabeli powyżej, opakuj wywołanie łączenia w blok try-catch, aby przedstawić pełną wiadomość błędu z biblioteki.

Node.js sam dostarcza przydatne narzędzia do walidacji ścieżki przed startem. Metoda Node.js fs.promises.access pozwala sprawdzić, czy plik jest czytelny przed przekazaniem go do IronPDF. W przypadku pytań o to, jak społeczność programistów radzi sobie z podobnymi scenariuszami błędów łączenia, wątek Stack Overflow o łączeniu PDF w Node.js dostarcza dodatkowego kontekstu.

Jakie są kolejne kroki w łączeniu PDF w Node.js?

Powyższe przykłady obejmują najczęstsze scenariusze łączenia: podstawowe połączenie plików, wybór zakresu stron, wprowadzenie nagłówków i stopek, ochrona hasłem i podpisy cyfrowe. IronPDF obsługuje również zarządzanie formularzami PDF na połączonych stronach, stemplowanie nowej zawartości na połączonym dokumencie i tworzenie rastrowych obrazów z końcowego wyniku dla generacji podglądu.

Rozpocznij bezpłatny 30-dniowy okres próbny, aby przetestować łączenie bez znaku wodnego, lub zobacz opcje licencjonowania, jeśli jesteś gotów do wdrożenia.

Gotowy, aby zobaczyć, co jeszcze potrafi IronPDF? Odwiedź dokumentację IronPDF dla Node.js dla pełnego przeglądu API i dodatkowych przewodników "jak-to-zrobić".