robot

latest

false

Robot JavaScript SDK
- Acerca del SDK JavaScript de Robot
- Pasos de configuración
- Especificaciones de SDK
  - Campos de configuración

Importante :

La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Guía del desarrollador de Robot

Última actualización 3 de feb. de 2026

Pasos de configuración

Requisitos previos

Para que tus proyectos de automatización aprovechen el SDK JavaScript de Robot, deben cumplirse los siguientes requisitos previos:

Studio y Robot versión 2021.10 o superior instalada
El complemento JavaScript de UiPath instalado en la máquina de Robot

Permitiendo acceso

Cuando se ejecuta el complemento de JavaScript de UiPath robot, debes proporcionar acceso a tu aplicación o página web personalizada para conectarte al robot.

El acceso se gestiona mediante un cuadro de diálogo en dos pasos. Ambos pasos deben confirmarse para ejecutar RobotJS. Pueden automatizarse como se describe a continuación.

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

Puede automatizarse añadiendo el uipath-web://*valor como una url de confianza (permitida) en la configuración del navegador. El se uipath-web://*refiere al controlador de protocolo web de UiPath Robot.

Nota:

Según el explorador utilizado, hay que establecer diferentes configuraciones. Por ejemplo, si utilizas Google Chrome, sigue los pasos descritos en la documentación de Google Chrome URLAllowList.

docs image

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. docs image

Esto puede permitirse automáticamente añadiendo la variable de entorno del UIPATH_ROBOTJS_ALLOWLISTsistema.

Los valores utilizados en la variable deben ser las URL de tu página web o aplicación personalizada, separados por punto y coma. La URL debe contener solo el número de puerto si no se utiliza un puerto estándar ( 80o 443).

El SDK JavaScript de Robot

Este SDK proporciona todos los métodos y propiedades necesarios que puedes incluir en tu aplicación o página web personalizada. Puedes descargarlo de la siguiente forma:

NPM

El paquete npm está disponible con vinculaciones de TypeScript. Para incluirlo en tu proyecto, deberás ejecutar el siguiente comando en la raíz del directorio de tu proyecto:

npm install --save @uipath/robot
npm install --save @uipath/robot

CDN

Para CDN, deberás incluir el SDK antes de cerrar la etiqueta </body>.

<body>
...
...
<script href="//download.uipath.com/js/1.3.2/UiPathRobot.js"></script>
</body>
<body>
...
...
<script href="//download.uipath.com/js/1.3.2/UiPathRobot.js"></script>
</body>

Descarga directa

También puedes obtener el SDK JavaScript de Robot mediante descarga directa.

Ajustes del complemento

Para cambiar la configuración del complemeto, debes añadir los TokenExpiryInDaysparámetros ListenerPorty en el uipath.configarchivo desde la carpeta de instalación. De forma predeterminada, la sección no contiene ninguna clave.

El archivo de configuración debe contener lo siguiente:

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

Atributo	Descripción
`ListenerPort`	El `UiPath.RobotJS.ServiceHost.exe` inicia un HttpListener en el puerto configurado y contiene la información sobre otros listeners locales de la sesión del usuario activo en ese sistema. Ten en cuenta que aquí el valor del puerto debe coincidir con el que se configura en los Ajustes del SDK.
`TokenExpiryInDays`	Cualquier solicitud que provenga de un nuevo dominio debe tener consentimiento del usuario para permitir el acceso de UiPath Robots desde una aplicación web. Estos consentimientos son válidos para el número de días mencionado en este ajuste.