微软出品自动化神器【Playwright+Java】系列(十)元素定位详解

一、写在前面

又有很久没更文了,真的是被催婚搞的整个人情绪特别不好,如果硬要形容的话,那就是没法跟人正常沟通,一点就着,做什么都没耐心,看什么都烦,简直没救了...

也是偶然发现的,自己居然没写关于Playwright的元素定位,这不是自动化测试的重中之重,怎么可以忘,马上安排!

二、元素定位

主要支持定位方式有:css、xpath、text

示例代码如下:

//选择单个元素 page.querySelector("selector"); //选择多个元素 page.querySelectorAll("selector"); //选择单个元素,并且自动等待到元素可见、可操作 page.waitForSelector("selector"); 

三、CSS定位

1、css+定位值

可以理解为指定为:css方式定位+使用的定位方式(css选择器语法)

示例代码如下:

page.locator("css=[type='text']") 

2、通过其文本内容匹配元素

元素标签+:has-text()

:has-text()匹配任何包含指定文本的元素,在内部的某个地方,可能在子元素或后代元素中。匹配不区分大小写,理解为模糊匹配,应注意与其他CSS说明符一起使用,否则将匹配所有包含指定文本的元素,包括<body>

示例代码如下:

List<ElementHandle> elements = page.querySelectorAll("button:has-text("Button")"); System.out.println(elements.size());// 5 ```html #### 3、在指定元素中查找匹配文本的元素 `:text()`匹配包含指定文本的最小元素。匹配不区分大小写,还是模糊匹配,就是指定范围了。  **示例代码如下:** ```java page.querySelector("article .ant-row :text("Open Modal")").click(); 

4、文本通过正则表达式匹配

匹配文本内容与类似JavaScript的正则表达式匹配的最小元素。

示例代码如下:

page.querySelector("article .ant-row :text-matches("Open Mo*dal", "i")") 

5、仅匹配可见元素

示例dom:

<button style='display: none'>Invisible</button> <button>Visible</button> 

示例代码如下:

page.locator("button:visible").click(); 

注意:
文本匹配会规范化空格。例如,它将多个空格变成一个,将换行符变成空格,并忽略前后空格。

6、在给定范围内元素,匹配元素

给定元素的范围的参数传递的任何选择器至少匹配一个元素,它将返回一个元素,也是模糊匹配!
示例代码如下:

page.navigate("http://localhost:8080/wait.html"); page.querySelector("#wait").click(); String content = page.waitForSelector("div:has(p)").textContent(); System.out.println(content); 

7、匹配条件之一的元素

以逗号分隔,从CSS选择器列表将匹配该列表中的选择器之一可以选择的所有元素,简单说就是从这么多列表中找到一个匹配的选择器去选择元素。
示例代码如下:

page.navigate("https://antdv.com/components/modal-cn"); page.waitForSelector("#components-modal-demo-basic .code-box-demo span").click(); page.locator("button:has-text("取 消"), button:has-text("确定")").click(); 

8、基于布局匹配定位元素

基于页面布局定位,上下左右之类的,会有当页面布局改变时,会出现找不到元素或者匹配其他元素的情况。

示例代码如下:

//在promo-card附近的元素 page.locator("button:near(.promo-card)").click(); //获取(promo-card2)元素右侧元素文本 String textContent3 = page.waitForSelector("button:right-of(#card2)").textContent(); System.out.println("textContent3: "+textContent3); //获取(promo-card2)元素左侧元素文本 String textContent1 = page.waitForSelector("button:left-of(#card2)").textContent(); System.out.println("textContent1: "+textContent1); //获取(promo-card2)元素上面元素属性 String above = page.waitForSelector("button:above(#card2)").getAttribute("id"); System.out.println("above: "+above); //获取(promo-card2)元素下面元素属性 String below = page.waitForSelector("button:below(#card2)").getAttribute("id"); System.out.println("below: "+below); 

9、从查询结果中选择第n个元素匹配

与: nth-child()不同,元素不必是兄弟姐妹,它们可以在页面上的任何位置元素。

示例代码如下:

page.waitForSelector(":nth-match(:text('promo-card'), 2)").click(); 

10、第N个元素定位器

选择索引的的方式定位。

示例代码如下:

//获取第一个元素的文本 String first = page.locator("button").locator("nth=0").textContent(); //获取最后一个元素的文本 String last = page.locator("button").locator("nth=-1").textContent(); System.out.println(first+"n"+last); 

11、仅定位可见元素

一个页面有两个按钮,第一个不可见,第二个可见,示例:

<button style='display: none'>Invisible</button> <button>Visible</button> 

示例代码如下:

page.locator("button").locator("visible=true").click(); 

三、XPath定位

任何以//或…开头的选择器被假定为xpath选择器。例如,Playwright将'//html/body'转换为'xpath=//html/body'。

1、XPath混合使用

特性就是管道符|的使用,在XPath中可指定多个选择器。它将匹配该列表中的选择器之一可以选择的所有元素。

示例代码如下:

page.navigate("https://antdv.com/components/modal-cn"); page.querySelector("#components-modal-demo-basic .code-box-demo span").click(); page.locator("//div[@id='vcDialogTitle0']|//div[@role='documentcontent']").waitFor(); System.out.println(); 

2、常见XPath定位使用

完全支持XPath定位和CSS语法,这里没法可说的,个人感觉是完美兼容SeleniumCSS 、XPath定位定位方式的,参考学习CSS定位入门XPATH定位入门这两篇。

四、使用文本定位

使用文本定位:以引号 "" 或者 ' 开头的,可以判定为文本定为文本定位。

1、包含

示例代码如下:

//包含 String content = page.textContent("button:text('card0')"); 

2、严格匹配

示例代码如下:

//严格匹配 String content1 = page.textContent("button:text-is('card0')"); 

3、正则表达式匹配

示例代码如下:

//正则 String content2 = page.textContent("button:text-matches("car*d0")"); 

五、使用属性选择器定位

不是CSS选择器,因此不支持任何特定于CSS的选项。

示例代码如下:

page.fill("id=user","username1"); page.type("data-testid=testid","username2"); 

六、使用链式选择器定位

选择器被链接时,下一个选择器相对于前一个选择器的结果被查询,个人感觉就是按照层级去定位元素。

示例代码如下:

page.navigate("https://2x.antdv.com/components/modal-cn"); page.click("#components-modal-demo-basic .code-box-demo span"); page.click("div[role="dialog"] >> div[role="document"] >> text="取 消""); System.out.println(); 

七、写在最后

Playwright系列的第九篇文中说,一个不留神就更新API了,请大家原谅我哈!

不但英文不好,而且眼神也不好,尴尬,这是第一次,也是最后一次!

我会在后面的文章中陆续把落下的补上,随着这几天的熟悉使用,有时帮我觉得它比selenium更出色,不知道是不是我的幻觉?

发表评论

相关文章