如何使用JSDoc记录ES6类属性

JSDoc是一种用于JavaScript代码文档化的标记语言，它可以帮助开发人员生成清晰、易读的文档。在记录ES6类属性时，可以使用JSDoc的注释语法来描述属性的类型、名称、默认值等信息。

下面是一个使用JSDoc记录ES6类属性的示例：

/**
 * @class
 * @classdesc 表示一个人的类
 */
class Person {
  /**
   * 创建一个人的实例
   * @param {string} name - 人的姓名
   * @param {number} age - 人的年龄
   */
  constructor(name, age) {
    /**
     * @member {string}
     * @description 人的姓名
     */
    this.name = name;

    /**
     * @member {number}
     * @description 人的年龄
     * @default 18
     */
    this.age = age || 18;
  }

  /**
   * 获取人的姓名
   * @returns {string} 人的姓名
   */
  getName() {
    return this.name;
  }

  /**
   * 获取人的年龄
   * @returns {number} 人的年龄
   */
  getAge() {
    return this.age;
  }
}

在上面的示例中，我们使用了JSDoc的注释语法来描述了Person类及其属性。具体说明如下：