Konfigurationsschritte

Voraussetzungen und Konfigurationsschritte für das Robot JavaScript SDK: JavaScript-Add-On und Einrichtung des Anwendungszugriffs.

Diese Seite behandelt die Voraussetzungen und Konfigurationen für die Verwendung des Robot JavaScript SDK in benutzerdefinierten Webanwendungen, einschließlich der Einrichtung des Browsers und des Zugriffs auf die Roboterzustimmung, der Installation des SDK und der Konfiguration des JavaScript-Add-Ons.

Voraussetzungen

Folgende Voraussetzungen müssen erfüllt sein, damit Automatisierungsprojekte das Roboter-JavaScript-SDK verwenden können:

• UiPath Robot 2026.10 installed
• Das auf der Robotermaschine installierte UiPath JavaScript Add-On

Zugriff zulassen

Wenn das UiPath Robot JavaScript Add-On ausgeführt wird, muss der Zugriff auf Ihre benutzerdefinierte Anwendung oder Webseite gewährt werden, um eine Verbindung mit dem Roboter herzustellen. Der Zugriff wird über ein zweistufiges Dialogfeld geregelt – beide Schritte müssen bestätigt werden, um RobotJS auszuführen. Beide Dialogfelder unterstützen die Automatisierung, wie in den folgenden Abschnitten beschrieben.

Dialogfeld „Browserzugriff“

Dieser Schritt bezieht sich auf den Browser, der Berechtigungen zum Öffnen des UiPath Assistant anfordert.

Automatisches Akzeptieren des Browserzugriffsdialogfelds

The uipath-web protocol is the UiPath Robot web protocol handler. Browsers ask for permission before they open it. You can automate this dialog through your browser's enterprise policies.

Hinweis:

Based on the browser used, different settings need to be configured. For the exact policy and value format, see the enterprise policy documentation of your browser.

Dialogfeld zur Zustimmung des Roboters

Das Dialogfeld „Roboterzustimmung“ wird verwendet, um die Verbindung zwischen dem Robot JavaScript SDK und dem Robot Executor zuzulassen.

Automatisches Akzeptieren des Roboter-Zustimmungsdialogs

Die Systemumgebungsvariable UIPATH_ROBOTJS_ALLOWLIST akzeptiert automatisch das Dialogfeld für die Roboter-Zustimmung.

The value is a list of origins separated by semicolons. Each origin includes the scheme, for example https://myapp.contoso.com. Add the port only if it is not the default (80 or 443).

Beispiel:

UIPATH_ROBOTJS_ALLOWLIST=https://cloud.uipath.com;https://mydomain.com

The Robot already accepts the UiPath cloud origins by default, so you only add your own origins. For the default list, see the AllowUrlList key in Configuration files.

Das Roboter-JavaScript-SDK

This SDK provides all the necessary methods and properties you can include in your custom application or web page. It is available as an npm package with TypeScript bindings. To include it in your project:

1. Führen Sie den folgenden Befehl im Stammverzeichnis Ihres Projektverzeichnisses aus:

   npm install --save @uipath/robot
   

To load the SDK with a <script> tag instead, use dist/js/UiPathRobot.js from the package.

Hinweis:

Version 1.3.3, the last one published to download.uipath.com, remains available at https://download.uipath.com/js/1.3.3/UiPathRobot.js. Newer versions are published only on npm.

Add-on-Einstellungen

So konfigurieren Sie die Add-on-Einstellungen:

1. Open the UiPath.config file: %ProgramFiles%\UiPathPlatform\Robot\<version>\UiPath.config for a per-machine installation, or %LocalAppData%\Programs\UiPathPlatform\Robot\<version>\UiPath.config for a per-user installation. For details, see Configuration files.
2. Fügen Sie die Parameter ListenerPort und TokenExpiryInDays zum Abschnitt <robotJsSettings> hinzu. Standardmäßig enthält der Abschnitt keine Schlüssel:

<robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings>

Attribut	Beschreibung
ListenerPort	The UiPath.RobotJS.ServiceHost.exe starts a HttpListener on the configured port and contains the information about other local listeners from the active user session on that system. The port value must match the one configured in the SDK Settings. The default value is 2323.
TokenExpiryInDays	Any request coming from a new domain needs to have consent from the user to allow access of UiPath Robots from a web application. These consents are valid for the said number of days mentioned in this setting. The default value is 30.

After you edit the file, restart the UiPath RobotJS Service service for the changes to take effect. For the steps, see Restarting robot components.