如何在Robot Framework中创建适配含变量的不同XPath的通用关键字

步骤1：编写辅助关键字（批量获取元素文本） #

先封装一个辅助关键字，用于批量提取元素的文本内容，减少重复代码：

*** Keywords ***
Get Element Texts
    [Arguments]    ${locator}
    ${webelements}=    Get Webelements    ${locator}
    ${text_list}=    Create List
    FOR    ${element}    IN    @{webelements}
        ${text}=    Get Text    ${element}
        Append To List    ${text_list}    ${text}
    END
    [Return]    ${text_list}

步骤2：编写通用核心关键字 #

创建通用关键字封装所有重复逻辑，支持动态XPath替换和按需构建列表：

*** Keywords ***
Generate Column Data Dictionary
    [Arguments]    ${total_columns_locator}    ${xpath_template}    ${key_template}="Column_{column_index}"
    # 初始化结果字典
    ${result_dict}=    Create Dictionary
    # 获取总列数
    ${column_count}=    Get Element Count    ${total_columns_locator}
    
    # 遍历每一列
    FOR    ${column_index}    IN RANGE    1    ${column_count}+1
        # 替换XPath模板中的列索引占位符
        ${current_xpath}=    Format String    ${xpath_template}    column_index=${column_index}
        
        # 检查当前列元素是否可见（返回布尔值）
        ${elements_visible}=    Run Keyword And Return Status    Element Should Be Visible    ${current_xpath}
        
        # 按需生成文本列表：元素可见则提取文本，否则返回空列表
        ${text_list}=    Run Keyword If    ${elements_visible}    Get Element Texts    ${current_xpath}    ELSE    Create List
        
        # 生成当前列的字典键
        ${current_key}=    Format String    ${key_template}    column_index=${column_index}
        
        # 将文本列表存入字典
        Set To Dictionary    ${result_dict}    ${current_key}=${text_list}
    END
    
    [Return]    ${result_dict}

步骤3：在测试用例中复用通用关键字 #

根据不同的XPath结构，传入对应的模板即可快速复用逻辑：

示例1：列索引在XPath第一个节点

*** Test Cases ***
Extract Data With Index In First Node
    # 替换为你实际的总列数定位器
    ${total_cols_locator}=    Set Variable    ${total_columns}
    # 定义XPath模板，用{column_index}作为占位符
    ${xpath_template}=    Set Variable    //div[@class='abc'][{column_index}]/div[1]/div[2]
    # 生成数据字典（使用默认键模板：Column_1、Column_2...）
    ${data_dict}=    Generate Column Data Dictionary    ${total_cols_locator}    ${xpath_template}
    
    # 后续操作示例：打印字典内容
    Log Dictionary    ${data_dict}

示例2：列索引在XPath最后一个节点

*** Test Cases ***
Extract Data With Index In Last Node
    ${total_cols_locator}=    Set Variable    ${total_columns}
    ${xpath_template}=    Set Variable    //div[@class='abc']/div[1]/div[2][{column_index}]
    # 自定义键模板：直接用列索引作为键
    ${key_template}=    Set Variable    ${column_index}
    ${data_dict}=    Generate Column Data Dictionary    ${total_cols_locator}    ${xpath_template}    ${key_template}
    
    Log Dictionary    ${data_dict}

关键优化说明 #

• 动态XPath适配：通过Format String将列索引插入到XPath的任意位置，兼容不同页面结构。
• 按需创建列表：仅在元素可见时才生成文本列表，避免不必要的空列表初始化。
• 逻辑完全复用：所有循环、元素检查、字典赋值逻辑都封装在通用关键字中，测试用例只需传入差异化参数。

内容的提问来源于stack exchange，提问作者Machindra Kale