Jak tworzyć pliki PDF w Node.js
Tworzenie plików PDF programowo w Node.js wymaga biblioteki, która dokładnie obsługuje renderowanie HTML, wspiera nowoczesne CSS i integruje się czysto z asynchronicznymi wzorcami Node. IronPDF wykorzystuje silnik renderujący oparty na Chromie do konwersji treści HTML na PDF-y dopasowane do wydruku Chrome, obsługując pełne CSS, wbudowany JavaScript i elastyczne układy bezpośrednio.
Ten przewodnik obejmuje cały proces pracy: instalację, generowanie PDF z ciągów HTML, plików HTML i URL-ów, konfigurowanie opcji wyjścia i stosowanie funkcji dla przedsiębiorstw, takich jak nagłówki, stopki, podpisy cyfrowe i szyfrowanie.
Szybki start: Stwórz PDF w Node.js
- Zainstaluj IronPDF przez npm:
npm install @ironsoftware/ironpdf - Importuj
PdfDocumentz@ironsoftware/ironpdf - Wywołaj
PdfDocument.fromHtml()z swoją zawartością HTML - Wywołaj
.saveAs(), aby zapisać plik PDF na dysku
:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/quickstart.jsSkonfiguruj IronPdfEngine dla swojej platformy przed uruchomieniem w produkcji. Zobacz przewodnik po instalacji IronPdfEngine dla Windows, Linux, macOS i Docker.
Minimalny proces (5 kroków)
- Zainstaluj IronPDF:
npm install @ironsoftware/ironpdf - Importuj
PdfDocumentz@ironsoftware/ironpdf - Generuj PDF używając
PdfDocument.fromHtml(),PdfDocument.fromFile()lubPdfDocument.fromUrl() - Zastosuj opcjonalne ustawienia: rozmiar papieru, marginesy, nagłówki, stopki
- Zapisz wynik przy użyciu
pdf.saveAs("output.pdf")
Jak zainstalować IronPDF for Node.js?
Zainstaluj pakiet @ironsoftware/ironpdf używając npm. Pakiet działa z Node.js 12.0 lub nowszym i obsługuje formaty modułów ESM i CommonJS.
//:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/install.sh
npm install @ironsoftware/ironpdf//:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/install.sh
npm install @ironsoftware/ironpdfIronPDF dla Node.js jest zależny od pliku binarnego IronPDF Engine, który obsługuje renderowanie oparte na Chromium. Silnik pobierany jest automatycznie przy pierwszym uruchomieniu, ale można wcześniej zainstalować pakiet specyficzny dla platformy, aby uniknąć pobierania w czasie wykonania. Jest to przydatne w ograniczonych środowiskach sieciowych lub pipeline'ach CI opartych na Dockerze:
| Platforma | Pakiet |
|---|---|
| Windows x64 | @ironsoftware/IronPDF-engine-Windows-x64 |
| Linux x64 | @ironsoftware/IronPDF-engine-linux-x64 |
| macOS x64 | @ironsoftware/IronPDF-engine-macos-x64 |
| macOS ARM | @ironsoftware/IronPDF-engine-macos-arm64 |
PdfDocument przez ustawienie IronPdfGlobalConfig.setConfig({ licenseKey: "YOUR-KEY" }). Przestrzegaj pełnych instrukcji konfiguracji klucza licencyjnego.Jakie są wymagania systemowe dla IronPDF?
IronPDF dla Node.js działa na Node.js 12.0 lub nowszym w środowiskach Windows, Linux, macOS i Docker. Biblioteka obsługuje zarówno architektury x64, jak i ARM64, co czyni ją odpowiednią do rozwoju lokalnego i wdrożeń kontenerowych. Dla środowisk chmurowych IronPDF obsługuje także połączenie z zdalnym IronPDF Engine zamiast lokalnego uruchamiania silnika.
Jak Utworzyć PDF z HTML w Node.js?
Użyj PdfDocument.fromHtml(), aby wygenerować PDF z ciągu HTML. Metoda przyjmuje dowolny ważny HTML, w tym inline <style> bloki, zewnętrzne czcionki ładowane przez CDN i systemy układu jak CSS Grid lub Flexbox. Renderer Chromium rozwiązuje wszystkie zasoby przed wygenerowaniem PDF.
:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/html-string-to-pdf.jsPdfDocument.fromHtml() zwraca instancję PdfDocument. Użyć saveAs() z żądanym ścieżką wyjścia, aby zapisać plik. Metoda jest asynchroniczna, więc użyj await lub połącz z .then() handlerem. Silnik Chromium obsługuje ładowanie czcionek, zewnętrznych arkuszy stylów i rozwiązywanie zasobów przed uchwyceniem wyniku. Dla więcej wzorców, zobacz przykład konwersji ciągu HTML do PDF.
Jak Utworzyć PDF z Pliku HTML?
Załadować istniejący plik .html z dysku przy użyciu PdfDocument.fromFile(). To podejście działa dobrze dla zszablonizowanych dokumentów, gdzie HTML jest utrzymywany oddzielnie od logiki aplikacji.
:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/html-file-to-pdf.jsRenderer rozwiązuje względne ścieżki zasobów z katalogu pliku HTML, więc lokalne odniesienia do CSS i obrazów działają bez dodatkowej konfiguracji. Zobacz przykład konwersji pliku HTML do PDF dla dodatkowych opcji, w tym jak nadpisać podstawowy URL do rozwiązywania zasobów.
Jak Wygenerować PDF z URL?
Użyć PdfDocument.fromUrl(), aby wyrenderować stronę internetową na żywo jako PDF. Renderer ładuje stronę jako pełną sesję przeglądarki, wykonując JavaScript, stosując CSS i czekając na dynamiczną treść przed uchwyceniem wyniku.
:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/url-to-pdf.jsDla stron, które ładują treść asynchronicznie za pośrednictwem JavaScriptu, sparować to z opcją renderDelay (w milisekundach), aby dać dodatkowy czas przed przechwytem. Przykład konwersji URL do PDF pokazuje konfigurację opóźnienia i nagłówki uwierzytelnienia.
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.
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.
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.
Jak Skonfigurować Ustawienia Wyjściowe PDF?
Przekazać obiekt konfiguracji jako drugi argument do PdfDocument.fromHtml(), PdfDocument.fromFile(), lub PdfDocument.fromUrl(). Obiekt konfiguracji akceptuje rozmiar papieru, marginesy, orientację i opcje renderowania.
:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/pdf-settings.jsKluczowe opcje konfiguracji obejmują:
paperSize: akceptuje wartości enumeracjiPdfPaperSize(A4, Letter, Legal, i niestandardowe rozmiary)landscape: ustawićtruedla orientacji poziomej stronyprintBackground: zawierać kolory tła CSS i obrazymarginTop/Bottom/Left/Right: marginesy stron w milimetrachrenderDelay: milisekundy do odczekania przed przechwyceniem dla stron obciążonych JavaScriptem
Jak Dodać Nagłówki i Stopki do PDF?
Dodać nagłówki i stopki, dostarczając właściwości htmlHeader oraz htmlFooter w obiekcie konfiguracji. Oba akceptują pełne ciągi HTML, umożliwiając stylizowaną treść z numerami stron, datami i tekstem dynamicznym.
:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/headers-footers.jsUżyć tokenów {page} i {total-pages} w HTML-u stopki. IronPDF zastępuje odpowiednie wartości w momencie renderowania. Dla więcej wzorców nagłówków i stopek, w tym HTML nagłówki i stopki oraz zaawansowane techniki nagłówków, zobacz podlinkowane przykłady.
Jak Dodać Zabezpieczenia i Metadane do PDF?
Zastosować ochronę hasłem i szyfrowanie do wygenerowanego PDF używając metod zabezpieczeń PdfDocument. Biblioteka obsługuje zarówno hasła właściciela, jak i użytkownika, z drobiazgową kontrolą uprawnień do drukowania, kopiowania i edytowania.
:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/security.jsSzyfrowanie i deszyfrowanie używają domyślnie szyfrowania AES 256-bitowego przy zastosowaniu haseł. Dla procesów uwierzytelniania dokumentów IronPDF obsługuje także podpisy cyfrowe przy użyciu certyfikatów X.509.
PdfDocument.fromHtml() przed metodą konwersji PDF/A. IronPDF obsługuje zgodność PDF/A i standardy dostępności PDF/UA.Jak Scalac i Manipulowac istniejace PDFy?
PdfDocument dostarcza metod do łączenia, dzielenia i modyfikacji istniejących plików PDF. Załadować istniejący PDF za pomocą PdfDocument.fromFile() i użyć metod manipulacji, aby dodać lub usunąć strony, oznaczyć zawartość lub zamienić tekst.
:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/merge-pdfs.jsPdfDocument.mergePdf() akceptuje tablicę instancji PdfDocument i zwraca pojedynczy scalony dokument. Kolejność stron jest zgodna z kolejnością tablicy, więc wynik zachowuje sekwencję plików wejściowych.
Inne powszechne operacje manipulacji:
- Usunąć stronę z PDF używając
removePages() - Ostemplować treść HTML na istniejącym dokumencie
- Znajdź i zastąp tekst we wszystkich stronach
- Wyodrębnić tekst z PDF do indeksowania lub przetwarzania
Dla scenariuszy o dużej ilości danych, generowanie PDF w wielu wątkach pozwala przetwarzać wiele dokumentów równolegle. Kompresja PDF zmniejsza rozmiary plików do przechowywania i transmisji.
Jak Generowac PDFy dla Złożonych Treści jak Wykresy i Strony Angular?
IronPDF renderuje strony używając pełnej sesji przeglądarki Chromium, co oznacza, że biblioteki JavaScript, które tworzą wykresy, grafy lub wizualizacje danych, renderują się poprawnie, w tym JavaScript biblioteki wykresów. Aplikacje jednostronicowe zbudowane z użyciem frameworków takich jak Angular także konwertują się łatwo, używając przykładu Angular do PDF.
Dla dokumentów o dużej zawartości Unicode lub wyjściu wielojęzycznym IronPDF obsługuje Unicode i zestawy znaków międzynarodowych bez dodatkowej konfiguracji. Przykład integracji z Google Fonts pokazuje, jak ładować czcionki internetowe w renderowanym HTML dla spójnej typografii w wyniku PDF.
renderDelay w milisekundach, aby dać stronie czas na pełne wyrenderowanie.Jakie Są Następne Kroki Tworzenia PDF w Node.js?
Ten przewodnik obejmował podstawowy przepływ pracy w IronPDF: instalację biblioteki, generowanie PDF z ciągów HTML, plików i URL, konfigurację ustawień wyjściowych, dodawanie nagłówków i stopek, stosowanie zabezpieczeń oraz manipulację istniejącymi PDFami.
Aby kontynuować, spróbuj kompletnego samouczka HTML to PDF dla głębszej analizy opcji renderowania, lub przeglądaj Dokumentację API dla pełnej listy metod i właściwości konfiguracji PdfDocument.
Rozpocznij bezplatna wersje probna, aby generowac PDFy bez znakow wodnych, lub zobacz opcje licencjonowania dla wdrozen produkcyjnych.
Często Zadawane Pytania
Jaki jest najprostszy sposób tworzenia plików PDF w Node.js?
Zainstaluj IronPDF za pomocą npm install @ironsoftware/ironpdf, następnie wywołaj PdfDocument.fromHtml() z ciągiem HTML i zapisz wynik używając saveAs(). Biblioteka automatycznie obsługuje całe renderowanie.
Jak zainstalować IronPDF for Node.js?
Uruchom npm install @ironsoftware/ironpdf w swoim katalogu projektu. Plik binarny IronPDF Engine pobiera się automatycznie przy pierwszym użyciu. Dla środowisk offline lub CI, zainstaluj oddzielnie specyficzny dla platformy pakiet silnika, taki jak @ironsoftware/ironpdf-engine-linux-x64.
Czy mogę konwertować HTML na PDF z zachowaniem stylów CSS i formatowania?
Tak. IronPDF używa silnika renderowania bazującego na Chromie, który zachowuje wszystkie style CSS, zewnętrzne czcionki oraz wykonywanie JavaScriptu podczas konwersji HTML na PDF. Wyjście odpowiada zachowaniu podglądu druku w Chromie.
Jakie funkcje PDF są dostępne poza podstawową konwersją HTML?
IronPDF obsługuje podpisy cyfrowe, szyfrowanie AES 256-bitowe, ochronę hasłem z precyzyjnymi uprawnieniami, niestandardowe nagłówki i stopki z tokenami numerów stron, łączenie PDF, usuwanie stron, stemplowanie HTML, ekstrakcję tekstu, zgodność z PDF/A oraz generowanie wielowątkowe.
Jak utworzyć PDF z pliku HTML na dysku?
Użyj PdfDocument.fromFile('./path/to/template.html'). Renderer rozwiązuje ścieżki względne zasobów z katalogu pliku HTML, więc lokalne odniesienia CSS i obrazów działają bez dodatkowej konfiguracji.
Czy mogę wyciągnąć tekst z istniejących plików PDF używając IronPDF?
Tak. Załaduj istniejący PDF za pomocą PdfDocument.fromFile() i użyj metod ekstrakcji tekstu, aby przeczytać zawartość z dowolnej strony. IronPDF obsługuje zarówno tworzenie nowych PDF, jak i przetwarzanie istniejących dokumentów.
Czy IronPDF obsługuje wykonywanie JavaScriptu podczas renderowania HTML?
Tak. Renderer Chrome wykonuje JavaScript przed uchwyceniem PDF. Dla stron, które ładują zawartość asynchronicznie, ustaw opcję renderDelay w milisekundach, aby dać stronie dodatkowy czas przed uchwyceniem.
Wciąż przewijasz?
Czy chcesz szybko dowodu?
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.
Rozpocznij za DARMO
Rozpocznij za DARMO
Zarezerwuj darmowe Demo na żywo
Nie wymaga karty kredytowej ani tworzenia konta
