关于 robot-framework-skill
面向 QA 工程师的 Robot Framework 测试指南,涵盖 Web UI 与 API 测试。内容包括 SeleniumLibrary 和 RequestsLibrary 示例,以及项目配置、云端执行、CI/CD 和故障排查模式。
主要功能
- 01Robot Framework 测试配置与命令
- 02SeleniumLibrary Web UI 测试模式
- 03RequestsLibrary API 测试示例
- 04数据驱动测试与自定义关键字
- 05云端与 CI/CD 配置
- 06故障排查与最佳实践
适用场景
- 01编写浏览器登录测试
- 02测试 API 端点和响应
- 03运行数据驱动测试套件
- 04配置云浏览器或 CI 执行
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ lambdatest/ agent-skills --skill robot-framework-skill安装后在 Claude Code 中输入/robot-framework-skill确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
reference/advanced-patterns.mdcloud-integration.mdplaybook.md详细介绍
Robot Framework 技能
有关 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} [email protected]
${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 [email protected]
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 [email protected] password123
Verify Dashboard Is Displayed
数据驱动测试(模板)
*** Test Cases ***
Login With Various Users
[Template] Login And Verify
[email protected] admin123 Dashboard
[email protected] pass123 Dashboard
[email protected] 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 protected]
${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:
| 章节 | 内容 |
|---|---|
| §1 项目设置 | 项目结构、变量文件、执行命令、pabot |
| §2 Web UI 测试 | 使用 Page Objects 的登录测试、动态内容、等待、模态框 |
| §3 API 测试 | 使用 RequestsLibrary 执行 CRUD、错误处理、验证、身份验证 |
| §4 数据驱动测试 | 使用 CSV 的 DataDriver、FOR 循环、批量操作 |
| §5 自定义 Python 库 | @keyword 装饰器、资源跟踪、测试数据生成 |
| §6 Browser Library | 基于 Playwright 的现代测试、网络拦截、响应式测试 |
| §7 LambdaTest 集成 | 远程浏览器配置、跨浏览器套件、状态报告 |
| §8 CI/CD 集成 | 使用矩阵策略的 GitHub Actions、pabot 并行执行、报告合并 |
| §9 调试表 | 12 个常见问题及其原因和解决方法 |
| §10 最佳实践 | 14 项 Robot Framework 检查清单 |
评论
支持 Markdown