如何将自定义匹配器从Jasmine 1迁移到Jasmine 2

Question

不幸的是，JavaScript测试框架jasmine的第2版引入了一些突破性的更改。其中一个更改是处理自定义匹配器的方式，如下所述：

http://jasmine.github.io/2.0/upgrading.html

addMatchers函数不再在规范中（此处），它现在位于全局jasmine对象上。

 /* was:
     this.addMatchers({
  */
  jasmine.addMatchers({

matcher的设置现在有点不同了。工厂接收一个util对象，该对象包含jasmines相等函数和任何注册的CustomEqualityTester。工厂应返回一个带有比较函数的对象，该函数将使用实际值和预期值直接调用，而不是使用此函数上的实际值

   /* was:
       toBeCustom: function(expected) {
         var passed = this.actual == expected;
    */
    toBeCustom: function(util, customEqualityTesters) {
      return {
        compare: function(actual, expected) {
          var passed = actual == expected

比较现在应该返回一个具有pass和message属性的对象。

我正在寻找一种简单的方法来迁移我们现有的匹配器，以便我们可以轻松地切换到新的茉莉版本。

Answer 1

加载匹配器库允许您编写与Jasmine v1、Jasmine v2和Jest兼容的匹配器。

Answer 2

为了简化到新jasmine版本的转换，下面的特殊迁移对象将有所帮助。

不是在this对象上添加匹配器，而是在jasmineMigrate对象上添加它们。但这是你真正需要做的。jasmineMigrate对象将处理其余部分。

 /* was:
     this.addMatchers({
  */
  jasmineMigrate .addMatchers({

迁移对象的实现：

var jasmineMigrate = {};

jasmineMigrate.addMatchers = function (matchers) {

    Object.keys(matchers).forEach(function (matcherName) {
        var matcher = matchers[matcherName], 
            migratedMatcher = {};

        migratedMatcher[matcherName] = function (util, customEqualityTesters) {
            return {
                compare: function (actual) {
                    var matcherArguments,
                        thisForMigratedMatcher,
                        matcherResult,
                        passed;

                    //In Jasmine 2 the first parameter of the compare function 
                    //is the actual value.
                    //Whereas with Jasmine 1 the actual value was a property of the matchers this
                    //Therefore modify the given arguments array and remove actual
                    matcherArguments = [].slice.call(arguments)
                    matcherArguments.splice(0, 1);

                    //Add actual to the this object we'll be passing to the matcher
                    thisForMigratedMatcher = {
                        actual: actual
                    };

                    //Now call the original matcher aufgerufen, with the modified
                    //arguments and thisForMigratedMatcher which will be applied to
                    //the matcher
                    passed = matcher.apply(thisForMigratedMatcher, matcherArguments);

                    matcherResult = {
                        pass: passed,
                        message: thisForMigratedMatcher.message
                    };
                    return matcherResult;
                }
            }
        };

        jasmine.addMatchers(migratedMatcher);
    });
}