javascript - JSDoc を使用して関数によって返される関数を文書化する方法

Question

パラメータのドキュメントに JSDoc を使用しています。

のパラメータ型を文書化する方法は明らかですがmany_prompts、それが返す関数を文書化する正しい方法は何ですか?

/**
 * @param {Number} - number of times to prompt
 * @return {Function(prompt{Number})} - the returned function
 */
function many_prompts(count) {
  return function(prompt) {
    for(var i=0; i < count; i++) alert(prompt);
  }
}


//Example of use:
var y  =many_prompts(3);
y('Hello World');

Answer 1

私が好む方法：

/**
 * @param {number} count - number of times to prompt
 * @returns { (promt:string) => void } - the returned function
 */
  manyPrompts(count) {
      /**
       * My inner function
       *
       * @param {object} prompt Some parameter
       */
      const inner = function(prompt) {
        for (let i=0; i < count; i++) {
          alert(prompt);
        };
      };
      return inner;
  }