我可以在 jsdoc 中使用 typescript 实用程序类型吗？

Question

当我将 jsdoc 用于 vscode 时。 我看到我可以使用 typescript 实用程序类型。 例如：

/**
 * Func 1
 * @param {number} x 
 */
function func1(x) {
    return [x, x]
}

/**
 * Func 2
 * @param {ReturnType<func1>} x  // Here !
 */
function func2(x) {
    return x[0];
}

所以我想知道这是否是 jsodc 的正确用法。 如果有一种方法可以创建我自己的类型转换器，例如创建一个来解开承诺解析类型。

Answer 1

创建一个新的类型转换器来打开 promise ：

/**
 * @template T
 * @typedef  {T extends Promise<infer Value> ? Value : T} PromiseValue
 */

或者使用type-fest ：

/**
 * @template T
 * @typedef {import('type-fest').PromiseValue<T>} PromiseValue 
 */