Mocha-swagger 是一个基于 mocha 和 swagger 的测试框架，它可以帮助我们在编写 API 自动化测试时，快速生成测试用例和测试报告。
本教程将从安装及配置开始，介绍 mocha-swagger 的各种用法和常见问题。
安装
首先需要确认已经安装了 node.js 和 npm。然后可以通过以下命令安装 mocha-swagger：
npm install mocha-swagger --save-dev
配置
在项目根目录下创建一个 mocha-swagger.json 配置文件，用来配置 swagger 的接口文档地址、测试数据、测试的描述等。
-- -------------------- ---- -------
-
------------- -------------------------------------
----------- -
------- -
------- -----
------ --
-
--
-------------- ---- ------
-在 package.json 中添加测试脚本：
{
"scripts": {
"test": "mocha-swagger"
}
}使用
编写一个简单的测试用例：
-- -------------------- ---- -------
---------------- ---------- -
---------- ---------- -
--- -------- - --------------
-- -------- ---
------------------------------------------
-- -------------
-----------------------------------------------------------
---
---接着在终端执行测试：
npm test
当测试执行结束后，可以在终端看到测试结果，包括测试用例通过的数量、失败的数量和错误信息。同时，还可以在 mocha-swagger 生成的 report.html 文件中查看测试报告。
常见问题
如何调试测试用例？
可以通过在测试用例前添加 console.log(this) 代码，打印出当前测试用例的上下文，以及包括 this.response 和 this.testData 等数据。这些数据可以方便地帮助我们调试测试用例。
如何在测试用例外部获取 response 和 testData？
可以在测试用例外部定义全局变量，保存 response 和 testData。
-- -------------------- ---- -------
--- --------- ---------
---------------- ---------- -
--------------------- -
-- -- --- -------
---------------------- -
----- ------------------
-- ------------- ---- ----- -
-------- - ----
----------
---
---
---------- ---------- -
-- -------- ---
------------------------------------------
-- -------------
------------------------------------------------------
---
---如何为测试用例添加 hooks？
测试用例可以通过 before/after/ beforeEach/ afterEach 等 hooks 来实现测试前/后的配置、数据准备、数据清理等操作。
-- -------------------- ---- -------
---------------- ---------- -
--- --------- -------- - -
----- -
----- -----
---- --
-
--
--------------------- -
-- -- --- -------
----------------------- -
----- -
--------- -------
--------- ------
-
-- ------------- ---- ----- -
-- ------ ------
------ - --------------------------
----------
---
---
------------------------- -
-- -- --- -------
---------------------- -
----- --------------
-------- -
------- ------
-
-- ------------- ---- ----- -
-- ---------
-------- - ----
----------
---
---
------------------------ -
-- ------
-------------------------------------------- -
-------- -
------- ------
-
-- ------------- ---- ----- -
----------
---
---
---------- ---------- -
-- -------- ---
------------------------------------------
-- -------------
------------------------------------------------------
---
---总结
Mocha-swagger 是一个非常方便的 API 自动化测试工具，可以减少测试用例的编写时间和测试人员的工作量。使用 mocha-swagger 可以轻松地创建测试用例，快速生成测试报告，并可以定位和解决测试用例出现的问题。但是，在使用过程中，也需要注意一些问题，尤其是在数据准备和清理方面，需要掌握一些技巧。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600668f8d9381d61a3540f50