一文读懂:testcafe框架和页面元素交互
一、互动要求
使用 TestCafe 与元素进行交互操作,元素需满足以下条件:☟
元素在 body 页面窗口或 iframe 窗口的元素内。如果某个元素在视口之外,则 TestCafe 通过滚动可以滚动到元素可见。
元素是可见的,具有以下属性:
属性 | 说明 |
---|---|
display | 没有设置为 none |
visibility | 设置为 visible(默认值) |
width | > = 1 像素 |
height | > = 1 像素 |
元素不重叠。
TestCafe 动作以某个动作 offsetX 或 offsetY 选项指定的元素的中心或点为目标。如果另一个元素遮挡了目标点,则在顶部元素上执行操作(例如,t.click 操作在其上方单击该元素)。
如果你想学习自动化测试,我这边给你推荐一套视频,这个视频可以说是B站播放全网第一的自动化测试教程,同时在线人数到达1000人,并且还有笔记可以领取及各路大神技术交流:798478386
【已更新】B站讲的最详细的Python接口自动化测试实战教程全集(实战最新版)_哔哩哔哩_bilibili【已更新】B站讲的最详细的Python接口自动化测试实战教程全集(实战最新版)共计200条视频,包括:1、接口自动化之为什么要做接口自动化、2、接口自动化之request全局观、3、接口自动化之接口实战等,UP主更多精彩视频,请关注UP账号。https://www.bilibili.com/video/BV17p4y1B77x/?spm_id_from=333.337.search-card.all.click
二、点击操作
关于对元素进行点击操作,使用 testcafe 提供了三个方法,分别为单击、双击、鼠标右击,接下来我们一起来了解一下鼠标操作的使用方法。
1、单击
方法:t.click
在指定元素位置,鼠标单击
参数:
参数 | 描述 |
---|---|
selector | 双击的页面元素 |
例子:
test('click test', async t => {
await t.click('#su');
});
2、双击
方法:t.doubleClick
在指定元素位置,鼠标双击元素
参数:
参数 | 描述 |
---|---|
selector | 双击的页面元素 |
例子:
test('doubleClic test', async t => {
await t.doubleClick('#su')
});
3、右击
方法:t.rightClick
在指定元素位置,鼠标右击
参数:
参数 | 描述 |
---|---|
selector | 双击的页面元素 |
例子:
test('rightClick test', async t => {
await t.rightClick('#cell-1-1')
});
三、输入操作
方法:t.typeText
输入表单元素的值
参数:
参数 | 描述 |
---|---|
selector | 接收输入内容的表单元素 |
text | 输入的文本 |
例子:
import { Selector } from 'testcafe';
fixture('Example').page('https://www.baidu.com');
test('Type Text test', async t => {
await t
.typeText('#kw', '123')
})
四、键盘按键
在测试的操作中,如果涉及到键盘按键的操作,那么 testcafe 中也提供了很方便的方法 pressKey。
方法:t.pressKey
按键类型:
按键类型 | 例子 |
---|---|
字母、数字键 | 'a','A','1' |
修饰键 | 'shift','alt' 、'ctrl', |
导航键和动作键 | 'backspace','tab','enter' |
按键组合 | 'shift+a', 'ctrl+v' |
顺序按键 | 使用空格分隔多个案例操作,例如,'ctrl+c ctrl+v' |
例子:
test('enter test', async t => {
// 按下 a 键
await t.pressKey('a')
// 按下 shift+a 键
await t.pressKey('shift+a')
// 先按下 ctrl+c复制,再按ctrl+v粘贴
await t.pressKey('ctrl+c ctrl+v')
});
五、文本选择
关于表单或者 textarea 这类可编辑的元素,在进行输入之前,如果要选中原有的文字内容,并进行删除操作,则需要先选择文本,然后再进行删除
方法:t.selectText
在各种类型的输入元素中选择文本
参数:
参数 | 类型 | 描述 |
---|---|---|
selector | 字串| 选择器 | 标识将要选择其文本的网页元素;必填参数 |
startPos | number | 选择的开始位置,从零开始的整数;非必填,默认为 0 |
endPos | number | 选择的结束位置;非必填,可见文本内容的长度。 |
例子:
import { Selector } from 'testcafe';
fixture('Example').page('https://www.baidu.com');
test('Type Text test', async t => {
// 输入 123
await t.typeText('#kw', '123')
// 选中输入的文本
.selectText('#kw')
// 按下删除键 删除输入的文本
.pressKey('delete');
})
六、鼠标悬停
方法:t.hover
将鼠标指针悬停在页面的某个元素上。
参数:
参数 | 描述 |
---|---|
selector | 页面元素 |
例子:
import { Selector } from 'testcafe';
fixture('Example').page('https://www.baidu.com');
test('Type Text test', async t => {
// 鼠标悬停在百度页面顶部的更多菜单上
await t.hover('a[name="tj_briicon"]')
});
七、强制等待
在我们执行测试时,对于某个操作后,如果需要强制等待一段时间则可以使用 t.wait 方法来进行强制等待。
方法:t.wait
代码执行到 wait 方法,进行强制等待
参数:
范围 | 类型 | 描述 |
---|---|---|
timeout | 数字 | 暂停持续时间(以毫秒为单位)。 |
例子:
import { Selector } from 'testcafe';
fixture `百度测试`
.page `https://www.baidu.com`;
test('Wait test', async t => {
await t
// 输入123
.typeText('#kw', '123')
// 强制等待3秒
.wait(3000)
// 点击搜索
.click('#su')
});
八、窗口管理
1、打开新窗口
方法:openWindow
打开一个新的浏览器窗口。返回匹配的窗口描述符
参数:
参数 | 描述 |
---|---|
url | 打开的 URL。可以是绝对的或相对的。 |
例子:
import { Selector } from 'testcafe';
fixture `百度测试`
.page `https://www.baidu.com`;
test('Wait test', async t => {
// 打开一个新窗口,接收新窗口的描述符
const winDesc = await t.openWindow('http://www.taobao.com')
});
2、关闭窗口
方法:closeWindow
关闭浏览器窗口。(注意点:不能使用该方法直接关闭主窗口)
参数:
参数 | 描述 |
---|---|
windowDescriptor | 描述目标窗口的对象。如果不传此参数,默认关闭当前活动窗口。 |
例子:
import { Selector } from 'testcafe';
fixture `百度测试`
.page `https://www.baidu.com`;
test('Wait test', async t => {
// 打开一个新窗口,接收新窗口的描述符
const winDesc1 = await t.openWindow('http://www.taobao.com')
// 关闭窗口
await t.closeWindow(winDesc1)
});
九、调整窗口大小
1、窗口最大化
方法:t.maximizeWindow
把浏览器窗口设置为最大化
例子:
import { Selector } from 'testcafe';
fixture `百度`
.page `https://www.baidu.com`;
// 窗口最大化
test('screenshot ', async t => {
await t.maximizeWindow();
});
2、调整窗口大小
方法:t.resizeWindow
参数:
参数名 | 描述 |
---|---|
width | 新的宽度(以像素为单位)。 |
height | 新高度,以像素为单位。 |
例子:
import { Selector } from 'testcafe';
const menu = Selector('#side-menu');
fixture `百度测试`
.page `https://www.baidu.com`;
test('设置浏览器窗口大小', async t => {
await t
.resizeWindow(200, 100)
});
3、调整窗口大小适配设备屏幕
方法:t.resizeWindowToFitDevice
通过传入移动设备的设备名,自动调整窗口大小,以适合指定移动设备的屏幕
参数:
参数 | 描述 |
---|---|
deviceName | 设备的名称。比如 iphonex, iphonexr |
例子:
import { Selector } from 'testcafe';
const menu = Selector('#side-menu');
fixture `百度测试`
.page `https://www.baidu.com`;
test('设置浏览器窗口大小', async t => {
await t
.resizeWindowToFitDevice('iphonex', {
portraitOrientation: true
})
});