闭包编译器类型:参考函数(工厂方法)

Closure compiler typing: Refer to function (factory method)

假设我有一个带有工厂方法的class:

export class Foo {
    constructor(options) {
        this.a = options.a;
        this.b = options.b;
    }

    /**
     * @param {{
     *   a: number,
     *   b: number
     * }} options
     * @return {!Foo}
     */
    static create(options) {
        return new Foo(options);
    }
}

我想在另一个 class 中依赖注入 Foo 的工厂方法,例如:

/**
 * @param {{
 *   createFoo: !function(!Object): !Foo
 * }} options
 */

问题:闭包编译器说这与形式参数不匹配。

found   : {
  createFoo: function ({a: number, b: number): Foo, 
}

required: {
  createFoo: function (Object): Foo, 
}

显然我可以重写记录中的类型签名和硬代码,但我真的想引用 Foo.create 所以每次向选项添加新参数时都不需要更新整个代码库目的。

如何为 CC 执行此操作?

一种方法是在 typedef 中写一次类型,然后在两个地方引用它。 (我没试过这个,但我认为它应该有用)

/** @typedef {function({a: number, b:number}): Foo} */
var FooCreator;

export class Foo {
    ...

    /**
     * @type {FooCreator}
     */
    static create(options) {
        return new Foo(options);
    }
}

/**
 * @param {{
 *   createFoo: FooCreator
 * }} options
 */

普遍的问题是您需要一个比 Foo.create 方法更容易接受的函数。 Nick Santos 对此做了很好的解释:

http://closuretools.blogspot.com/2012/06/subtyping-functions-without-poking-your.html

使用宽松的函数类型 "Function" 或“!Function”将如您所愿。

我用这个定义来验证:

/** @param {{createFoo: !Function}} options */
function f(options) {}

f({createFoo: Foo.create});

CC debugger sample