Étapes de configuration

Prérequis et étapes de configuration du SDK Javascript du Robot: installation du module complémentaire JavaScript et configuration de l'accès à l'application.

Cette page couvre les prérequis et la configuration nécessaires à l'utilisation du Robot JavaScript SDK dans des applications Web personnalisées, y compris la configuration du navigateur et de l'accès au consentement du Robot, de l'installation du SDK et de la configuration du module complémentaire JavaScript.

Prérequis

Les conditions préalables suivantes doivent être remplies pour que les projets d'automatisation utilisent le Robot JavaScript SDK:

• UiPath Robot 2026.10 installed
• Module complémentaire JavaScript UiPath installé sur la machine Robot

Autoriser l'accès

Lorsque le module complémentaire JavaScript du UiPath Robot est exécuté, l'accès doit être accordé pour votre application personnalisée ou votre page Web afin de vous connecter au Robot. L'accès est géré par une boîte de dialogue en deux étapes — les deux étapes doivent être confirmées pour exécuter RobotJS. Les deux boîtes de dialogue prennent en charge l'automatisation comme décrit dans les sections suivantes.

Boîte de dialogue d'accès au navigateur

Cette étape fait référence au navigateur qui demande les autorisations pour ouvrir l'Assistant UiPath.

Acceptation automatique de la boîte de dialogue d'accès du navigateur

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.

Remarque :

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.

Boîte de dialogue d'autorisation du robot

La boîte de dialogue de consentement du robot est utilisée pour autoriser la connexion entre le Robot JavaScript SDK et l'exécuteur de Robot.

Accepter automatiquement la boîte de dialogue de consentement du robot

La variable d'environnement système UIPATH_ROBOTJS_ALLOWLIST accepte automatiquement la boîte de dialogue de consentement du robot.

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).

Exemple :

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.

Le robot 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. Exécutez la commande suivante à la racine du répertoire de votre projet:

   npm install --save @uipath/robot
   

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

Remarque :

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.

Paramètres de module complémentaire

Pour configurer les paramètres du module complémentaire:

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. Ajoutez les paramètres ListenerPort et TokenExpiryInDays à la section <robotJsSettings>. Par défaut, la section ne contient aucune clé:

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

Attribut	Description
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.