项目集成及使用 Codegen 生成测试用例

pip pytest-playwright

接口自动化测试框架/
├── business/                      # 业务逻辑层（接口封装层，解耦用例与接口细节）
│   └── __init__.py
├── common/                        # 【核心】公共工具模块（复用性代码，核心层）
│   ├── __init__.py                # 标记为Python包
│   ├── get_data.py                # 数据获取工具，内有 load_toml 函数
│   └── database.py                # 数据库封装工具
├── cases/                         # 自动化用例目录（仅调用业务层，不写具体逻辑）
│   └── __init__.py
├── config/                        # 配置文件目录（与代码解耦，环境切换核心）
│   └── __init__.py
├── data/                          # 测试数据目录（数据驱动，与用例分离）
├── docs/                          # 项目文档目录（团队协作必备）
│   ├── api_docs.md                # 接口文档（地址、参数、请求方式、响应示例）
│   └── usage_guide.md             # 使用指南（环境搭建、运行命令、问题排查）
├── pytest.toml                    # pytest 配置文件
├── run.py                         # 项目启动文件（入口）
├── requirements.txt               # 项目依赖包（指定版本，避免环境问题）
└── README.md                      # 项目说明（必选，快速上手：环境、运行、目录说明）

playwright install --help

用法：playwright 安装 [选项] [浏览器...]

确保安装了此版本 Playwright 所需的浏览器。

选项：
--with-deps  安装浏览器的系统依赖项
--dry-run    不执行安装，仅打印信息
--force      强制重新安装稳定浏览器通道
--only-shell 安装 Chromium 时仅安装无头 shell
--no-shell   安装 Chromium 时不安装无头 shell
-h, --help   显示命令的帮助信息



示例：
- $ install
安装默认浏览器，包括 Chromium、Firefox 和 WebKit 三种引擎开源浏览器

- $ install chrome firefox
安装自定义浏览器，支持 chromium、chromium-headless-shell、chromium-tip-of-tree-headless-shell、chrome、chrome-beta、msedge、msedge-beta、msedge-dev、bidi-chromium、firefox、webkit。

playwright install-deps

# 安装默认浏览器，包括 Chromium、Firefox 和 WebKit 三种引擎开源浏览器
playwright install
# 安装特定浏览器，比如 Chromium
playwright install Chromium

# cases/test_example.py
from playwright.sync_api import Page
from playwright.sync_api import expect


def test_goto_baidu(page: Page):
    page.goto("https://baidu.com/")
    page.wait_for_timeout(2000)
    expect(page.get_by_role("link", name="新闻")).to_be_visible()

# 使用开源 chromium 浏览器（默认），--headed 会显示画面，调试时使用。实际测试时无需使用
python run.py --headed

# 使用开源 webkit 浏览器
python run.py --browser=webkit --headed

# 使用开源 Firefox 浏览器
python run.py --browser=firefox --headed

# 使用 Goole Chrome 浏览器（基于 Chromium 引擎）
python run.py --browser=chromium --browser-channel=chrome --headed

# 使用 Edge 浏览器（基于 Chromium 引擎）
python run.py --browser=chromium --browser-channel=msedge --headed

playwright codegen --help

用法：playwright codegen [选项] [网址]

打开页面并为用户操作生成代码

选项：
-o, --output <文件名>             将生成的脚本保存到文件中
--target <语言>                  生成的目标语言，可选值为 javascript、playwright-test、python、python-async、python-pytest、csharp、csharp-mstest、csharp-nunit、java、java-junit（默认值："python"）
--test-id-attribute <属性名>     使用指定的属性生成数据测试 ID 选择器
-b, --browser <浏览器类型>        使用的浏览器类型，可选值为 cr、chromium、ff、firefox、wk、webkit（默认值："chromium"）
--block-service-workers         阻止服务工作线程
--channel <渠道>                 Chromium 分发渠道，例如 "chrome"、"chrome-beta"、"msedge-dev" 等
--color-scheme <方案>            模拟首选颜色方案，可选值为 "light" 或 "dark"
--device <设备名称>               模拟设备，例如 "iPhone 11"
--geolocation <坐标>             指定地理位置坐标，例如 "37.819722,-122.478611"
--ignore-https-errors           忽略 https 错误
--load-storage <文件名>          从文件加载上下文存储状态，该文件之前使用 --save-storage 保存--lang <语言>                    指定语言/区域设置，例如“en-GB”
--proxy-server <代理>            指定代理服务器，例如“http://myproxy：3128”或“socks5://myproxy：8080”
--proxy-bypass <绕过>            以逗号分隔的要绕过代理的域名，例如“.com，chromium.org,.domain.com”
--save-har <文件名>              在结束时保存包含所有网络活动的 HAR 文件
--save-har-glob <通配符模式>      根据此通配符模式与 URL 匹配来筛选 HAR 中的条目
--save-storage <文件名>          在结束时保存上下文存储状态，以便稍后使用 --load-storage
--timezone <时区>                要模拟的时区，例如“Europe/Rome”
--timeout <超时时间>             Playwright 操作的超时时间（以毫秒为单位），默认无超时
--user-agent <用户代理字符串>     指定用户代理字符串
--user-data-dir <目录>           使用指定的用户数据目录，而不是新上下文
--viewport-size <大小>           以像素为单位指定浏览器视口大小，例如“1280， 720”
-h， --help                     显示命令的帮助信息

示例：

$ codegen
$ codegen --target=python
$ codegen -b webkit https://example.com

playwright codegen https://baidu.com/