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 符号规则

  1. .类名 → 点 . 代表class 属性
  2. #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. 同级元素用什么?(同级不能用 >)

> 是父子,同级是兄弟关系,用下面两个:

  1. A + B:紧邻的下一个兄弟(A 后面紧挨着的 B)
div + span  /* 匹配紧跟在div后面,同一个父级的span */
  1. A ~ B:A 后面所有兄弟 B(只要是同层级,在 A 后面就行,不需要紧挨着)
div ~ span

示例 HTML 同级:

<div>A</div>
<span>B</span>
<span>C</span>
  • div + span → 匹配 B
  • div ~ span → 匹配 B 和 C

4.补充小知识点

svg#check 中间没有空格!

  • svg#check:同一个元素,标签 svg,id=check
  • svg #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" 转载请保留原文链接及作者。

目录
×

喜欢就点赞,疼爱就打赏