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