用户界面自动化活动

上次更新日期 2024年12月4日

插入 Js 脚本

UiPath.Core.Activities.NInjectJsScript

描述

在与 UiElement对应的网页上下文中执行 JavaScript 代码。

This activity must be added inside a Use Application/Browser activity.

To use this activity outside a Use Application/Browseractivity, you need to provide an Input element.

此活动可与对象存储库兼容。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows - 旧版 Windows 配置

设计器面板

单击 “在应用程序/浏览器 中指定”，以指定要用作目标的用户界面元素。

指定目标后，选择“ 菜单” 按钮以访问以下选项：
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。
- 删除信息屏幕截图 - 删除目标应用程序或网页的屏幕截图。
- 添加到对象存储库 - 将当前用户界面元素添加到库项目中，以便在整个自动化流程中重复使用该元素。
“脚本代码”- 要运行的 JavaScript 代码。可在此处将其写作字符串形式，或添加包含待执行代码的 .js 文件的完整路径。其应包含单个匿名函数，如下例所示。
```
function (element, input) {
    return "result";
}function (element, input) {
    return "result";
}
```
```
async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}
```
其中 element 表示与调用用户界面节点对应的 HTML 元素，input 表示调用者提供的输入字符串。
“输入参数”- JavaScript 代码的输入数据，为字符串或字符串变量形式。
将脚本输出保存到 - 用于保存 JavaScript 代码结果的位置。

属性面板

常见

“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。此字段仅支持 Boolean 值（True、 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。
“延迟时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。默认值为 0.3 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
显示名称- 设计器面板中活动的显示名称指定目标时，系统会自动生成显示名称。
“超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。默认值为 30 秒。

输入

“输入参数 ”- 请参阅“设计器”面板中的“ 输入参数 ”。
“脚本代码 ”- 请参阅“ 设计器”面板中的“ 脚本代码 ”。
“目标 ” - 目标元素。必须设置目标元素。在屏幕上指定之前，此字段设置为 (null)。指定目标后，将显示与指定元素相关的所有属性。
- CV 控件类型 - 指示使用 Computer Vision 识别的控件类型。
- 计算机视觉文本 - 表示使用 Computer Vision 识别的文本。
- “模糊选取器 ” - 模糊选取器的参数。
- 原生文本 - 用于标识用户界面元素的文本。
- 响应式网站 - 启用响应式网站布局。
- “严格选取器 ” - 为用户界面元素生成的“严格选取器”。
- 定位方法 - 要用于标识元素的选取器类型。可以将此属性设置为下拉菜单中的任意组合：
  - 无
  - 精确选取器
  - 模糊选取器
  - 图像
  - 原生文本
  - Computer Vision - 要将 Computer Vision 用作定位方法，您需要转到“项目设置”>“Computer Vision”，并确保设置正确的服务器端点。您可以原样保留此字段，并使用 UiPath Cloud（默认情况下已填写），也可以通过选择特定于服务器区域的任何其他公共端点或您自己的本地部署服务器来输入其他值。
    将 Computer Vision 用作定位方法的另一种方法是将“使用本地服务器”设置为 True。这意味着 UiPath.ComputerVision.LocalServer 包已安装在项目中。启用“本地服务器”后，服务器值将被覆盖。但是，“本地服务器”在跨平台项目中不可用。
- 可见性检查 - 检查用户界面元素是否可见。您可以从下拉菜单中选择以下三个选项之一：
  - “无 ”- 不检查可见性。
  - 交互式（用于模糊选取器） - 默认选项。检查元素是否可能可见，忽略页面滚动和其他应用程序的阻碍或应用程序已最小化。当尝试确保您没有以 DOM 中存在但隐藏的不可见元素为目标时，此检查非常有用。
  - 完全可见 - 检查用户界面元素是否可见。
- 等待页面加载 - 在执行 Actions之前，等待应用程序准备好接受输入。您可以从下拉菜单中选择以下三个选项之一：
  - 无- 不等待目标变为就绪状态。
  - “交互式”– 等待直到加载了应用程序的一部分。
  - “完整”– 等待整个应用程序被加载。
- 窗口选取器 (应用程序实例) - 用于应用程序窗口的选取器。仅在窗口附加模式设置为“应用程序实例”时适用。

输入/输出元素

输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。此字段仅支持 UIElement 对象。可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。

其他

“私有” - 如果选中，则不再以“Verbose”级别记录变量和参数的值。此字段仅支持 Boolean (True和 False) 值。默认值为 False。

选项

执行环境 - 用于执行脚本的 JavaScript 环境。从下拉菜单中选择两个选项之一：
- “隔离 ” - 允许访问 HTML 元素，但禁止访问页面变量和代码。使用此选项可确保脚本执行不会与页面冲突。这是默认选择。
- “页面” - 允许访问 HTML 元素、页面变量和代码。如果您需要访问页面变量（例如 jQuery $）或与页面代码交互（例如 window.alert），请使用此选项。要修复此特定于 MV3 扩展程序的已知问题，则需要使用此选项。
您可以通过 “ 项目设置”更改所有“注入 Js 脚本”活动的“执行”世界属性。

输出

“脚本输出”- JavaScript 代码返回的字符串结果。

跨平台配置

在屏幕上指定目标 - 指定要用作目标的用户界面元素。

指定目标后，选择加号按钮以访问以下选项：
- “在屏幕上指定目标”- 再次指定目标。
- 编辑目标 - 打开选择模式以配置目标。

“脚本代码”- 要运行的 JavaScript 代码。可在此处将其写作字符串形式，或添加包含待执行代码的 .js 文件的完整路径。其应包含单个匿名函数，如下例所示。

function (element, input) {
    return "result";
}function (element, input) {
    return "result";
}

async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}async function (element, input) 
{
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
        const timeoutMs = 100;
        setTimeout(() => 
        {
            resolvePromiseCb("async_result");
        }, 
        timeoutMs);
    });
    return asyncResult;
}

其中 element 表示与调用用户界面节点对应的 HTML 元素，input 表示调用者提供的输入字符串。

其他选项

计时

“在此之前延迟”- 上一个活动完成与此活动开始执行任何操作之间的延迟（以秒为单位）。默认值为 0.2 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“延迟时间” - 此活动完成与下一个活动开始执行任何操作之间的延迟时间（以秒为单位）。默认值为 0.3 秒。在活动之间添加延迟可确保一个活动有足够的时间完成，然后再开始下一个活动。
“超时”- 指定最长等待时间（以秒为单位），如果超出该时间后活动并未执行，系统便会抛出错误。默认值为 30 秒。
“出错时继续” - 指定在活动引发错误时是否应继续自动化操作。此字段仅支持 Boolean 值（True、 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设置为 True，则无论出现何种错误，系统都将继续执行项目。

选项

执行环境 - 用于执行脚本的 JavaScript 环境。从下拉菜单中选择两个选项之一：
- “隔离 ” - 允许访问 HTML 元素，但禁止访问页面变量和代码。使用此选项可确保脚本执行不会与页面冲突。这是默认选择。
- “页面” - 允许访问 HTML 元素、页面变量和代码。如果您需要访问页面变量（例如 jQuery $）或与页面代码交互（例如 window.alert），请使用此选项。要修复此特定于 MV3 扩展程序的已知问题，则需要使用此选项。
您可以通过 “ 项目设置”更改所有“注入 Js 脚本”活动的“执行”世界属性。

输出

“脚本输出”- JavaScript 代码返回的字符串结果。

输入/输出

输入元素 - 用于执行活动的用户界面元素，存储在 UIElement 对象中。此字段仅支持 UIElement 对象。可以从其他用户界面自动化活动的 输出元素 属性字段获取此对象。
输出元素 - 输出目标用户界面元素并将其存储在 UIElement 对象中，该对象可进一步用于通过其他活动定位同一元素。