Puppeteer ist stark, wenn das Produkt eine Webseite ist
Puppeteer steuert einen echten Chromium-Browser. Das ist seine Superkraft. Wenn die Quelle der Wahrheit eine vorhandene HTML-Seite, ein Dashboard mit JavaScript-Charts, ein rechtlicher Snapshot einer gerenderten Web-App oder ein screenshotartiger Export ist, ist Puppeteer oft die richtige Produktentscheidung.
Die Frage ist, ob Ihr PDF wirklich eine Webseite ist oder ein strukturiertes Geschäftsdokument. Rechnungs-PDFs, Labels, Kontoauszüge, Belege, Tickets und Formulare entstehen meist aus Daten, nicht aus einem Live-DOM. Für diese Abläufe ist ein ganzer Browser oft mehr Architektur, als das Dokument braucht.
Gleiches Artefakt, andere Produktgrenze
Puppeteer macht aus HTML über Chromium ein gedrucktes PDF. Die Anwendung besitzt HTML-Vorlagen, Druck-CSS, Font-Installation, Browser-Laufzeitumgebung, Worker-Kapazität, Retries und regionale Deployments.
gPdf macht aus strukturiertem JSON direkt ein PDF. Die Anwendung sendet eine DocumentRequest- oder template_id + data-Anfrage; der Edge-Renderer besitzt Layout-Ausführung, gebündelte Fonts, Barcode-Primitives, PDF/A-Profile und E-Invoice-Pakete. Es gibt keinen Browserprozess, keine CSS-Kaskade und keinen warm zu haltenden Chromium-Container.
Produktpassung: Web-Erfassung vs Dokumentgenerierung
Wählen Sie Puppeteer, wenn das Dokument exakt wie eine vorhandene Webseite aussehen muss oder clientseitiges JavaScript den finalen visuellen Zustand erzeugt. Dazu gehören Webarchive, dynamische Dashboards, DOM-lastige Berichte und Abläufe, in denen ein Neuaufbau als JSON mehr Risiko schafft als entfernt.
Wählen Sie gPdf, wenn das Produkt Dokumentgenerierung ist: ein Label, eine Rechnung, ein Ticket, ein Auszug, ein Zertifikat, ein Beleg oder ein Compliance-Paket, das jedes Mal aus sauberen Daten gleich erzeugt werden soll.
Entwicklungszeit: HTML-Print-Debugging vs API-Vorlagen
Puppeteer startet schnell, wenn das HTML bereits existiert. Die Entwicklungszeit zeigt sich später: Druck-CSS, Page-Break-Verhalten, Font-Installation in Containern, Header/Footer-Kantenfälle, Barcode-Größen und Drift zwischen Browser-Versionen.
gPdf startet mit einer strukturierten Vorlage. Teams können JSON direkt schreiben, KI nutzen, um schema-gültige Layouts zu entwerfen, oder gPdf Studio verwenden, um Text, Tabellen, Bilder, Formen, Kopf- und Fußbereiche sowie Barcodes visuell hinzuzufügen und zu verschieben. Ist die Vorlage gespeichert, bleiben Produktionsaufrufe template_id + data.
Preismodell: freie Automatisierungsbibliothek vs betriebene Browser-Flotte
Puppeteer hat keine Lizenzgebühr. Das macht einen Produktions-Puppeteer-PDF-Service nicht kostenlos.
Die Kostenfläche ist der Service rund um Chromium:
- Container- oder Serverless-Laufzeitumgebung für das Browser-Binary.
- Warm Pools oder Queues, um Cold Starts abzufangen.
- Speicherreserven für Seiten, Fonts, Bilder und PDF-Bytes.
- Regionale Deployments, wenn Lager oder Kunden global sind.
- Monitoring, Retries, Browser-Upgrades und Security-Patches.
gPdf bepreist die PDF-Erzeugungsfläche direkt. Der Basic Plan startet bei 5 USD/Monat für 100.000 Seiten; die öffentliche Seitenberechnung startet bei 0,00005 USD pro Seite. Es gibt keine Seat-Gebühren, keine separaten Test-/Prod-Umgebungsgebühren und keinen Chromium-Pool zu betreiben.
Edge-Generierung ändert Latenz- und Kostenform
Mit Puppeteer lebt der Browser meist dort, wo Sie ihn hosten. Wenn Lager, Kunde oder Backend-Job weit von dieser Region entfernt sind, enthält der Renderpfad Netzwerklatenz plus Browserarbeit. Mehr Regionen bedeuten, Browser-Service, Deployment-Pipeline, Monitoring und Kapazitätsplanung zu duplizieren.
gPdf läuft auf Cloudflare Workers V8-Isolates. Für strukturierte PDFs ist der Renderer klein genug, nahe am Aufrufer zu laufen, statt jeden Render in einer Region zu zentralisieren. Der Geschäftseffekt sind nicht nur bessere p50-Zahlen; es ist das Entfernen einer regionalen Chromium-Flotte aus dem Produkt.
Produktfähigkeiten, die den Vergleich meist entscheiden
Für operative Dokumente zählt die Feature-Liste genauso wie rohe Renderleistung:
- Native Barcode-Elemente für Labels, Tickets und Lagerdokumente.
- Gebündelter CJK- und Mehrsprachen-Font-Fallback.
- PDF/A-Ausgabeprofile für Archivierungsabläufe.
- Factur-X/ZUGFeRD E-Invoice-Pakete.
- Passwortgeschützte PDFs und Metadatenkontrollen in höheren Tarifen.
- Visuelle Layout-Iteration mit gPdf Studio.
Puppeteer kann vieles davon über Page-Code, Browser-Setup oder Post-Processing unterstützen. Die Frage ist, ob Ihr Team diesen Stack besitzen will.
Wann Puppeteer weiterhin die richtige Antwort ist
Es gibt eine Kategorie, in der gPdf nicht konkurriert: beliebige HTML-zu-PDF-Konvertierung. Wenn das Dokument bereits gerendert ist, die Designquelle HTML ist und Sie einen echten Browser brauchen, um JavaScript auszuführen oder den DOM zu treffen, bleibt Puppeteer das richtige Werkzeug.
Wenn der Workload klein ist und Latenz keine Rolle spielt, kann der operative Aufwand ebenfalls akzeptabel sein. Ein paar interne Exporte pro Tag rechtfertigen nicht unbedingt, stabiles HTML als JSON neu aufzubauen.
Migrationsform
Für Teams, die einen Rechnungs- oder Label-Workload von Puppeteer zu gPdf verlagern, sieht die Migration meist so aus:
- // Before: render an HTML template through Chromium
- const browser = await puppeteer.launch({ headless: 'new' });
- const page = await browser.newPage();
- await page.setContent(invoiceHtml);
- const pdf = await page.pdf({ format: 'A4' });
+ // After: POST the structured DocumentRequest
+ const res = await fetch('https://api.gpdf.com/api/v1/template-render', {
+ method: 'POST',
+ headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
+ body: JSON.stringify({ template_id: 'invoice-v2', data }),
+ });
+ const pdf = Buffer.from(await res.arrayBuffer());
Die Arbeit ist nicht der API-Aufruf, sondern das einmalige Erstellen der Vorlage. Danach ist jeder Render-Aufruf ein einzelner HTTPS POST.
Verwandte PDF-Generierungsszenarien
Teams, die Puppeteer und gPdf vergleichen, prüfen meistens, ob sie Headless Chrome weiter selbst betreiben oder strukturierte PDF-Erzeugung als API nutzen sollten. Für operative Dokumente starten Sie mit JSON-to-PDF API und Template PDF API. Konkrete Anwendungsfälle sind Rechnungs-PDF API, Versandlabel API und GS1 Barcode API. Wenn Archivierung oder E-Invoices relevant sind, lesen Sie zusätzlich PDF/A API und Factur-X API.
FAQ
Ist Puppeteer kostenlos?
Puppeteer ist als Bibliothek kostenlos nutzbar. In Produktion zahlen Sie den Browser-Service: Container, Speicher, Cold Starts, regionale Kapazität, Monitoring, Retries und Wartung.
Kann gPdf beliebige HTML-Seiten rendern?
Nein. gPdf ist JSON-nativ. Wenn Ihre Quelle beliebiges HTML oder eine Live-Webseite ist, ist Puppeteer die bessere Wahl.
Warum Studio mit Puppeteer vergleichen?
Weil viele Teams HTML auch deshalb nutzen, weil Designer und Entwickler das Ergebnis sehen können. gPdf Studio gibt strukturierten PDF-Vorlagen eine visuelle Oberfläche, ohne die Laufzeitumgebung in einen Browser zu verwandeln.
Siehe auch
- Die vollständige gPdf API-Referenz - Endpunkte, Anfrageform, Fehler.
- Warum Edge-PDF-Rendering wichtig wird, sobald Sie 10.000 Rechnungen/Tag überschreiten - die ausführliche Latenzmathematik.
- PDF/A und Factur-X für Entwickler erklärt - relevant, wenn EU-E-Invoice-Mandate Ihren Workload betreffen.