一、互动要求
使用 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
})
});
