如何编写包含SAPUI5 Core API的函数的单元测试？

Question

我是UI5的qUnit新手。

我想测试一个函数formatter.js

formatDate: function(sTimeStamp) {
  if (sTimeStamp) {
    var iTimeStamp = Number(sTimeStamp.match(/\d/g).join("")), 
        oDateTimeFormat = DateFormat.getDateTimeInstance(); 
    return oDateTimeFormat.format(new Date(iTimeStamp));
  }
  return sTimeStamp;
},

单元测试：

function formatDateTestCase(assert, sValue, fExpectedNumber) {
  var fDate = formatter.formatDate(sValue);
  assert.strictEqual(fDate, fExpectedNumber, "Format Date was correct");
}

QUnit.test("Should return valid date", function (assert) {
  formatDateTestCase.call(this, assert, "/Date(1510026665790)/", "Nov 7, 2017, 11:51:05 AM");
});

显然，当我更改语言设置时，此测试用例将失败。 怎么改进呢？

---

我认为这里的主要问题是formatDate是一个带副作用的函数。 我应该自己改进这个功能吗？ 通过在formatDate添加语言环境？

或者我应该在我的测试用例中使用DateFormat ？ 这将使我的测试毫无意义。

Answer 1

我认为你应该在这里模拟对DateFormat的调用，以便能够独立测试你的代码。

单元测试注意事项

严格来说，单元测试的目的是测试你的 - 而且只测试你的 - 单元。 您不应该测试任何依赖API。 总的来说，人们可以争论这一点，但我绝对不建议测试SAPUI5 API。

另一方面，我强烈建议使用无效参数（例如undefined ）和无效字符串测试if语句和Regex部分。 这将确保您的格式化程序始终工作并返回某事。 如果是空字符串则有意义。

Sinon.JS：Mocks，Stubs和Spys

您应该在特定测试中存储DateFormat.getDateTimeInstance() ，以便该方法返回可预测的值（例如，在DateFormat中考虑I18N，它将为您提供不同语言的不同测试结果）。

为此，SAPUI5已经附带Sinon.JS （请注意包含的版本：SAPUI5 1.44 - > Sinon.JS 1.14）。 这是一个基本的例子：

sap.ui.define([
  "my/module/formatter",
  "sap/ui/core/format/DateFormat",
  "sap/ui/thirdparty/sinon",
  "sap/ui/thirdparty/sinon-qunit"
], function (formatter, DateFormat) {

  QUnit.test("Should return valid date", function (assert) {
    // stub the method
    sinon.stub(DateFormat, "getDateTimeInstance");
    // ensure a predictable outcome
    DateFormat.getDateTimeInstance.returns({
      format: function(oDate) {
        return oDate.getTime();
      }
    });

    var fDate = formatter.formatDate("/Date(1510026665790)/");
    assert.strictEqual(fDate, "1510026665790", "Format Date was correct");
    // Optional: test if the stubbed function was called
    assert.ok(DateFormat.getDateTimeInstance.calledOnce);

    // don't forget to restore the stub so that it does not interfere with other tests
    DateFormat.getDateTimeInstance.restore();
  });

});

通过存根DateFormat.getDateTimeInstance您可以停止测试核心API及其结果，您可以专注于最重要的事情：您的代码。

BR克里斯