javascript - JSDoc:将类型分配给内联变量

Question

我可以将类型分配给获得 object 的变量吗？第三方库的结果？

const result = thirdPartyLib.doSomething();

现在我可能有一个 ES6 类

class MyClass {
  ...
}

我想注释我的 result为 MyClass 类型.

这可以使用 JSDoc 吗？

Answer 1

JSDoc @type {…} tag可以应用于局部变量以声明其类型。

/** @type {MyClass} */
const result = thirdPartyLib.doSomething();

但是，您可以使用 @external tag，而不是在调用函数的任何地方添加此声明。将 JSDoc 类型添加到 thirdPartyLib.doSomething() ，允许正确推断局部变量类型。

/**
 * @external thirdPartyLib
 */
/**
 * @function external:thirdPartyLib.doSomething
 * @returns {MyClass}
 */

const result = thirdPartyLib.doSomething();