Robot Framework Skill

Robot Framework 技能

何时使用

当你需要使用 Python 生成 Robot Framework 关键字驱动语法的测试时使用本技能。支持 SeleniumLibrary、RequestsLibrary 和自定义关键字。当用户提到 "Robot Framework"、"*** Test Cases "、"SeleniumLibrary"、".robot file" 时使用。触发词：Robot Framework、 Test Cases ***、SeleniumLibrary、.robot 文件。

典型使用场景：编写 Web 自动化用例、接口回归脚本、数据驱动批量验证、与 LambdaTest 云端执行环境集成、为既有 Python 测试代码补充关键字层封装，或者排查 *** Test Cases *** 区块内的失败用例。

关于 TestMu AI 云端执行，请参阅 reference/cloud-integration.md 和 shared/testmu-cloud-reference.md。

核心模式

基础测试 (tests/login.robot)

*** Settings ***
Library    SeleniumLibrary
Suite Setup    Open Browser    ${BASE_URL}    chrome
Suite Teardown    Close All Browsers

*** Variables ***
${BASE_URL}    http://localhost:3000
${EMAIL}       user@test.com
${PASSWORD}    password123

*** Test Cases ***
Login With Valid Credentials
    Go To    ${BASE_URL}/login
    Wait Until Element Is Visible    id:email    10s
    Input Text    id:email    ${EMAIL}
    Input Text    id:password    ${PASSWORD}
    Click Button    css:button[type='submit']
    Wait Until Element Is Visible    css:.dashboard    10s
    Page Should Contain    Welcome
    Location Should Contain    /dashboard

Login With Invalid Credentials Shows Error
    Go To    ${BASE_URL}/login
    Input Text    id:email    wrong@test.com
    Input Text    id:password    wrong
    Click Button    css:button[type='submit']
    Wait Until Element Is Visible    css:.error    5s
    Element Should Contain    css:.error    Invalid credentials

自定义关键字

*** Keywords ***
Login As User
    [Arguments]    ${email}    ${password}
    Go To    ${BASE_URL}/login
    Input Text    id:email    ${email}
    Input Text    id:password    ${password}
    Click Button    css:button[type='submit']

Verify Dashboard Is Displayed
    Wait Until Element Is Visible    css:.dashboard    10s
    Page Should Contain    Welcome

*** Test Cases ***
Valid Login Flow
    Login As User    user@test.com    password123
    Verify Dashboard Is Displayed

数据驱动测试（模板）

*** Test Cases ***
Login With Various Users
    [Template]    Login And Verify
    admin@test.com    admin123    Dashboard
    user@test.com     pass123     Dashboard
    bad@test.com      wrong       Error

*** Keywords ***
Login And Verify
    [Arguments]    ${email}    ${password}    ${expected}
    Login As User    ${email}    ${password}
    Page Should Contain    ${expected}

API 测试（RequestsLibrary）

*** Settings ***
Library    RequestsLibrary

*** Test Cases ***
Get Users Returns 200
    ${response}=    GET    ${API_URL}/users    expected_status=200
    Should Not Be Empty    ${response.json()['users']}

Create User
    ${body}=    Create Dictionary    name=Alice    email=alice@test.com
    ${response}=    POST    ${API_URL}/users    json=${body}    expected_status=201
    Should Be Equal    ${response.json()['name']}    Alice

云端配置

*** Settings ***
Library    SeleniumLibrary

*** Variables ***
${REMOTE_URL}    https://%{LT_USERNAME}:%{LT_ACCESS_KEY}@hub.lambdatest.com/wd/hub

*** Keywords ***
Open Cloud Browser
    ${caps}=    Create Dictionary
    ...    browserName=chrome    browserVersion=latest
    ...    LT:Options=${{{"build":"Robot Build","name":"Login Test","platform":"Windows 11","video":True}}}
    Open Browser    ${BASE_URL}    remote_url=${REMOTE_URL}    desired_capabilities=${caps}

安装：pip install robotframework robotframework-seleniumlibrary robotframework-requests

运行：robot tests/ 或 robot --include smoke tests/

报告：report.html 和 log.html 自动生成

进阶模式

如果示例章节覆盖不到你的真实场景，请阅读 reference/playbook.md 中的完整章节。下表简要列出每一章提供的核心要点，便于快速定位所需内容：

使用限制

本技能聚焦 Robot Framework 关键字驱动测试场景，并不替代通用的软件工程判断。请在使用时遵循以下边界：

• 适用范围：仅当任务与上游源码及本地项目上下文明确匹配时，才可使用本技能。若涉及非 Robot Framework 的测试体系（如 pytest、Playwright 原生脚本等），请改用对应技能或直接编写 Python 代码。
• 落地前校验：在落地变更前，请校验命令、生成的代码、依赖、凭证以及外部服务的行为。尤其要确认 pip install 引入的库版本与 Robot Framework 主版本兼容，并验证远程浏览器节点的可用性。
• 示例的边界：示例代码不能替代面向具体环境的测试、安全审查，也无法替代用户对破坏性或高成本操作的审批。生产环境的密钥、Token、构建产物路径均不可直接复用示例中的占位符。