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 compiler docs ，“类型表达式”部分了解更多信息

JSDoc 3 还引入了一个@callback 标签(http://usejsdoc.org/tags-callback.html)，但目前还不支持(参见this issue)