Convert-HtmlToPdfWithFirefox

ÜBERSICHT

Wandelt eine HTML-Datei oder URL mit Firefox im Headless-Modus in eine PDF um und gibt den vollen Ausgabepfad zurück.

SYNTAX

Convert-HtmlToPdfWithFirefox [-Source] <string> [-OutPdf] <string> [[-Port] <int>] [-Landscape]
    [<CommonParameters>]

BESCHREIBUNG

Die Funktion startet geckodriver lokal, öffnet Firefox im Headless-Modus und nutzt den WebDriver-Print-Endpunkt. Der Geckodriver wird ausschließlich im Modulordner 'pdf\geckodriver.exe' erwartet. Fehlt er, wird er automatisch heruntergeladen und die Lizenzdatei als 'geckodriver-LICENSE.txt' daneben abgelegt. Es gibt eine schnelle Prüfung, ob Firefox installiert ist (Registry, dann Standardpfade). Hinweis:

• Nur Modul-eigener Geckodriver wird akzeptiert, damit getestete Versionen reproduzierbar bleiben.
• Bei fehlendem Firefox oder fehlgeschlagener Geckodriver-Bereitstellung nur Warnung und Rückgabe $null.
• Fehler während der eigentlichen Wandlung führen zu einer Exception.
• Es wird auf document.readyState == complete gewartet, bevor gedruckt wird.

PARAMETER

-Source

Type: string

Datei oder URL. Bei lokaler Datei wird ein file:// URI erzeugt.

-OutPdf

Type: string

Zielpfad der Ausgabedatei. Darf relativ sein. Alias: OutputPdf.

-Port

Type: int
Default: 0

TCP-Port für geckodriver. 0 wählt automatisch einen freien Port. Standard 0.

-Landscape

Type: switch

PDF im Querformat, wenn gesetzt.

AUSGABEN

string oder $null

Vollqualifizierter Pfad der erzeugten PDF-Datei. Bei fehlendem Firefox oder Geckodriver $null mit Warnung.

BEISPIELE

Convert-HtmlToPdfWithFirefox -Source .\test.html -OutPdf .\test.pdf