playwright 进阶用法
目录
1、设置浏览器窗口最大化
# --start-maximized 把操作系统上的浏览器软件窗口,放大到全屏。
browser = p.chromium.launch(
headless=False,
channel="chrome",
args=["--start-maximized", # 窗口最大化 ]
)
# no_viewport=True 放弃强制给网页页面设置固定渲染大小(默认 1280×720)。
context = browser.new_context(no_viewport=True )
2、开启录屏功能
# 录屏文件保存在你指定的文件夹,格式为 `.webm` (playwright无法直接生成mp4格式)
context = browser.new_context(
no_viewport=True
record_video_dir="./videos/"
)
# webm 转 mp4
ffmpeg -i video.webm output.mp4
3、page.locator(“xxx”)介绍
page.locator("xxx")里面填的就是 CSS 选择器,.s‑btn、div#head都属于 CSS 选择器。
3.1 符号规则
.类名→ 点.代表class 属性#id值→ 井号#代表id 属性
3.2 类名选择器
定位方式:
page.locator(".s-btn")
对应html:
<button class="s-btn">提交</button>
<div class="s-btn"></div>
3.3 id选择器
page.locator("div#head")
含义:
- `div`:标签必须是 div
- `#head`:id="head"
对应html:
<div id="head">头部导航</div>
4、定位下拉选项
# html内容
<select id="detail_layout_top_select">
<option value="007014">嘉合磐泰短债A</option>
<option value="014846">博时恒乐债券A</option>
<option value="372010">摩根强化回报债券A</option>
<option value="012734">易方达中证人工智能主题ETF联接C</option>
<option value="000834">大成纳斯达克100ETF联接(QDII)A</option>
</select>
# 定位方式
eg: 要定位到 "嘉合磐泰短债A", 可以使用 page.locator(id定位).select_option(value值)
page.locator("#detail_layout_top_select").select_option("007014")
5、等待操作
# `wait_until="networkidle"`:**等待网络空闲**
含义:页面加载完成后,**500ms 内没有新的网络请求**,代码才往下执行
用法:
page.goto("https://www.baidu.com/", wait_until="networkidle")
# wait_for(state="visible") 智能等待元素
含义:等待该元素变为可见,才往下执行
用法:
page.get_by_placeholder (“请输入用户名”).wait_for (state=”visible”, timeout=10000)
6、keyboard.type 模拟键盘打字
page.get_by_placeholder ("请输入用户名").click ()
page.keyboard.type("hahaha", delay=80)
含义:模拟真人敲击键盘,一个字符一个字符敲进去
- `delay=80`:每输入一个字符,停顿 80 毫秒
- 会完整触发 `keydown → keypress → keyup → input` 全套前端事件
### 和 `.fill("hahaha")` 的核心区别
1. `page.locator.fill("hahaha")`
Playwright 直接赋值输入框 value,**极速一次性填入**,属于脚本注入;
很多前端页面监听 `keydown / keyup / input`事件,极速赋值不会触发校验、下拉联想、实时校验。
7、判断复选框是否勾选
locator.is_checked()
- 返回 `True`:已经勾选
- 返回 `False`:未勾选
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(headless=False)
page = browser.new_page()
page.goto("你的页面地址")
# 定位复选框(可以放到行内,例如 row.locator("input[type='checkbox']"))
checkbox = page.locator("input[type='checkbox']")
# 判断勾选状态
if not checkbox.is_checked():
checkbox.click()
print("复选框未勾选,执行点击勾选")
else:
print("复选框已经勾选,跳过操作")
browser.close()
8、子元素选择器
>是 CSS 直接子元素选择器:只匹配紧挨着的一级子节点,不匹配后代(孙子、曾孙)
A > B:B 必须是 A 的直接子元素- 没有
>:A B代表 A 里面所有后代(子、孙、重孙全部都匹配) - 同级元素不能用
>!>表达的是「父子上下级关系」,不是同级。同级用+、~
1.> 直接子选择器例子
<!-- 结构 -->
<div class="parent">
<svg> <!-- parent 的直接子元素 -->
<g>
<path></path>
<circle id="check"></circle> <!-- svg 的直接子元素 -->
</g>
</svg>
</div>
你的代码:`third_col.locator("svg > #check")`
含义:
> 在 `third_col` 内部,找一个 `<svg>`,然后**svg 的直接一级子元素** id=check。
如果 `#check` 不是 svg 直接子节点(中间包了一层`<g>`),`svg > #check` **匹配不到**!
这种情况就不能用 `>`,要写成 `svg #check`(空格,后代选择器,不管中间多少层)
# 不限制层级,svg里面任意深度找到 #check
third_col.locator("svg #check").click()
2. 区分:空格(后代) vs >(直接子)
| 选择器 | 匹配逻辑 | 是否允许中间嵌套标签 |
|---|---|---|
svg #check |
svg 里面任意后代id=check (svg内部任意层级,只要后代有 id=check,都匹配(子、孙都可以)) | ✅ 可以多层嵌套 |
svg > #check |
svg 的直接一级子元素id=check (svg 的直接子节点必须是 #check,中间不能再有标签包裹) | ❌ 中间不能有标签包裹 |
svg#check |
svg 这个元素本身id=check | 无(同一个元素) |
3. 同级元素用什么?(同级不能用 >)
>是父子,同级是兄弟关系,用下面两个:
A + B:紧邻的下一个兄弟(A 后面紧挨着的 B)
div + span /* 匹配紧跟在div后面,同一个父级的span */
A ~ B:A 后面所有兄弟 B(只要是同层级,在 A 后面就行,不需要紧挨着)
div ~ span
示例 HTML 同级:
<div>A</div>
<span>B</span>
<span>C</span>
div + span→ 匹配 Bdiv ~ span→ 匹配 B 和 C
4.补充小知识点
svg#check 中间没有空格!
svg#check:同一个元素,标签 svg,id=checksvg #check:空格,代表 svg 内部后代元素 id=check
9、表格列表 → 定位某一行(父容器) → 在这一行内部,点击第三列
假设表格每一行是 <tr>,每一列是 <td>。
逻辑:先锁定目标行 → 在该行里面找第 3 列(索引从 0 开始,第三列就是
nth(2))
写法 1:先定位行,链式取该行第三列(最推荐)
# 1. 找到目标行:举例,根据行内文本定位这一行(你可以改成class/xpath)
row = page.locator("tr", has_text="目标行的关键字")
# 2. 在【这一行内部】找td,取第三个td(第三列,nth从0开始计数)
third_col = row.locator("td").nth(2)
# 点击第三列
third_col.click()
写法 2:如果第三列里面还有按钮 / 图标(比如你之前悬浮才出现的编辑按钮)
# 锁定目标行
row = page.locator("tr", has_text="目标行的关键字")
# 在该行的第三列里面,找编辑按钮
edit_btn = row.locator("td").nth(2).locator(".edit-icon")
# 悬浮后点击(刚好匹配你上一个悬浮才显示编辑按钮场景)
row.hover()
edit_btn.click()
3.has_text 是神器(推荐用来定位行)
has_text 是 Playwright locator 参数,作用:筛选包含指定文本的那一行
# 找到包含文本"张三"的tr行
row = page.locator("tr", has_text="张三")
转载请注明来源,欢迎对文章中的引用来源进行考证,欢迎指出任何有错误或不够清晰的表达。
文章标题:playwright 进阶用法
本文作者:伟生
发布时间:2026-08-22, 21:13:00
最后更新:2026-10-18, 22:45:17
原始链接:http://yoursite.com/2026/08/22/ceshi_19_playwright_03/版权声明: "署名-非商用-相同方式共享 4.0" 转载请保留原文链接及作者。