Unterstützte Node.js®-Kommandozeilenoptionen

Die folgenden Optionen wurden für die Verwendung mit dem WinCC OA JavaScript Manager für Node.jsgeprüft:

Tabelle 1. Unterstützte Node.js-Kommandozeilenoptionen
Option Beschreibung
--cpu-prof Aktiviert CPU-Profiling beim Start und schreibt das CPU-Profil vor dem Beenden auf die Festplatte.
--cpu-prof-dir Gibt das Verzeichnis an, in dem CPU-Profile von --cpu-prof gespeichert werden.
--cpu-prof-name Gibt den Dateinamen des CPU-Profils an, das von --cpu-prof generiert wird.
--diagnostic-dir Legt das Verzeichnis fest, in das alle Diagnosedateien geschrieben werden. Standard ist das aktuelle Arbeitsverzeichnis.
--env-file Lädt Umgebungsvariablen aus der angegebenen Datei. Nützlich für das Setzen zusätzlicher Node.js-Optionen über NODE_OPTIONS.
--expose-gc Stellt die Garbage-Collector-Schnittstelle für Benutzercode zur Verfügung und ermöglicht manuelles Auslösen der Speicherbereinigung.
--heap-prof Aktiviert Heap-Profiling beim Start und schreibt das Heap-Profil vor dem Beenden auf die Festplatte.
--heap-prof-dir Gibt das Verzeichnis an, in dem Heap-Profile von --heap-prof gespeichert werden.
--heap-prof-name Gibt den Dateinamen des Heap-Profils an, das von --heap-prof generiert wird.
--inspect[=[host:]port] Aktiviert den Inspector auf dem angegebenen Host und Port. Standard-Host ist 127.0.0.1 und Port ist 9229. Ermöglicht Debugging mit Chrome DevTools.
--inspect-brk[=[host:]port] Aktiviert den Inspector und pausiert vor dem Start des Benutzercodes. Nützlich für Debugging vom Beginn der Skriptausführung an.
--max-old-space-size Legt die maximale Speichergröße des Old-Generation-Heaps in MB fest. Hilft bei der Speicherkontrolle und verhindert Out-of-Memory-Fehler.
--report-dir Gibt das Verzeichnis an, in dem Diagnoseberichte geschrieben werden. Wird in Verbindung mit anderen Report-Optionen verwendet.
--report-filename Gibt den Dateinamen für Diagnoseberichte an. Kann Platzhalter für Zeitstempel und Prozess-ID enthalten.
--report-on-fatalerror Aktiviert die automatische Generierung von Diagnoseberichten bei schwerwiegenden Fehlern und hilft beim Debugging von Abstürzen.
--report-uncaught-exception Aktiviert die automatische Generierung von Diagnoseberichten bei nicht abgefangenen Exceptions.
--watch Aktiviert den automatischen Neustart der Anwendung, wenn Dateiänderungen im aktuellen Verzeichnis und seinen Unterverzeichnissen erkannt werden.
Anmerkung:
Diese Liste wird mit der Zeit erweitert werden.

Andere Optionen können auf eigene Gefahr verwendet werden. Bitte beachten Sie, dass Kommandozeilenoptionen, die auf Exception-, Exit- oder Signalbehandlung beruhen, möglicherweise nicht mit dem WinCC OA JavaScript Manager für Node.js kompatibel sind.

Weitere Informationen über die Kommandozeilenschnittstelle von Node.js® können in der offiziellen Dokumentation nachgelesen werden: https://nodejs.org/docs/latest-v20.x/api/cli.html

Anmerkung:
Die Länge der Kommandozeilenoptionen, die für einen Manager in PMON angegeben werden können, ist begrenzt. Wenn nicht alle Kommandozeilenoptionen passen, ist es möglich --env-file zu benutzen und mehr Kommandozeilenoptionen in eine Textdatei mit dem Zusatz NODE_OPTIONS zu hinterlegen. Zum Beispiel können Sie eine Datei namens nodeOptions.env im data-Verzeichnis Ihres Projekts mit folgendem Inhalt erstellen: 
NODE_OPTIONS='--report-on-fatalerror --report-dir=C:/WinCC_OA_Proj/MyProject/log/ --report-filename=MyManagerReport.json'
und zu den Optionen des JavaScript Managers hinzuzufügen: 
--env-file=data/nodeOptions.env my-script.js