运行设置

使用 RunSettings 类，你可以灵活调整测试执行的行为，包括 API 调用的超时时间、慢动作模式（控制操作间隔时间），以及是否输出操作报告等设置。

你可以通过以下方式引入 RunSettings 对象：

JavaScript
Python
const { RunSettings } = require('leanpro.common');
from leanproAuto import RunSettings

如何设置 RunSettings

你可以通过以下两种方式来配置运行设置：

  1. 拖拽配置：从代码工具箱中的“常用”->“运行设置”拖动至代码区域，自动生成配置代码。
  2. 手动设置：在脚本中引用 leanpro.common 库中的 RunSettings 类，手动进行设置。

RunSettings 提供以下几个常用的配置项，帮助你更好地控制测试的执行流程：

JavaScript
Python
export class RunSettings {
    static defaultTimeout: number;  // 超时时间（毫秒），默认为 5000 毫秒
    static slowMo: number;  // 慢动作模式的延迟时间（毫秒），默认为 0（关闭）
    static reportSteps: boolean;  // 是否输出每步操作的报告，默认为 false（禁用）
}
class RunSettings():
    defaultTimeout: int  # 超时时间（毫秒）
    slowMo: int  # 慢动作模式延迟时间（毫秒）
    reportSteps: bool  # 是否输出每步操作的报告

超时时间：defaultTimeout

设置每个自动化操作（如点击、输入、滚动等）的最大超时时间，单位为毫秒（ms）。默认值为 5000 毫秒（5 秒）。在超时时间内，自动化操作会反复尝试，直到成功或超时。

示例：

JavaScript
Python
const { RunSettings } = require('leanpro.common');
RunSettings.set({
    defaultTimeout: 10000  // 设置超时时间为 10 秒
});
from leanproAuto import RunSettings
RunSettings.set({
    'defaultTimeout': 10000  # 设置超时时间为 10 秒
})

如果你需要修改特定步骤函数的超时时间，可以参考：步骤超时。

慢动作：slowMo

设置自动化操作之间的最小间隔时间，单位为毫秒（ms）。默认值为 0，表示关闭慢动作模式。通过启用慢动作模式，你可以让测试执行速度变慢，方便观察执行过程或进行调试。

适用场景：调试复杂的自动化操作时，可以启用慢动作模式，放慢操作间隔时间，更直观地查看每一步操作是否按预期执行。

示例：

JavaScript
Python
const { RunSettings } = require('leanpro.common');
RunSettings.set({
    slowMo: 2000  // 设置每步操作之间的间隔时间为 2 秒
});
from leanproAuto import RunSettings
RunSettings.set({
    'slowMo': 2000  # 设置每步操作之间的间隔时间为 2 秒
})

操作报告：reportSteps

控制是否在输出面板中打印每个自动化操作的详细报告信息。报告包括点击、输入、滚动等操作，以及应用启动和关闭的状态。默认为 false（禁用），你可以通过设置为 true 来启用该功能。

当 reportSteps 设置为 true 时：

  • 调用控件的 takeScreenshot() 方法后，截图的缩略图会显示在输出面板中。
  • 执行 checkImage() 并检测到图像差异时，差异截图的缩略图也会一同显示，便于快速对比与定位问题。

适用场景：开启操作报告有助于在调试时查看每个操作的执行情况，尤其是在截图或图像比对的场景下，可直观查看图像结果。

用法示例：

JavaScript
Python
const { RunSettings } = require('leanpro.common');
RunSettings.set({
    reportSteps: true  // 启用详细操作报告
});
from leanproAuto import RunSettings
RunSettings.set({
    'reportSteps': True  # 启用详细操作报告
})

示例输出：

[17:38:56] 运行脚本 "C:\temp\recording.js"
[17:38:58] 启动应用"C:\Program Files\LeanPro\CukeTest\bin\notepad.exe"，插件qt
[17:38:59] 点击Button "Font"
[17:39:00] 点击Button "OK"
[17:39:01] 退出应用Application

results matching ""

全部 API Walkthrough 其他

    No results matching ""