为将另一个函数作为参数的函数制作 JSDoc 注释

Question

想象一个接受“onUpdate”函数作为参数的函数：

 /**
 * @param {function} onUpdate
 * @returns {null}
 */
static async init(onUpdate) {
    ...
    onUpdate(true);
};

onUpdate 接受一个布尔值作为参数。 我想将该参数添加到 @param {function} onUpdate。

有办法吗？

一些出色的开发人员设法在这些 addEventListener 函数上做到了：

Answer 1

我认为您在屏幕截图中看到了打字稿提示。但是你可以做类似 this:

/**
 * This callback is displayed as a global member.
 * @callback someCallback
 * @param {number} param1
 * @param {number} param2
 * @returns {number}
 */

/**
 * 
 * @param {someCallback} cb 
 */

function someFunction(cb) {

}

看看这个hint

为将另一个函数作为参数的函数制作 JSDoc 注释

Make JSDoc comment for function which takes another function as parameter

javascript

jsdoc