javascript - 是否有将函数参数定义为回调的 JavaDoc 注释？

Question

是否有 javadoc 方法告诉 PHPStorm Javascript 函数接受回调作为参数？

/**
 * Calculates the and calls the callback function.
 *
 * @param {string} arg1 The argument.
 * @param {????} callback A function to be called.
 **/
foo: function(arg1,callback)
{
   //...
   callback();
}

Answer 1

您可以为此使用 {function} 类型，例如

/** 
 * @param {function(number):string} f 
 * @param {number} n 
 * @return {string} 
*/
function foo( f, n ){  return f(n); }

有关更多信息，请参阅Google Closure 编译器文档，“类型表达式”部分

JSDoc 3 还引入了一个 @callback 标记 ( http://usejsdoc.org/tags-callback.html )，但尚不支持（请参阅此问题）