调用 JavaScript 函数 操作
- Updated: 2025/07/04
调用 JavaScript 函数 操作
在 浏览器 软件包 中调用 JavaScript 函数 操作 使您能够直接在网页或网页内的 iFrame 中调用现有的 JavaScript 函数。 此 操作 还允许您在桌面版 Chromium 嵌入式框架 (CEF) 应用程序中调用 JavaScript 函数。
配置设置
注：
- 对于 MacOS 平台，此操作支持 Google Chrome 和 Safari 浏览器。
- 对于 Windows 平台，此操作支持 Google Chrome 和基于 Chromium 的 Microsoft Edge 浏览器。
- 此 操作 支持基于 CEF 的桌面应用程序。
- 从活动的支持浏览器标签页列表中选择浏览器标签页，或插入窗口变量。 要在 CEF 应用程序中调用 JavaScript 函数，请使用应用程序选项卡。 从应用程序选项卡中，选择应用程序列表中的特定 CEF 应用程序。 CEF 应用程序通过将 Chromium 嵌入桌面应用程序来实现网页浏览功能的集成。重要：
- 要自动化使用 CEF 框架的桌面应用程序，您必须在提升模式下开发和运行自动化程序。 请参阅 自动运行以管理员身份运行的应用程序。
- 要自动化 CEF 应用程序，请确保使用 3.13.1 及更高版本的浏览器 软件包。
注：- 不支持在 CEF 应用程序中自动执行跨域 iFrame。
- CEF 应用程序将不会显示在浏览器选项卡中。
您可以使用正则表达式 (regex) 来标识窗口标题。 将每个正则表达式条件选择为字符串或模式，然后输入值。 默认情况下，窗口标题字段区分大小写。
要识别浏览器标题，您可以启用区分大小写选项以匹配字母大小写，或禁用该选项以识别字母大小写不匹配的窗口标题。注： 确保您系统上安装的最低 机器人代理 版本是随 Automation 360 v.26 发布的版本。 如果存在随 Automation 360 v.25 或更早版本发布的 机器人代理 版本，则默认情况下，将仅通过匹配字母大小写（区分大小写）识别窗口标题。例如，要匹配所有以单词开头、后跟- Notepad的窗口标题名称，您可以输入字符串值 * -Notepad，或者仅为与此模式匹配的窗口标题使用模式值 ((\w)\s)*document-Notepad。注：- 当您使用类型为字符串的正则表达式，并将 -title 作为任何 操作 的窗口标题的输入值时，机器人 可能会遇到运行时错误。 为了防止运行时错误，请确保在将字符串输入添加为 *-title 时，具有特定标题的应用程序已打开。 星号 (*) 只是一个字符，而不是通配符。
- 当您使用类型为 Pattern 的正则表达式，并将 -title 作为任何 操作 的窗口标题的输入值时，机器人 可能会遇到运行时错误，因为输入值 *-title 是不正确的。
请确保使用有效的正则表达式模式。
-
可选： 使用捕获对象选项捕获 iFrame。注： 您可以使用捕获对象功能在 iFrame 内部调用并运行现有的 JavaScript 函数。
- 在函数名称字段中，指定您要调用的现有 JavaScript 函数的名称。
-
可选： 在参数部分，单击添加参数以添加必须传递给 JavaScript 函数的参数。
- 在参数详细信息对话框中，选择特定参数所需的参数类型。
- 在值字段中，输入您想传递的所选类型的相应值或变量。注： 参数中的所有字符串值都按原样传递，不会转换或转义任何字符。
-
可选： 在超时时间字段中，输入 机器人 必须等待浏览器操作完成的秒数。注： 输入至少 9 秒的超时值。
- 在返回类型字段中，选择 JavaScript 函数返回的值类型。注： 如果函数没有返回任何内容，在返回类型字段中，选择无。
- 对于任何返回类型，除了无，在将结果保存到变量字段中，为所选的返回类型选择一个变量以保存 JavaScript 函数的输出。
创建变量
要为选定的返回类型创建变量，请执行以下步骤：
- 单击结果保存到变量字段旁边的创建变量符号。
将打开创建变量对话框，其中包含所选变量类型的默认变量名称。
- 可选： 在描述字段中指定变量信息。
- 可选： 在默认值字段中指定值。
- 单击创建并选择以选择新创建的变量。
参数和返回类型字段中支持的 JavaScript 类型
支持以下 JavaScript 类型：
- 字符串、数字和布尔 JavaScript 类型与 机器人 变量中的相同变量类型相对应。
- 数组 JavaScript 类型与 机器人 变量中的列表变量类型相对应。
- 对象 JavaScript 类型与 机器人 变量中的字典变量类型相对应。