function-comment

Given some JavaScript and the line on which a function is defined it returns comments and jsdocs found right above that function.

function-comment

Given some JavaScript and the line on which a function is defined it returns comments and jsdocs found right above that function.

var findex = require('findex');
var fs = require('fs');
 
/**
 * Adds c to d and then multiplies the result with d.
 * 
 * @name doingStuff
 * @function
 * @param c {Number}
 * @param d {Number}
 * @return {Number} overall result
 */
function doingStuff (cd) {
  return (+ d) * d
}
 
// the function whose comment we are trying to find is on line 13 
var lineno = 13; 
 
fs.readFile(__filename, 'utf8', function (errsrc) {
  if (err) return console.error(err);
  
  var comment = findex(src, lineno);
  console.log(comment);
});

Output:

**
 * Adds c to d and then multiplies the result with d.
 *
 * @name doingStuff
 * @function
 * @param c {Number}
 * @param d {Number}
 * @return {Number} overall result
 */
npm install function-comment
/**
 * Finds any concecutive comment above the given line of code in the source.
 *
 * @name exports
 * @function
 * @param src {String} the JavaScript source
 * @param lineno {Number} the number where the function is located (1 based)
 * @return {String} comment or empty if none was found
 */

MIT