在 JSDoc @typedef 中使用导入的类型

Question

我正在尝试减少在指定导入类型时的重复，如下所示，但出现错误

/**
@typedef {import("../types/util")} util
@typedef {util.mapBehaviors} mapBehaviors
... lots of other typedefs based on util
*/

'util' only refers to a type, but is being used as a namespace here.

这很奇怪，因为扩展导入显式有效：

/**
@typedef {import("../types/util").mapBehaviors} mapBehaviors
... lots of other typedefs
*/

如何将@typedef与导入的别名一起使用？

Answer 1

如果您仅从.d.ts文件中导出interface或type ，而不是function或const ，则可能会发生这种情况。

这将起作用：

/**
@typedef {import("../types/types").util} util
@typedef {util["mapBehaviors"]} mapBehaviors
...
*/

但只有在util.d.ts你有

export function mapBehaviors(tags: string[] | Behavior[], table: Behaviors): Behavior[]
...

代替

export interface mapBehaviors {
  (tags: string[] | Behavior[], table: Behaviors): Behavior[]
}