如何让 JSDoc 识别分配给对象 属性 的匿名函数？ （包括示例代码）

Question

我有一个名为 example.js 的文件，其中包含以下内容。当我运行

jsdoc example.js

我得到了预期的 ./out 文件夹，但生成的文档不包含 foo.greeting，仅包含 greeting.

const foo = {};

/**
 * greets with name in text
 * @param {string} name  - name
 * @returns {string} - an IPC response object
 */
foo.greeting = (name) => {
  return 'hello, ' + name;
};

/**
 * greets with name in text
 * @param {string} name  - name
 * @returns {string} - an IPC response object
 */
const greeting = (name) => {
  return 'hello, ' + name;
};

是否可以让jsdoc识别对象的匿名函数赋值属性？

我目前正在使用 JSDoc 3.6.6。

Answer 1

是的，您可以通过标记 @function:

来做到这一点

/**
 * @function greeting
 * @description greets with name in text
 * @param {string} name  - name
 * @returns {string} - an IPC response object
 */
foo.greeting = (name) => {
  return 'hello, ' + name;
};

这是否会产生您正在寻找的东西，这很难说，但它至少会产生 一些东西。