Karate UI自动化中基于条件逻辑处理分页数据提取教程

引言与挑战

在ui自动化测试中，处理需要翻页才能完整查看的内容是一个常见场景。当页面提供明确的“下一页”按钮时，自动化相对直接。然而，某些复杂的ui设计可能不提供此类按钮，而是依赖于特定的键盘输入（例如按下enter键）来加载下一页内容。此外，判断何时到达内容末尾的逻辑也可能不是基于固定元素，而是基于页面上特定文本的出现或消失，或某个元素的有无。

本教程将聚焦于Karate UI自动化中解决这类挑战的方法。具体来说，我们将探讨如何：

1. 在没有明确“下一页”按钮的情况下，通过模拟键盘输入进行翻页。
2. 利用条件逻辑判断当前页面是否为内容的最后一页。
3. 从每一页中提取所需数据并进行汇总。
4. 处理可能出现的重复数据。

核心策略：waitUntil与JavaScript函数

Karate UI提供了一个强大的waitUntil功能，它能够重复执行一个JavaScript函数，直到该函数返回true。这使得waitUntil成为处理动态页面加载和条件循环的理想选择。结合内联JavaScript函数，我们可以在循环中实现复杂的逻辑，包括数据提取、条件判断和页面交互。

1. 数据提取与收集

首先，我们需要一个机制来收集所有页面的数据。在Karate中，我们可以定义一个全局的JavaScript数组来存储这些数据。对于每一页，可以使用locateAll结合JavaScript的map函数来提取特定元素的内容。

* def allData = []

2. 实现条件翻页与终止逻辑

关键在于构建一个JavaScript函数，该函数将在waitUntil的循环中执行。这个函数需要完成以下任务：

• 提取当前页数据： 使用locateAll和map获取当前页面的相关数据。
• 判断是否到达末页： 根据页面上特定的元素或文本来判断。例如，如果某个指示“更多数据”的元素不再存在，或者某个“消息编号”元素消失，则认为已到达末页。
• 执行翻页操作： 如果未到达末页，则模拟键盘输入（如Key.ENTER）来加载下一页。
• 返回循环状态： 如果已到达末页，函数应返回true，以终止waitUntil循环；否则，不返回或返回false，让循环继续。

以下是一个示例JavaScript函数，它结合了数据提取、条件判断和翻页逻辑：

* def allData = []
* def loopContent =
"""
function() {
    // 1. 检查是否存在表示“更多数据”的元素，或特定消息编号元素
    // 假设 '.messageNumber' 元素在最后一页会消失或不再显示“更多数据”的提示
    if (!exists('.messageNumber')) {
        // 如果 '.messageNumber' 不存在，则认为已到达最后一页
        // 提取当前页面的数据
        let list = locateAll('form div', x => {
            let id = x.attribute('id');
            return id ? id.startsWith('line1_R') : false
        });
        let data = list.map(x => x.text.trim());
        allData.push(data); // 将最后一页的数据加入
        return true; // 返回 true 终止 waitUntil 循环
    }

    // 2. 如果 '.messageNumber' 仍然存在，说明还有更多页面
    // 提取当前页面的数据
    let list = locateAll('form div', x => {
        let id = x.attribute('id');
        return id ? id.startsWith('line1_R') : false
    });
    let data = list.map(x => x.text.trim());
    allData.push(data); // 将当前页数据加入

    // 3. 模拟按下 Enter 键加载下一页
    input('body', Key.ENTER);

    // 4. 返回 false (或不返回任何值) 让 waitUntil 继续循环
    return false;
}
"""

代码解释：

硅基智能

基于Web3.0的元宇宙，去中心化的互联网，高质量、沉浸式元宇宙直播平台，用数字化重新定义直播

62

查看详情

• allData: 一个全局数组，用于存储从所有页面提取的数据。
• loopContent函数：
  • !exists('.messageNumber'): 这是一个关键的条件判断。它检查页面上是否存在类名为messageNumber的元素。如果该元素不存在，则假设已经到达了内容的末尾。你可以根据实际页面的HTML结构调整这个判断条件，例如检查特定文本内容 (script('.Text','_.textContent').trim() != "reminder more data to view")。
  • locateAll('form div', x => { ... }): 这行代码用于查找符合特定条件的div元素（例如，id以line1_R开头），并将其文本内容提取出来。
  • allData.push(data): 将当前页提取到的数据添加到allData数组中。
  • input('body', Key.ENTER): 模拟在页面主体上按下Enter键，触发加载下一页的操作。
  • return true;: 当满足终止条件时，函数返回true，waitUntil将停止执行。
  • return false;: 当不满足终止条件时，函数返回false，waitUntil将继续执行loopContent函数。

3. 执行 waitUntil

定义好loopContent函数后，只需调用waitUntil即可启动循环：

* waitUntil(loopContent)
* print allData

waitUntil(loopContent)会反复调用loopContent函数，直到loopContent返回true。一旦循环结束，allData数组中就包含了从所有页面收集到的数据。

数据去重与优化

在收集数据的过程中，尤其是在每次翻页都完整提取当前页所有内容时，可能会出现重复数据。Karate提供了一个方便的内置函数karate.distinct()来处理数组去重：

* def cleanedData = karate.distinct(allData)
* print cleanedData

karate.distinct()会返回一个新数组，其中包含allData中所有唯一的元素。

优化提示： 如果性能是关键因素，并且页面内容非常庞大，你可能希望在loopContent函数内部实现更精细的逻辑，只push()新加载的或尚未收集的数据，而不是每次都收集所有可见数据然后去重。但这会增加JavaScript函数的复杂性，需要更精确地识别新旧数据边界。对于大多数场景，karate.distinct()已足够高效。

注意事项

1. 页面加载时间： waitUntil本身具有隐式的等待机制，因为它会重复执行直到条件满足。然而，在某些情况下，input('body', Key.ENTER)触发下一页加载后，页面内容可能不会立即更新。如果遇到不稳定的情况，可以在input命令后添加适量的karate.sleep(milliseconds)来确保页面有足够的时间渲染。
2. 健壮性： 确保你的条件判断逻辑足够健壮，能够准确识别页面的末尾。如果条件判断有误，可能会导致无限循环或提前终止。
3. 错误处理： 可以在JavaScript函数内部添加karate.fail("Error message")来处理意外情况，例如，如果页面结构发生变化导致数据无法提取，或者进入了预料之外的状态。
4. 调试： 使用print语句在loopContent函数内部输出变量值，可以帮助你调试和理解循环的执行过程。

总结

通过巧妙地结合Karate的waitUntil功能和自定义JavaScript函数，我们可以高效地处理复杂的UI自动化场景，例如在没有直接“下一页”按钮的情况下进行分页导航，并根据动态条件判断循环终止。这种方法不仅能够灵活地提取和汇总跨页数据，还能通过karate.distinct()等辅助函数进一步优化数据处理流程，从而构建出更加健壮和高效的自动化测试脚本。掌握这种模式，将大大提升你在处理复杂Web应用UI自动化时的能力。

以上就是Karate UI自动化中基于条件逻辑处理分页数据提取教程的详细内容，更多请关注php中文网其它相关文章！