JSDoc 用于在 Google 表格自动完成下拉列表中显示可选参数

Question

我想记录（在 Google 表格自动完成中）一个带有可选参数的自定义函数，类似于

WEEKDAY

函数（下面的自动完成）。

关于可选参数的JSDoc 规范 不起作用。谷歌似乎没有在任何地方记录这一点。我怎样才能创建一个与谷歌具有相同视觉处理（在参数描述和示例中）的函数？

/**
 * Summary of function
 * @param {"example"} arg Argument description
 * @param {"optional"} opt_arg This argument is optional
 * @return {String} Return value description
 * @customfunction
 */
function JSDOC(arg, opt_arg) {
  return
}

生成此自动完成：

这不是重复。我特别询问可选参数，如您所见，我已经成功地使自动完成的其他功能正常工作。

Answer 1

Google Apps 脚本目前不支持其 JSDoc 中的可选参数。

Answer 2

JsDoc 不完全支持。不支持特别可选的参数。相关的跟踪器链接在这里：

https://issuetracker.google.com/issues/156230902

任何对此问题感兴趣的人都可以对此问题添加 +1（在顶部栏上，而不是作为评论）。他们还可以为此添加新的特定 feature request。