本文旨在解决 Jasmine 测试框架中，异步 mock 函数在同一测试函数内被多次调用时，测试中断或结果不符合预期的问题。通过分析问题现象、代码示例，以及最终解决方案，帮助开发者理解异步测试中的关键点，并提供完整的可运行代码示例，确保测试的准确性和可靠性。
在 Jasmine 中进行异步测试时，如果 mock 的函数内部使用了 async/await，并且在测试用例中多次调用该 mock 函数，可能会遇到测试中断或断言失败的问题。这通常是由于在应用程序代码中缺少必要的 async/await 关键字，导致测试用例无法正确等待异步操作完成。
问题分析
当测试用例中多次调用同一个异步 mock 函数时，Jasmine 可能会在第二次调用后停止执行后续的断言。这可能是因为 JavaScript 的异步特性导致后续代码在 promise 完成之前就执行了，从而导致断言在不正确的状态下进行。
例如，以下代码在实际应用中可能运行正常，但在测试中可能会出现问题：
function main_obj() { this.objmethod1 = function () { const async_objmethod = async function(){ let deleteProject = await getDialogAnswer(); deleteProject = await getDialogAnswer(); this.objmethod2(); this.objmethod3(); this.objmethod4(); unsaved_changes = true; method5(this.name); } async_objmethod.bind(this)(); }; this.objmethod2 = function () {}; this.objmethod3 = function () {}; this.objmethod4 = function () {}; }
上述代码中，objmethod1 函数调用了两次 getDialogAnswer，并在之后执行其他方法。在测试中，如果 getDialogAnswer 是一个异步 mock 函数，并且 objmethod1 没有使用 async/await 来等待 async_objmethod 完成，那么后续的断言可能会在 getDialogAnswer 完成之前执行，导致测试失败。
解决方案
解决此问题的关键是在应用程序代码中添加 async/await 关键字，确保在测试用例中能够正确等待异步操作完成。
修改后的代码如下：
function main_obj() { this.objmethod1 = async function () { const async_objmethod = async function(){ let deleteProject = await getDialogAnswer(); deleteProject = await getDialogAnswer(); this.objmethod2(); this.objmethod3(); this.objmethod4(); unsaved_changes = true; method5(this.name); } await async_objmethod.bind(this)(); }; this.objmethod2 = function () {}; this.objmethod3 = function () {}; this.objmethod4 = function () {}; }
通过在 objmethod1 函数定义前添加 async 关键字，并使用 await 等待 async_objmethod 完成，可以确保测试用例在所有异步操作完成后再进行断言。
完整代码示例
以下是一个完整的可运行代码示例，包括 html、JavaScript 和测试代码：
specrunner.html
<html> <head> <meta charset="utf-8"> <title>Jasmine Spec Runner</title> <link rel="shortcut icon" type="image/png" href="jasmine_lib/jasmine-5.0.0-beta.0/jasmine_favicon.png"> <link rel="stylesheet" href="jasmine_lib/jasmine-5.0.0-beta.0/jasmine.css"> <script src="jasmine_lib/jasmine-5.0.0-beta.0/jasmine.JS"></script> <script src="jasmine_lib/jasmine-5.0.0-beta.0/jasmine-html.js"></script> <script src="jasmine_lib/jasmine-5.0.0-beta.0/boot0.js"></script> <script src="jasmine_lib/jasmine-5.0.0-beta.0/boot1.js"></script> <script src="maincode.js" > </script> <script src="test_spec.js"></script> </head> <body></body> </html>
maincode.js
function main_obj() { this.objmethod1 = async function () { const async_objmethod = async function(){ let deleteProject = await getDialogAnswer(); deleteProject = await getDialogAnswer(); this.objmethod2(); this.objmethod3(); this.objmethod4(); unsaved_changes = true; method5(this.name); } await async_objmethod.bind(this)(); }; this.objmethod2 = function () {}; this.objmethod3 = function () {}; this.objmethod4 = function () {}; }
test_spec.js
const getDialogAnswer = jasmine.createSpy('Mock_getDialogAnswer').and.returnValue( Promise.resolve('yes'), Promise.resolve('yes'), ); const method5 = jasmine.createSpy('Mock_method5') let unsaved_changes; // var for main_inst instance set in 'before-funcs' let main_inst beforeEach(function() { main_inst = new main_obj(); unsaved_changes = null spyOn(main_inst, 'objmethod2') spyOn(main_inst, 'objmethod3') spyOn(main_inst, 'objmethod4') }); describe("Test makemain_inst.js", () => { describe("Test new jquery ui dialog functions", () => { describe("test dialog uses", () => { describe("test this.objmethod1()", () => { describe("test yes no", () => { it("should delete on yes + yes", async () => { // ------------ setup ------------- // -------- Call ---------------- const x = await main_inst.objmethod1() // ------------- verify ------------ expect(getDialogAnswer).toHaveBeenCalledTimes(2) expect(main_inst.objmethod2).toHaveBeenCalledTimes(1) expect(main_inst.objmethod3).toHaveBeenCalledTimes(1) expect(main_inst.objmethod4).toHaveBeenCalledTimes(1) expect(method5).toHaveBeenCalledTimes(1) expect(unsaved_changes).toBe(true); }); }); }); }); }); });
注意事项
- 确保 mock 函数返回 Promise 对象，以便 await 关键字可以正确等待异步操作完成。
- 在测试用例中使用 async/await 关键字，确保测试代码能够正确等待异步操作完成。
- 仔细检查应用程序代码，确保所有异步操作都使用了 async/await 关键字。
总结
在 Jasmine 中进行异步测试时，正确使用 async/await 关键字至关重要。通过确保应用程序代码和测试代码都能够正确等待异步操作完成，可以避免测试中断或断言失败的问题，从而提高测试的准确性和可靠性。 此外，在编写测试用例时，要仔细分析代码逻辑，确保测试用例能够覆盖所有可能的场景，并使用合适的断言来验证代码的正确性。
