javascript - 使用闭包编译器时出现扩展错误

Question

我正在使用闭包编译器并尝试对错误“类”进行子类化。我有一个元功能试图做到这一点。它看起来像这样:

/**
 * @param {string} name
 * @param {(function(new:Error)?)=} parent
 * @param {(Function?)=} constructor
 * @return {function(new:Error)}
 * @usage
 *      var MyError = subclassError('MyError', null, function (x, y) {
 *          this.message = prop1 + " " + prop2;
 *      });
 *      throw new MyError(new Error(), 1, 2);
**/
function subclassError (name, parent, constructor) {
    // allow subclassing of other errors
    if (!parent) parent = Error;
    // allow no constructor to be provided
    if (!constructor) {
        /** @this {Error} */
        constructor = function (msg) { if (msg) this.message = msg; };
    }
    /** 
     * @constructor
     * @extends {Error}
     * @param {Error} error
     * @param {...*} var_args
    **/
    var func = function (error, var_args) {
        // this check is just a guard against further errors
        // note that we don't use something like getOwnPropertyNames
        // as this won't work in older IE
        var propsToCopy = ['fileName', 'lineNumber', 'columnNumber', 
           'stack', 'description', 'number', 'message'];
        for (var i = 0; i < propsToCopy.length; i++) {
            this[propsToCopy[i]] = error[propsToCopy[i]];
        }
        this.name = name;
        constructor.apply(this, Array.prototype.slice.call(arguments, 1));
    };
    func.prototype = Object.create(parent.prototype);
    func.prototype.constructor = func;
    func.name = constructor.name;
    return func;
}

基本上，上述函数创建了 Error 的子类，调用该子类时需要传入 native Error 对象。从这个对象中，它填充了行号、堆栈跟踪等内容。但它也允许您传递其他参数。

这是使用它的示例:

/**
 * @constructor
 * @extends {Error}
 * @param {Error} err
 * @param {number} bar
 * @param {number} baz
**/
var FooError = subclassError('FooError', null, function (bar, baz) {
    this.message = "invalid bar: '" + bar + "', (using '" + baz + "')";
});

/**
 * Frobs the noid.
 * @param {number} x
 * @param {number} y
 * @throws FooError
**/
function frob (x, y) {
    if (x < 0) throw new FooError(new Error(), x, y);
}

当我像这样使用闭包编译它时:

java -jar compiler.jar
    --compilation_level ADVANCED_OPTIMIZATIONS --warning_level VERBOSE
    --language_in ECMASCRIPT5 --language_out ECMASCRIPT3
    --js_output_file=frob.min.js frob.js

我收到以下警告:

frob.js:39: WARNING - inconsistent return type
found   : function (new:func, (Error|null), ...*): undefined
required: function (new:Error): ?
    return func;
           ^

frob.js:60: WARNING - Function FooError: called with 3
        argument(s). Function requires at least 0 argument(s) and no more
        than 0 argument(s).
    if (x < 0) throw new FooError(new Error(), x, y);

这里棘手的事情之一是，尽管我(从代码中)知道 func 对象源自 Error，因为要么是 Error 的后代 被传入或，我们使用 Error 作为父级，Closure 认为它是 func 的实例，而这不是一个实例错误。我尝试在上面添加一个 @extends {Error} 来纠正问题，但 Closure 仍然认为 !(func instanceof Error)。这是第一次警告。

在第二个警告中，问题是它无法识别 FooError 采用三个参数。我尝试向 FooError 添加三个参数，但由于 Closure 看不到参数列表，因此无法找到该参数。

有没有办法通过告诉 Closure 更多信息来消除这些警告？或者有没有一种方法可以以更简单的方式扩展 Closure 中的 Error ，让我们能够获取行号、堆栈等？

Answer 1

因为您正在调用返回构造函数的方法，所以我们必须采取一些技巧才能在编译器中进行完整的类型检查。

首先，更改subclassError方法以返回未知类型，以便我们可以独立定义类型签名:

/**
 * @param {string} name
 * @param {(function(new:Error)?)=} parent
 * @param {(Function?)=} constructor
 * @return {?}
 **/
function subclassError (name, parent, constructor) {}

接下来，我们为 FooError 添加一个 stub 定义，以便编译器能够理解类型信息。然后我们实际分配 subclassError 方法的结果。

/**
 * @constructor
 * @extends {Error}
 * @param {Error} err
 * @param {number} bar
 * @param {number} baz
 **/
var FooError = function(err, bar, baz) {};

FooError = subclassError('FooError', null, function (bar, baz) {
  this.message = "invalid bar: '" + bar + "', (using '" + baz + "')";
});

现在我们从编译器获得正确的类型检查

// The compiler will warn that FooError is called with
// the wrong number of arguments
new FooError(new Error());

See a Full Example