TestCafe断言之智能断言查询机制（Smart Assertion Query Mechanism）

我不是女神ヾ 2021-09-24 12:18 301阅读 0赞

## Assert 断言 ##

可以使用断言检查被测试页面的状态是否满足预期。  
TestCafe提供了一组全面的基于行为驱动开发风格(bdd风格)的断言。  
本主题由以下部分组成:

*  断言结构
 *  智能断言查询机制
 *  选项

### 断言结构 ###

要构造断言，请使用测试控制器的 [**expect**][expect] 方法。

[**t.expect**][expect]方法后面跟着一个断言方法，该方法接受期望值和可选参数。  
下面的示例展示了完全相等断言的结构:

await t.expect( actual ).eql( expected, message, options );

下面的代码片段演示了如何在测试中使用断言:

import {  Selector } from 'testcafe';
    fixture `Example page`
       .page `http://devexpress.github.io/testcafe/example/`;
    test('Check property of element', async t => { 
       const developerNameInput = Selector('#developer-name');
       await t
           .expect(developerNameInput.value).eql('', 'input is empty')
           .typeText(developerNameInput, 'Peter Parker')
           .expect(developerNameInput.value).contains('Peter', 'input contains text "Peter"');
    });

可以使用以下断言方法:

*  [Deep Equal][expect]
 *  Not Deep Equal
 *  Ok
 *  Not Ok
 *  Contains
 *  Not Contains
 *  Type of
 *  Not Type of
 *  Greater than
 *  Greater than or Equal to
 *  Less than
 *  Less than or Equal to
 *  Within
 *  Not Within
 *  Match
 *  Not Match

### TestCafe智能断言查询机制 ###

在同步功能测试中，可以在测试操作之后立即执行断言。  
![在这里插入图片描述][20200706181621718.png]  
**Web上的功能测试是异步的**。这意味着我们不能在用户操作之后立即得到预期的效果。  
例如，在页面到达最终状态之后，被测试的页面可能需要一些时间向服务器发送请求以获取所需的数据，或者由用户执行操作来调用动画。所有这些间隔时间都不能预先计算，因为它们取决于各种因素：比如计算机性能、网络连接速度等。  
在这种情况下，如果我们在测试操作之后立即执行断言，就会得到一个不确定的结果，至少是不稳定的。  
![在这里插入图片描述][20200706181835815.png]  
在执行异步功能测试时，通常会添加额外的超时。  
![在这里插入图片描述][202007061818546.png]  
要使得异步功能测试更加稳定，就需要添加允许应用更改的超时时间。  
**注意：** 添加超时会增加测试的持续时间。

TestCafe使用智能断言查询机制：  
假如断言接收到选择器的DOM节点**状态属性或客户端函数承诺**作为`实际值`：  
1、如果断言没有通过，测试不会立即失败。在这之后，**断言多次重试传递，每次都请求获取`实际`的属性值。**  
2、如果在超时期间断言无法验证成功，则测试失败。  
![在这里插入图片描述][20200706182432220.png]

**例如：**  
下面的网页就是一个例子:

<div id="btn"></div>
    <script> var btn = document.getElementById('btn'); btn.addEventListener('click', function() { window.setTimeout(function() { btn.innerText = 'Loading...'; }, 100); }); </script>

此页面的测试代码如下：

test('Button click', async t => { 
        const btn = Selector('#btn');
    
        await t
            .click(btn)
            // 常规断言会立即失败，但TestCafe会重试运行DOM状态。
            // 在超时期间多次使用断言，直到该断言成功通过。
            // 默认超时时间为3000毫秒。
            .expect(btn.textContent).contains('Loading...');
    });

上述方法使测试者可以快速运行创建更加稳定的测试，并降低出错的风险。

可以在测试代码中使用`options.timeout`选项指定断言查询超时，要在启动测试时设置超时时间：  
1、如果使用API，则将超时值传递给`runner.run`方法;  
2、如果从命令行运行TestCafe，则指定`assertion-timeout`选项。

### Options ###

**1、options.timeout**  
Type: Number (毫秒为单位)

Default value: 超时是用`runner.run` API方法或`assertion-timeout`命令行选项指定的。

await t.expect(Selector('#elementId').innerText).eql('text', 'check element text', {  timeout: 500 });

**2、options.allowUnawaitedPromise**  
只有promise选择器和客户端函数返回的值可以作为断言的实际值传递。如果你传递了常规的未定承诺，则TestCafe会引发错误。

如果需要断言常规promise，请将`allowUnawaitedPromise`选项设置为`true`。

await t.expect(doSomethingAsync()).ok('check that a promise is returned', {  allowUnawaitedPromise: true });

**总结：**  
这其实和Selenium的 **显示等待(Explicit Wait)** 和 **流式等待(FlentWait)** 类似。  
在设定的超时期间内不断的去判断是否满足条件，满足就过，不满足就失败。  
参考下面文章：  
[【**5-Selenium WebDriver三种等待–隐式等待-显式等待和流畅等待**】][5-Selenium WebDriver_-]

[expect]: https://devexpress.github.io/testcafe/documentation/reference/test-api/testcontroller/expect/
[20200706181621718.png]: /images/20210923/e772e08589c64e96be14afdd4e8d7b81.png
[20200706181835815.png]: /images/20210923/50243633306d48fe9b756e519b5d0cea.png
[202007061818546.png]: /images/20210923/581abe3db37941a982c83604198fc079.png
[20200706182432220.png]: /images/20210923/71a9c273b85e4d5b9f4c9dfdd2cd399b.png
[5-Selenium WebDriver_-]: https://blog.csdn.net/zbj18314469395/article/details/97266051