javascript - 包含构造函数的对象的闭包编译器注释

Question

我正在尝试对返回构造函数对象的库进行类型检查。使用以下代码关闭错误:

./my-app.js:11: ERROR - Cannot call non-function type Foo.Wheel
const wheel = new Foo.Wheel();
               ^

代码结构如下:

my-app-code.js - 我正在使用的代码

const Foo = /** @type{!Foo.Module} */ require('foo');
const wheel = new Foo.Wheel();
wheel.rotate();

externs-foo.js - Foo 库的闭包 extern

/** @const */
const Foo = {};


/** @record */
Foo.Module = function() {};

/** @type {!Foo.Wheel} */
Foo.Module.prototype.Wheel;

/** @constructor */
Foo.Wheel = function() {};

/**
* @returns {void}
*/
Foo.Wheel.prototype.rotate = function() {};

foo/index.js - 对应于 Foo.Module 类型。

module.exports = {
  Wheel: require("./wheel"),
};

foo/wheel.js - 对应于 Foo.Wheel。

function Wheel() {}

Wheel.prototype.rotate = function() {};

module.exports = Wheel;

我尝试了 externs-foo.js 的一种变体，结果如下。

使 Foo.module.prototype.Wheel 成为一个函数

/** @return {!Foo.Wheel} */
Foo.Module.prototype.Wheel = function() {};

错误:

my-app.js:11: ERROR - Expected a constructor but found type function(this:Foo.Module):Foo.Wheel.
const wheel = new Foo.Wheel();

my-app.js:13: ERROR - Property rotate never defined on module$myapp_Foo of type Foo.Module
wheel.rotate();

Answer 1

我知道此问题有两种解决方案:

1. 在 externs 文件中声明 Foo.Module.prototype.Wheel = Foo.Wheel;。
2. 使用@type {function(new:Foo.Wheel)}，它表示该函数实际上是实例化 Foo.Wheel 对象的构造函数。

我更喜欢解决方案#1，因为它声明了对构造函数的引用，因此编译器将允许我访问构造函数的属性(例如静态方法)。 IIRC 这不能在解决方案 #2 中完成。

注释 @type {!Foo.Wheel} 和 @return {!Foo.Wheel} 不起作用，因为它们引用 的实例Foo.Wheel 而您真正想要的是构造函数本身。