node.js - 如何告诉 JSDoc 一个方法返回一个包含类类型的对象？

Question

我有一个 Node.js 函数来创建 Express 服务器。

我已将 //@ts-check 添加到文件中，以便 VSCode 对所有内容进行 lint 和类型检查。

记录此 createServer 函数的正确方法是什么？

我想表明它返回一个 Promise，该 Promise 解析包含 Express 实例 (app) 和 Number (port) 的对象

如果这是一种反模式，那么也很高兴知道。

//@ts-check
const express = require('express');

/**
 * @param {Number} port
 * @returns {Promise}
 */
function createServer(port) {
    return new Promise((resolve, reject) => {
        const app = express();
        server = app.listen(port, () => {
            resolve({app, port});
        });
    });
}

Answer 1

这为我编译:

//@ts-check
const express = require('express');

/**
 * @param {Number} port
 * @returns {Promise<{app: import("express").Express, port: number}>}
 */
function createServer(port) {
    return new Promise((resolve, reject) => {
        const app = express();
        const server = app.listen(port, () => {
            resolve({app, port});
        });
    });
}

参见the documentation page了解更多信息。