具有默认参数的函数的 JSDoc答案

【问题标题】：JS Doc for functions with default parameters具有默认参数的函数的 JSDoc
【发布时间】：2021-11-25 11:07:17
【问题描述】：

我使用 JSDoc @param 注释创建了函数描述，如下所示（使用 Visual Studio“添加 jsdoc cmets”插件）。但是对于函数的默认参数，它的数据类型并不附带。即使我检查了 JSDoc，我也没有发现这是否是描述默认参数的正确语法。

因此，任何人都可以确认“添加 jsdoc cmets”插件是否遵循描述函数的正确语法。

检查下面的invoiceUpdate 参数（这里我使用的是TypeScript）。

  /**
   * @param  {string[]} invoiceIds
   * @param  {string} token
   * @param  {} invoiceUpdate=false
   * @returns Promise
   */
  public async calculateInvoices(
    invoiceIds: string[],
    token: string,
    invoiceUpdate = false,
  ): Promise<string> {
      
     /*
        function body
     */

  }

【问题讨论】：

标签： typescript visual-studio jsdoc

【解决方案1】：

为了用默认值描述可选参数，根据the docs你应该使用这个语法：

/**
 * @param {string} [somebody=John Doe] - Somebody's name.
 */

所以，你的代码应该是这样的：

  /**
   * @param  {string[]} invoiceIds
   * @param  {string} token
   * @param  {boolean} [invoiceUpdate=false] invoiceUpdate
   * @returns Promise
   */
const calculateInvoices=(
    invoiceIds,
    token,
    invoiceUpdate = false,
  )=> {
      
     /*
        function body
     */

  }

  calculateInvoices(['sdf'],'sdf')

你也可以在最近更新的typescript JSDocs page中找到很多信息

【讨论】：