在进行UI自动化测试时，我们经常会遇到内容被分割成多页显示的情况。传统的点击“下一页”按钮进行翻页的场景相对简单，但如果页面没有明确的翻页按钮，而是依赖于特定的键盘操作（如按下 Enter 键），并且分页结束的判断依据是页面上某个元素的消失或内容变化，那么就需要更灵活的策略来处理。Karate UI提供了强大的能力，特别是通过waitUntil函数结合自定义JavaScript逻辑，能够优雅地解决这类复杂的分页场景。
挑战与解决方案概述
假设我们有一个UI界面，其内容分多页显示。每次翻页需要模拟按下 Enter 键，而判断是否到达最后一页的依据是某个特定的DOM元素（例如一个显示“更多数据”的提示信息）不再出现。我们的目标是遍历所有页面，提取每页的关键数据，并将它们合并起来进行最终的断言验证。
Karate的waitUntil函数是解决此问题的核心。它会重复执行一个JavaScript函数，直到该函数返回 true。这使得我们能够在一个循环中执行以下操作：
- 提取当前页面的数据。
- 检查分页结束条件。
- 如果未结束，则模拟 Enter 键翻页。
- 如果已结束，则返回 true 终止循环。
逐步实现分页数据采集
我们将通过一个具体的示例来演示如何实现这一过程。
1. 初始化数据存储
首先，我们需要一个变量来存储从所有页面收集到的数据。在Karate中，可以使用 * def 关键字定义一个空数组：
* def allData = []
2. 定义循环处理函数
接下来，定义一个JavaScript函数，该函数将作为 waitUntil 的参数被重复执行。这个函数需要包含数据提取、条件判断和翻页逻辑。
* def loopContent =
"""
function() {
// 检查分页结束条件：如果特定的提示元素不存在，则认为已到达最后一页
// 假设 '.messageNumber' 是一个指示还有更多数据的元素
if (!exists('.messageNumber')) {
// 如果元素不存在，说明是最后一页，提取数据并返回 true 终止循环
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); // 将当前页数据添加到 allData 数组
return true; // 返回 true 告知 waitUntil 停止循环
}
// 如果 '.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); // 将当前页数据添加到 allData 数组
// 模拟按下 Enter 键进行翻页
input('body', Key.ENTER);
return false; // 返回 false 告知 waitUntil 继续循环
}
"""函数解析：
- exists('.messageNumber'): 这是判断分页结束的关键。我们假设页面上有一个 class="messageNumber" 的元素，它会在有更多数据时显示，在最后一页时消失。当 !exists('.messageNumber') 为 true 时，表示已到达最后一页。
- locateAll('form div', x => { ... }): 这部分用于从当前页面提取数据。它查找所有 form div 元素，并根据其 id 属性（例如以 line1_R 开头）进行过滤。
- list.map(x => x.text.trim()): 将找到的DOM元素的文本内容提取出来并去除空白。
- allData.push(data): 将当前页提取到的数据添加到 allData 数组中。
- input('body', Key.ENTER): 模拟在 body 元素上按下 Enter 键，触发页面加载下一页内容。
- return true;: 当满足终止条件时，函数返回 true，waitUntil 将停止执行。
- return false;: 当不满足终止条件时，函数返回 false，waitUntil 将继续执行。
3. 执行 waitUntil
定义好 loopContent 函数后，就可以使用 waitUntil 来执行它了：
* waitUntil(loopContent)
waitUntil 会持续调用 loopContent，直到它返回 true。
4. 打印和验证结果
循环结束后，allData 变量将包含从所有页面收集到的数据。你可以打印它进行检查，或者直接用于后续的断言。
* print allData
5. 数据去重处理
在某些情况下，由于页面加载或数据提取的时机，allData 中可能会包含重复的数据。Karate提供了一个方便的内置函数 karate.distinct() 来去除数组中的重复项：
* def cleanedData = karate.distinct(allData) * print cleanedData
完整示例代码
将上述步骤整合到一起，一个完整的Karate UI分页处理脚本如下：
Feature: Handle paginated UI content with conditional logic
Scenario: Collect all data from paginated UI
# 假设已经导航到目标页面
# 例如：* driver 'http://your-app-url/paginated-page'
* def allData = []
* def loopContent =
"""
function() {
// 检查分页结束条件：如果特定的提示元素（例如 .messageNumber）不存在，则认为已到达最后一页
// 注意：根据实际页面结构调整此选择器和判断逻辑
if (!exists('.messageNumber')) {
// 最后一页，提取数据并返回 true 终止循环
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); // 将当前页数据添加到 allData 数组
return true; // 返回 true 告知 waitUntil 停止循环
}
// 如果 '.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); // 将当前页数据添加到 allData 数组
// 模拟按下 Enter 键进行翻页
input('body', Key.ENTER);
return false; // 返回 false 告知 waitUntil 继续循环
}
"""
* waitUntil(loopContent)
* print 'Collected all data:'
* print allData
# 对收集到的数据进行去重处理
* def cleanedData = karate.distinct(allData)
* print 'Cleaned (deduplicated) data:'
* print cleanedData
# 进行断言验证
* match cleanedData contains ['expected_data_from_page1', 'expected_data_from_page2']
# ... 其他断言注意事项与最佳实践
- 选择器的健壮性： 确保用于定位数据和判断条件的CSS选择器是稳定且唯一的。页面结构的变化可能导致选择器失效。
- 条件判断的准确性： 分页结束的条件判断至关重要。仔细分析页面，找到最可靠的指示符（例如特定元素的消失、文本内容的改变、或某个计数器的归零）。
- 数据重复： 考虑到 waitUntil 的执行机制，以及页面加载的时序，有时可能会出现第一页或最后一页的数据被重复收集的情况。使用 karate.distinct() 是一个很好的后处理方式。如果需要更精细的控制，可以在 loopContent 函数内部实现更复杂的逻辑来避免重复，例如只添加新加载的数据。
- 性能考虑： 频繁的UI交互（如 input('body', Key.ENTER)）和DOM操作可能会影响测试执行速度。对于数据量非常大的分页，可能需要权衡测试的全面性和执行效率。
- 错误处理： 在 loopContent 函数中，可以加入 karate.fail("...") 来处理非预期的页面状态，从而在测试过程中及时发现问题。
- 异步加载： 如果页面内容是异步加载的，确保在提取数据之前，内容已经完全加载并稳定。Karate的 waitUntil 本身就能处理一定程度的异步等待，但有时可能需要额外的 karate.waitFor() 或更具体的等待条件。
通过上述方法，我们可以有效地在Karate UI自动化测试中处理复杂的、基于条件和键盘操作的分页场景，确保所有相关数据都能被准确地收集和验证。
