Pasos de configuración

Requisitos previos y pasos de configuración para el SDK de JavaScript del robot: instalación del complemento de JavaScript y configuración de acceso a la aplicación.

Esta página cubre los requisitos previos y la configuración para utilizar el SDK de JavaScript del robot en aplicaciones web personalizadas, incluida la configuración del navegador y el acceso de consentimiento del robot, la instalación del SDK y la configuración del complemento de JavaScript.

Requisitos previos

Se deben cumplir los siguientes requisitos previos para que los proyectos de automatización utilicen el SDK de JavaScript de UiPath Robot:

• UiPath Robot 2026.10 installed
• El complemento JavaScript de UiPath instalado en la máquina de Robot

Permitiendo acceso

Cuando se ejecuta el complemento de JavaScript de UiPath Robot, se debe conceder acceso a tu aplicación personalizada o página web para conectarse al robot. El acceso se gestiona mediante un cuadro de diálogo de dos pasos: ambos pasos deben confirmarse para ejecutar RobotJS. Ambos cuadros de diálogo admiten la automatización como se describe en las siguientes secciones.

Explorador de acceso del cuadro de diálogo

Este paso se refiere al explorador que solicita permisos para abrir el UiPath Assistant.

Aceptación automática del cuadro de diálogo de acceso al explorador

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.

Nota:

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.

Cuadro de diálogo de consentimiento de UiPath Robot

El cuadro de diálogo de permiso de UiPath Robot se utiliza para permitir la conexión entre Robot JavaScript SDK y Ejecutor de robot.

Aceptación automática del cuadro de diálogo de permiso de UiPath robot

La variable de entorno del sistema UIPATH_ROBOTJS_ALLOWLIST acepta automáticamente el cuadro de diálogo de consentimiento del 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).

Ejemplo:

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.

El SDK JavaScript de Robot

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. Ejecuta el siguiente comando en la raíz de tu directorio de proyecto:

   npm install --save @uipath/robot
   

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

Nota:

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.

Ajustes del complemento

Para configurar los ajustes del complemento:

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. Añade los parámetros ListenerPort y TokenExpiryInDays a la sección <robotJsSettings>. De forma predeterminada, la sección no contiene ninguna clave:

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

Atributo	Descripción
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.