当前位置：首页 > news >正文

Web 自动化神器 TestCafe(二)—元素定位篇

news 2026/4/27 17:18:19

今天主要给大家介绍一下testcafe这个框架元素定位的方法。

一、CSS 选择器定位

使用 testcafe 对元素进行操作的时候，我们可以直接通过 CSS 选择器指定要操作的元素，比如，点击元素，input 输入文本内容，如下：

点击 id 为 su 的元素

  前段时间写了一篇关于web自动化测试框架TestCafe的安装和入门文档，有部分小伙伴表示对这个框架比较感兴趣，后续有时间会陆续写几篇关于TestCasfe使用的文章。今天主要给大家介绍一下testcafe这个框架元素定位的方法。

点类类属性为 btn 的元素

  await t.click('.btn');

上面这种基于 CSS 的元素定位方式用起来虽然很便捷，但是对于更复杂的元素定位，CSS 选择器会变得更长且难以编写和维护，另外 CSS 选择器无法定位父元素，在实际的应用种 CSS 选择器还是会有诸多不便。这边就不做过多的讲解了。

二、Selector 选择元素

由于 CSS 选择器定位元素不是特别方便，因此 testCafe 中提供了一个叫做 Selector 元素定位器函数，接下来就给大家介绍一下 Selector 的使用。

1、选择器基本使用

在使用 Selector 之前我们需要将它导入，然后使用 Selector 的构造函数创建出来一个选择器对象，对于一些简单的元素定位可以直接将 CSS 选择表达式在创建对象时当如参数传入，js 代码如下：

  import { Selector } from 'testcafe';
// 定位id为su的元素
const su = Selector('#su');
// 定位class属性为kw的元素
const kw = Selector('.kw');

2、通过文本定位

  上面传入css定位表达式这种方式不支持文本定位，对于文本定位元素，Selector对象提供了对应的方法：既可以通过文本内容匹配，也可以通过文本包含匹配。

1、文本内容匹配：withExactText import { Selector } from 'testcafe'; // 定位文本为百度的元素 const baidu = Selector().withExactText('百度')
2、文本包含匹配：withText import { Selector } from 'testcafe'; // 定位文本包含百度的span标签 const baidu = Selector('span').withText('百度')

3、通过属性定位

  关于通过元素属性匹配，Selector定位器，同样也提供了对应的方法(withAttribute)，下面我们来演示withAttribute的使用案例。

参数	说明
attrName	属性名（可传字符串\|正则表达式）
attrValue（非必填）	属性值（可传字符串\|正则表达式）

  // 定位包含myAttr属性的div元素
Selector('div').withAttribute('myAttr');// 定位herf属性为http://www.baidu,com的a标签
Selector('a').withAttribute('herf', 'http://www.baidu,com');

4、节点关系定位

1、nextSibling：下一个元素同级元素 // 定位a标签的下一个兄弟元素 Selector('a').nextSibling();
2、prevSibling：上一个元素同级元素 // 定位p标签的上一个兄弟元素 Selector('p').prevSibling()
3、parent：获取父级元素 // 定位id为u的标签的父元素 Selector('#u').parent()
4、sibling：所有的兄弟元素 // 定位li标签所有的兄弟元素 Selector('li').sibling()
5、child：获取所有的子元素。 // 定位ul标签所有的子标签 Selector('ul').child()

5、过滤方法

  当我们通过选择器获取到某个元素或者元素集合的时候，需要过滤出我们想要的元素进行操作时，那么我们就可以通过Selector提供的相关方法来进行过滤操作定位。

1、nth：通过下标选择 // 选择第一个div元素 Selector('div').nth(0)
2、find: 查找匹配节点的后代节点查找匹配集中所有节点的后代节点，并使用 CSS 选择器对其进行过滤。 Selector().find(cssSelector) // cssSelector:用于过滤子元素的CSS选择器字符串。
2、filter:过滤符合条件的元素。 Selector().filter(cssSelector) // cssSelector:用于过滤元素的CSS选择器字符串。
3、filterHidden：仅选择隐藏的元素具有 display: none 或 visibility: hidden CSS 属性或宽度或高度为零的元素被视为隐藏。 // 定位隐藏的div元素 Selector('div').filterHidden()
4、filterVisibl：仅定位显示的元素不具有 CSS 属性 display: none 或元素的 visibility: hidden 宽度和高度不为零的元素被视为可见。 // 定位处于显示状态class为box的元素 Selector('.box').filterVisible();

6、设置等待时间

  在定位元素的时候，我们如果需要等到定位的元素出现，在使用Selector时，可以设置一个等待超时的时间，直到等待的元素超时为止，使用如下:

  Selector('#elementId', { timeout: 500 })

三、Seletor 选择器的操作

上面我们讲了创建一个 seletor 对象选择元素，接下来咱们一起来看看 seletor 对象的操作。

1、常用的属性

exists：判断元素是否存在 // 判断元素是否存在，返回值布尔值 const res = Selector('#submit-button').exists;
count：获取匹配到的元素数量 // 获取匹配到的数量 const num = Selector('.column.col-2 label').count;
textContent ：获取元素中包含的文本(包含子元素的文本) const text = Selector('.column.col-2 label').textContent;
visible :元素是否可见 const num = Selector('.column.col-2 label').count;
tagName :元素名称 const num = Selector('.column.col-2 label').tagName;

2、更多的属性

除了上述常用属性，Selector 的其他属性参考如下：

属性	描述
attributes	元素的属性为 { name: value, ... }。您也可以使用该 getAttribute 方法访问属性值。
boundingClientRect	元素的大小及其相对于视口的位置。包含 left，right，bottom，top，width 和 height 属性。
checked	对于复选框和单选输入元素，其当前状态。对于其他元素，undefined。
classNames	元素类的列表。
clientHeight	元素的内部高度，包括填充，但不包括水平滚动条的高度，边框或边距。
clientLeft	元素左边框的宽度。
clientTop	元素顶部边框的宽度。
clientWidth	元素的内部宽度，包括填充，但不包括垂直滚动条的宽度，边框或边距。
focused	true 如果该元素已聚焦。
id	元素的标识符。
innerText	元素的文本内容“呈现”。
namespaceURI	元素的名称空间 URI。如果元素没有命名空间，则此属性设置为 null
offsetHeight	元素的高度，包括垂直填充和边框。
offsetLeft	元素左上角在 offsetParent 节点内向左偏移的像素数。
offsetTop	元素左上角在 offsetParent 节点内偏移到顶部的像素数。
offsetWidth	元素的宽度，包括垂直填充和边框。
selected	表示 `` 当前已选择元素。对于其他元素，undefined
scrollHeight	元素内容的高度，包括由于溢出而在屏幕上不可见的内容。
scrollLeft	元素内容向左滚动的像素数。
scrollTop	元素内容向上滚动的像素数。
scrollWidth	元素内容的像素宽度或元素本身的宽度，以较大者为准。
tagName	元素的名称。

看到这里的朋友不妨点个赞，码字不易，谢谢大家。