VSCode Javascript - ES6 Class 实例 Generics JSDOC

Question

我最近发现您可以在 VSCode 中为 javascript 项目实现 JSDoc generics，这太棒了。 过去我在编写 JS 时遇到的一个大问题是智能感知永远不知道我正在处理哪些类型。

我遵循了有关如何实现 generics 的文档（使用 @template 注释）： https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#template

它的工作原理主要是因为我可以正确地看到我的 class 类型。 问题是它实际上似乎并不知道任何非静态方法和属性。

这是一些示例代码：

"use strict";

class Parent {
    age = 10;

    outputAge() {
        console.log(`My age is ${this.age}`);
    }
}

class Child extends Parent {
    name = "Bob";

    outputName() {
        console.log(`My name is ${this.name}`);
    }
}

/**
 * @template T
 * @param {T} classType
 * @returns {T}
 */
function genericFunction(classType) {
    return new classType();
}

const testGeneric = genericFunction(Child);
testGeneric.outputName();
testGeneric.outputAge();

代码正确执行。 testGeneric在运行时正确地具有outputAge()和outputName()方法。

问题是 VSCode 似乎不知道：

• age
• name
• outputAge()
• outputName()

我怀疑这是因为 generics 的工作方式。 它似乎知道它是Child类型，但并不知道它是Child的实例。 如果我添加任何 static 方法，它们会正确显示在智能感知中。

如果我将testGeneric内联注释为具有Child类型，我可以看到所有属性和方法：

我对你们所有人的问题：有没有办法正确设置我的模板以知道它返回T的实例，或者这只是 VSCode 智能感知中的限制/错误？

让我知道是否有任何需要澄清的地方。

Answer 1

因为我找不到任何与 JSDoc 的ReturnType等效的东西，所以我决定换一种方式，让参数返回T ，以便@returns {T}现在返回实例类型：

/**
 * @template T
 * @param {{ new(...args: any[]): T }} classType
 * @returns {T}
 */
function genericFunction(classType) {
    return new classType();
}

用https://vscode.dev/和typescriptlang.org/play测试

Answer 2

如果您想使用@template，那么在我看来它会更正确

/**
* @template ParentType
* @property {number} age
* @property {function(): void} outputAge
*/
class Parent {
    age = 10;

    outputAge() {
        console.log(`My age is ${this.age}`);
    }
}

/**
* @template ChildType
* @extends {Parent}
* @property {string} name
* @property {function(): void} outputName
*/
class Child extends Parent {
    name = "Bob";

    outputName() {
        console.log(`My name is ${this.name}`);
    }
}

/**
* @template {ChildType} T
* @param {T} classType
* @returns {T}
*/
function genericFunction(classType) {
    return new classType();
}

const testGeneric = genericFunction(Child);
testGeneric.outputName();
testGeneric.outputAge();