3. 元素定位

官方文档：

https://playwright.dev/python/docs/api/class-elementhandle/#element_handleis_visible

3.1 元素定位

元素定位是元素交互的前提条件，也是自动化测试最重要的步骤之一。元素” 存在 “页面”中 ，要定位元素，就是调用“页面”的方法:

l querySelector(engine=body) # 选择单个元素

l querySelectorAll(engine=body) # 选择多个元素

l waitForSelector(engine=body) # 选择单个元素，并且自动等待到元素可见、可操作

代码见下：

目前支持的定位引擎有：css、xpath、text：

Playwright支持提供简写语法，根据内容自动判断选择器：

1. 以 // 或 / 或者 .. 开头的，判断为xpath

pp = page.querySelector("xpath=//h2")

pp = page.querySelector("//h2")

2. 以引号 "" 或者 ' 开头的，判断为text

ppp = page.querySelector("text=文本输入") \

ppp = page.querySelector("'文本输入'")

注意：双引号里有一个单引号，不然无法识别

3. 其他的，都判断为css

p = page.querySelector("css=h2")

p = page.querySelector("h2")

3.2 元素高级定位

# :has 表示包含某个元素的元素

page.click("article:has(div.prome)")

# :is 用来对自身做断言

page.click("button:is(:text('sign in'), :text('log in'))")

# :text 表示包含某个文本的元素

page.click("button:text('Sign in')") # 包含

page.click("button:text-is('Sign is')") # 严格匹配

page.click("button:text-matches('\w+')") # 正则

# 还可以根据方位匹配

page.click("button:right-of(#search)") # 右边

page.click("button:left-of(#search)") # 左边

page.click("button:above(#search)") # 上边

page.click("button:below(#search)") # 下边

page.click("button:near(#search)") # 50px 之内的元素

# 通过 XPath 选择

page.click("//button[@id='search'])")

链式选择器

选择器可以与>>组合使用，例如selector1 >> selector2 >> selectors3。当选择器被链接时，下一个选择器会相对于前一个选择器的结果进行查询。

例如：

page.querySelector("div[role=\"document\"] >> text=\"确定\"")

备注：

1. 定位建议直接用录制的方式，把流程中的定位都录下来，录制命令为：

python -m playwright codegen --target python -o formgetcookie.py -b chromium f.wps.cn/form-list --load-storage formTest134

2. 因为录制大部分都是text定位方式，建议有id的修改id定位

3.3 元素操作

3.3.1 页面操作

page.goto("https://example.com") # 前往页面

page.go_back(**kwargs) #前进

page.go_forward(**kwargs) # 后退

page.screenshot(path="screenshot.png") 截图

print(page.title()) # 打印当前页标题

print(page.url()) # 打印当前页URL

3.3.2 等待元素

page.wait_for_selector("text=\"查看数据汇总表\"")

可以自定义超时时间，state有四种状态：“attached”, “detached”, “hidden”, “visible”：

attached：等待元素出现在DOM树中

detached：等待元素消失在DOM树中

hidden：等待元素从DOM中分离出来，或者有一个空的边界框或visibility:hidden

visible：有非空的边界框和非visibility:hidden

见下方代码示例：

# state="attached", "detached", "hidden", "visible"

page.waitForSelector('#browsers', state='visible', timeout=30000)

3.3.2 操作元素

元素点击

page.click(selector)

填充元素

page.fill(selector, value) # 在 input 中填充值

获取某元素内的所有文本

print(page.evalOnSelector('.headerLogo', """e => e.textContent"""))

print(page.querySelector('.headerLogo').textContent())

3.4 frame处理

处理frame，查找frame有三种方法：

1. frame的name属性

2. frame的URL

3. 通过其他的任何的selector

示例：wps的登录页，登录窗口是在iframe下

代码：

login_frame

= page.query_selector("#smsWrap>iframe").content_frame()

login_frame.fill("input[id=\"phone\"]", "15675632561")

login_frame.click("div[id=\"rectBottom\"]")

3.5 选项框

Checkbox 和 radio buttons直接可以用check和uncheck方法来进行勾选和去勾选，当然其实也可以直接用click方法来通过点击来进行勾选和去勾选

page.click("#currentaccount")

3.5 下拉框

Select options可以单选或者多选，但是只针对元素标签有效果

# 一、通过value值选择

page.selectOption("#cars", "saab")

# 二、通过标签选择

# page.selectOption("#cars", {"label": "Saab"})

# 三、还可以通过元素handle处理

# page.querySelector("#cars").selectOption("saab")

# 多选

# page.selectOption('select#colors', ['red', 'green', 'blue'])

代码示例：

# 选择分支
page.select_option("select[id=\"select\"]", "develop")

3.5 页面切换

问题：我在A页面点击target="_blank"的链接后，浏览器打开了B页面 ，我要怎么定位到B页面？

代码见下：

page.goto("...") # 主页面

with page.expect_popup() as popup_info:

page.click("...") # 此处点击A页面跳转链接

page1 = popup_info.value

page1.goto("...") # B页面的其他操作

3.6 常用断言

# element_handle.is_checked()
element_handle.is_disabled()
element_handle.is_editable()
element_handle.is_enabled()
element_handle.is_hidden()
element_handle.is_visible()
page.is_checked(selector)
page.is_disabled(selector)
page.is_editable(selector)
page.is_enabled(selector)
page.is_hidden(selector)
page.is_visible(selector)