调用 JavaScript 函数 action

在 Browser package 中调用 JavaScript 函数 action 使您能够直接在网页或网页内的 iFrame 中调用现有的 JavaScript 函数。 此 action 还允许您在桌面版 Chromium 嵌入式框架 (CEF) 应用程序中调用 JavaScript 函数。

配置设置

注：
  • 对于 macOS 平台，此操作支持 Google Chrome 和 Safari 浏览器。
  • 对于 Windows 平台，此操作支持 Google Chrome 和基于 Chromium 的 Microsoft Edge 浏览器。
  • 此 action 支持基于 CEF 的桌面应用程序。
  1. 从活动的支持浏览器标签页列表中选择浏览器标签页，或插入窗口变量。 要在 CEF 应用程序中调用 JavaScript 函数，请使用应用程序选项卡。 从应用程序选项卡中，选择应用程序列表中的特定 CEF 应用程序。 CEF 应用程序通过将 Chromium 嵌入桌面应用程序来实现网页浏览功能的集成。
    重要：
    • 要自动化使用 CEF 框架的桌面应用程序，您必须在提升模式下开发和运行自动化程序。 请参阅 Automate applications running as an admin user。
    • 要自动化 CEF 应用程序，请确保使用 3.13.1 及更高版本的浏览器 软件包。
    注：
    • 不支持在 CEF 应用程序中自动执行跨域 iFrame。
    • CEF 应用程序将不会显示在浏览器选项卡中。

    您可以使用正则表达式 (regex) 来标识窗口标题。 将每个正则表达式条件选择为字符串或模式，然后输入值。 默认情况下，窗口标题字段区分大小写。

    要识别浏览器标题，您可以启用区分大小写选项以匹配字母大小写，或禁用该选项以识别字母大小写不匹配的窗口标题。
    注： 确保您系统上安装的最低 Bot Agent 版本是随 Automation 360 v.26 发布的版本。 如果存在随 Automation 360 v.25 或更早版本发布的 Bot Agent 版本，则默认情况下，将仅通过匹配字母大小写（区分大小写）识别窗口标题。
    例如，要匹配所有以单词开头、后跟 - Notepad 的窗口标题名称，您可以输入字符串值 * -Notepad，或者仅为与此模式匹配的窗口标题使用模式值 ((\w)\s)*document-Notepad。
    注：
    • 当您使用类型为字符串的正则表达式，并将 -title 作为任何 action 的窗口标题的输入值时，bot 可能会遇到运行时错误。 为了防止运行时错误，请确保在将字符串输入添加为 *-title 时，具有特定标题的应用程序已打开。 星号 (*) 只是一个字符，而不是通配符。
    • 当您使用类型为 Pattern 的正则表达式，并将 -title 作为任何 action 的窗口标题的输入值时，bot 可能会遇到运行时错误，因为输入值 *-title 是不正确的。

      请确保使用有效的正则表达式模式。

  2. 可选： 使用捕获对象选项捕获 iFrame。
    注： 您可以使用捕获对象功能在 iFrame 内部调用并运行现有的 JavaScript 函数。
  3. 在函数名称字段中，指定您要调用的现有 JavaScript 函数的名称。
  4. 可选： 在参数部分，单击添加参数以添加必须传递给 JavaScript 函数的参数。
    1. 在参数详细信息对话框中，选择特定参数所需的参数类型。
    2. 在值字段中，输入您想传递的所选类型的相应值或变量。
      注： 参数中的所有字符串值都按原样传递，不会转换或转义任何字符。
  5. 可选： 在超时时间字段中，输入 bot 必须等待浏览器操作完成的秒数。
    注： 输入至少 9 秒的超时值。
  6. 在返回类型字段中，选择 JavaScript 函数返回的值类型。
    注： 如果函数没有返回任何内容，在返回类型字段中，选择无。
  7. 对于任何返回类型，除了无，在将结果保存到变量字段中，为所选的返回类型选择一个变量以保存 JavaScript 函数的输出。

创建变量

要为选定的返回类型创建变量，请执行以下步骤：
  1. 单击结果保存到变量字段旁边的创建变量符号。

    将打开创建变量对话框，其中包含所选变量类型的默认变量名称。

  2. 可选： 在描述字段中指定变量信息。
  3. 可选： 在默认值字段中指定值。
  4. 单击创建并选择以选择新创建的变量。

参数和返回类型字段中支持的 JavaScript 类型

支持以下 JavaScript 类型：

  • 字符串、数字和布尔 JavaScript 类型与 bot 变量中的相同变量类型相对应。
  • 数组 JavaScript 类型与 bot 变量中的列表变量类型相对应。
  • 对象 JavaScript 类型与 bot 变量中的字典变量类型相对应。