Playwright python版本安装及初步使用教程（记录）（更新中）

Playwright初步安装使用教程（记录）（更新中）

一、简介

Playwright 是专门为满足端到端测试的需求而创建的。Playwright 支持所有现代渲染引擎，包括 Chromium、WebKit 和 Firefox。在 Windows、Linux 和 macOS 上、本地或 CI 上、无头或使用本机移动仿真进行 headed 测试。

与selenium对比：

二、安装

python/conda环境安装命令：

pip:
pip install pytest-playwright

conda:
conda install pytest-playwright

检查是否安装成功：

pip:
pip show pytest-playwright

conda:
conda list | findstr "playwright"

三、实例测试代码（官网）

下段代码从官网截取，约定测试用例文件开头与ptest相同，必须为test开头命令

import re
from playwright.sync_api import Page, expect

def test_has_title(page: Page):
    page.goto("https://playwright.dev/")

    # Expect a title "to contain" a substring.
    expect(page).to_have_title(re.compile("Playwright"))

def test_get_started_link(page: Page):
    page.goto("https://playwright.dev/")

    # Click the get started link.
    page.get_by_role("link", name="Get started").click()

    # Expects page to have a heading with the name of Installation.
    expect(page.get_by_role("heading", name="Installation")).to_be_visible()

运行命令：

pytest -s (文件名)

默认模式下运行用例只会返回运行结果，不会打开浏览器，如果需要打开多个浏览器并且能够显示查看则用以下命令，此命令一次打开谷歌和火狐浏览器执行用例，–headed代表可以显示查看浏览器执行过程：

pytest --browser chromium --browser firefox --headed

四、基本的action列表

action	descrip
locator.check()	选中input复选框
locator.click()	单击元素
locator.uncheck()	取消选中Input复选框
locator.hover()	鼠标悬停在元素上
locator.fill()	填写表单字段，输入文本
locator.focus()	聚焦元素
locator.press()	单次按键
locator.set_input_files()	选择要上传的文件
locator.select_option()	在下拉列表中选择选项

五、常用断言列表

Assertion	Description
expect(locator).to_be_checked()	复选框已选中
expect(locator).to_be_enabled()	启用控制
expect(locator).to_be_visible()	元素可见
expect(locator).to_contain_text()	元素包含文本
expect(locator).to_have_attribute()	元素具有属性
expect(locator).to_have_count()	元素列表已给出长度
expect(locator).to_have_text()	元素匹配文本
expect(locator).to_have_value()	Input 元素具有值
expect(page).to_have_title()	页面有标题
expect(page).to_have_url()	页面有 URL

六、生成测试（Codegen）

运行codegen可以对网页进行action自动生成，expect自动生成，对网页进行操作后复制对应代码微调即可。

执行命令：

playwright codegen

操作项：

• 'assert visibility'断言元素可见
• 'assert text'断言元素包含特定文本
• 'assert value'断言元素具有特定值

页面实例：

七、运行测试用例文件

运行方式与pytest相同，下载的插件集成了pytest。

运行单个文件：

pytest test_testexample.py

运行多个文件

pytest test_testexample1.py test_testexample2.py

运行特定测试用例，用***-k***去匹配用例名称：

pytest -k test_example_item

并行运行测试(用例过多时用分布式运行减少运行时间)，建议使用一半的逻辑CPU内核：

pytest --numprocesses 2

八、调试测试

Playwright 附带 Playwright Inspector，它允许逐步执行 Playwright API 调用，查看其调试日志并浏览action。

PowerShell版本：
$env:PWDEBUG=1
pytest -s

对于此命令同样可以使用pytest -s ，-k等命令

------------------------------------------------------------------------------------------------------分界线后续继续更新