C# Namenskonventionen (Wie es für Entwickler funktioniert)

Warum Puppeteer?

• Einfache Handhabung: Puppeteer bietet eine einfache und benutzerfreundliche API, die die Komplexitäten der Arbeit mit Headless-Browsern abstrahiert.
• Leistungsfähig: Puppeteer bietet umfangreiche Möglichkeiten zur Manipulation von Webseiten und zur Interaktion mit Browser-Elementen.
• Skalierbar: Mit Puppeteer können Sie den PDF-Generierungsprozess problemlos skalieren, indem Sie mehrere Browser-Instanzen parallel ausführen.

Importieren von Puppeteer und fs

const puppeteer = require('puppeteer');
const fs = require('fs');

Der Code beginnt mit dem Importieren zweier wichtiger Bibliotheken: puppeteer, ein vielseitiges Werkzeug zur Steuerung von Headless-Browsern wie Chrome und Chromium, und fs, ein in Node.js integriertes Modul zur Bearbeitung von Dateisystemoperationen. Puppeteer ermöglicht es, eine Vielzahl von webbasierten Aufgaben zu automatisieren, einschließlich Rendering von HTML, Screenshot-Erstellung und PDF-Generierung.

Definieren der Funktion exportWebsiteAsPdf

async function exportWebsiteAsPdf(html, outputPath) {
  // Create a browser instance
  const browser = await puppeteer.launch({
    headless: true // Launches the browser in headless mode
  });

  // Create a new page
  const page = await browser.newPage();

  // Set the HTML content for the page, waiting for DOM content to load
  await page.setContent(html, { waitUntil: 'domcontentloaded' });

  // To reflect CSS used for screens instead of print
  await page.emulateMediaType('screen');

  // Download the PDF
  const PDF = await page.pdf({
    path: outputPath,
    margin: { top: '100px', right: '50px', bottom: '100px', left: '50px' },
    printBackground: true,
    format: 'A4',
  });

  // Close the browser instance
  await browser.close();

  return PDF;
}

Die exportWebsiteAsPdf-Funktion dient als Kern unseres Codebeispiels. Diese asynchrone Funktion akzeptiert eine html-Zeichenkette und ein outputPath als Eingabeparameter und gibt eine PDF-Datei zurück. Die Funktion führt folgende Schritte aus:

1. Startet eine neue Headless-Browserinstanz mit Puppeteer.
2. Erstellt eine neue Browserseite.
3. Setzt die bereitgestellte html-Zeichenkette als Seiteninhalt und wartet darauf, dass der DOM-Inhalt geladen wird.
4. Emuliert den Medientyp 'Bildschirm', um das für Bildschirme verwendete CSS anzuwenden, anstatt druckspezifische Stile.
5. Generiert eine PDF-Datei aus dem geladenen HTML-Inhalt, wobei Ränder, Hintergrunddrucke und das Format (A4) angegeben werden.
6. Schließt die Browserinstanz.
7. Gibt die erstellte PDF-Datei zurück.

Verwendung der Funktion exportWebsiteAsPdf

// Usage example
// Get HTML content from HTML file
const html = fs.readFileSync('test.html', 'utf-8');

// Convert the HTML content into a PDF and save it to the specified path
exportWebsiteAsPdf(html, 'result.pdf').then(() => {
  console.log('PDF created successfully.');
}).catch((error) => {
  console.error('Error creating PDF:', error);
});

Der letzte Abschnitt des Codes zeigt, wie die exportWebsiteAsPdf-Funktion verwendet wird. Wir führen die folgenden Schritte aus:

1. Lesen Sie den HTML-Inhalt aus einer HTML-Datei mit der fs-Methode des readFileSync-Moduls.
2. Rufen Sie die exportWebsiteAsPdf-Funktion mit der geladenen html-Zeichenkette und dem gewünschten outputPath auf.
3. Verwenden Sie einen .then-Block, um die erfolgreiche Erstellung des PDFs zu handhaben und eine Erfolgsmeldung in die Konsole zu protokollieren.
4. Verwenden Sie einen .catch-Block, um eventuelle Fehler während des HTML-zu-PDF-Konvertierungsprozesses zu verwalten und eine Fehlermeldung in die Konsole zu protokollieren.

Dieses Codebeispiel bietet ein umfassendes Beispiel dafür, wie ein HTML-Template mit Node.js und Puppeteer in eine PDF-Datei konvertiert wird. Durch die Implementierung dieser Lösung können Sie effizient qualitativ hochwertige PDFs generieren, die den Anforderungen verschiedener Anwendungen und Benutzer gerecht werden.

Puppeteer importieren

const puppeteer = require('puppeteer');

Der Code beginnt mit dem Importieren der Puppeteer-Bibliothek, einem leistungsstarken Tool zur Steuerung von Headless-Browsern wie Chrome und Chromium. Puppeteer ermöglicht es Ihnen, eine Vielzahl von webbasierten Aufgaben zu automatisieren, darunter das Rendern ihres HTML-Codes, das Erstellen von Screenshots und in unserem Fall das Generieren von PDF-Dateien.

Definieren der Funktion exportWebsiteAsPdf

async function exportWebsiteAsPdf(websiteUrl, outputPath) {
  // Create a browser instance
  const browser = await puppeteer.launch({
    headless: true // Launches the browser in headless mode
  });

  // Create a new page
  const page = await browser.newPage();

  // Open the URL in the current page
  await page.goto(websiteUrl, { waitUntil: 'networkidle0' });

  // To reflect CSS used for screens instead of print
  await page.emulateMediaType('screen');

  // Download the PDF
  const PDF = await page.pdf({
    path: outputPath,
    margin: { top: '100px', right: '50px', bottom: '100px', left: '50px' },
    printBackground: true,
    format: 'A4',
  });

  // Close the browser instance
  await browser.close();

  return PDF;
}

Die exportWebsiteAsPdf-Funktion ist der Kern unseres Codebeispiels. Diese asynchrone Funktion akzeptiert ein websiteUrl und ein outputPath als Eingabeparameter und gibt eine PDF-Datei zurück. Die Funktion führt folgende Schritte aus:

1. Startet eine neue Headless-Browserinstanz mit Puppeteer.
2. Erstellt eine neue Browserseite.
3. Navigiert zur bereitgestellten websiteUrl und wartet mit der waitUntil-Option, die auf networkidle0 gesetzt ist, bis das Netzwerk im Leerlauf ist.
4. Emuliert den Medientyp 'Bildschirm', um sicherzustellen, dass das für Bildschirme verwendete CSS angewendet wird, anstatt druckspezifische Stile.
5. Konvertiert die geladene Webseite mit den angegebenen Rändern, Hintergrunddrucken und Format (A4) in eine PDF-Datei.
6. Schließt die Browserinstanz.
7. Gibt die generierte PDF-Datei zurück.

Verwendung der Funktion exportWebsiteAsPdf

// Usage example
// Convert the URL content into a PDF and save it to the specified path
exportWebsiteAsPdf('https://ironpdf.com/', 'result.pdf').then(() => {
  console.log('PDF created successfully.');
}).catch((error) => {
  console.error('Error creating PDF:', error);
});

Der letzte Abschnitt des Codes demonstriert, wie die exportWebsiteAsPdf-Funktion verwendet wird. Wir führen die folgenden Schritte aus:

1. Rufen Sie die exportWebsiteAsPdf-Funktion mit dem gewünschten websiteUrl und outputPath auf.
2. Verwenden Sie einen then-Block, um die erfolgreiche Erstellung des PDFs zu handhaben. In diesem Block loggen wir eine Erfolgsnachricht an die Konsole.
3. Verwenden Sie einen catch-Block, um eventuelle Fehler während des Website-zu-PDF-Konvertierungsprozesses zu verwalten. Wenn ein Fehler auftritt, loggen wir eine Fehlermeldung an die Konsole.

Durch die Integration dieses Codebeispiels in Ihre Projekte können Sie URLs mühelos in hochwertige PDF-Dateien mit Node.js und Puppeteer konvertieren.

Hauptfunktionen von IronPDF

HTML-zu-PDF-Konvertierung mit IronPDF: IronPDF ermöglicht es Ihnen, HTML-Inhalte, einschließlich CSS, in PDF-Dateien zu konvertieren. Diese Funktion ermöglicht es Ihnen, pixelgenaue PDF-Dokumente von Webseiten oder HTML-Vorlagen zu erstellen.

URL-Rendering: IronPDF kann Webseiten direkt von einem Server über eine URL abrufen und in PDF-Dateien konvertieren. Dadurch wird es einfach, Webinhalte zu archivieren oder Berichte aus dynamischen Webseiten zu generieren.

Zusammenführung von Text, Bildern und PDFs: Mit IronPDF können Sie Text, Bilder und bestehende PDF-Dateien zu einem einzigen PDF-Dokument zusammenführen. Diese Funktion ist besonders nützlich zur Erstellung komplexer Dokumente mit mehreren Inhaltsquellen.

PDF-Bearbeitung: IronPDF bietet Werkzeuge zum Bearbeiten bestehender PDF-Dateien, wie z. B. das Hinzufügen oder Entfernen von Seiten, das Ändern von Metadaten oder sogar das Extrahieren von Text und Bildern aus PDF-Dokumenten.