JsDoc：我如何只记录一个对象

Question

在 JSDoc 中，如何实际记录一个对象，而不是作为参数？

例子

let object1 = {
  name: '' //string,
  age: '' //number,
};

实例

 /**
   * Update User
   * @param {Object} params
   * @param {String} params.oldName
   * @param {String} params.oldAge
   */
  const onChangeUser = params => {
    ....

    //I want to document this object
    let object1 = {
      // name: '', string,
      // age: '' number,
    };
  };

这个对象不属于任何函数，只是函数内部的一个对象，但不用作参数

Answer 1

复杂类型可以使用 typedef @documentation

别名

/**
 * @typedef PersonProperties
 * @type {object}
 * @property {string} name - Full Name of the Person.
 * @property {number} age  - Age of Person.
 */

用法：

/** @type {PersonProperties} */
let object1 = {
  name: '',
  age: ''
};

JsDoc：我如何只记录一个对象

JsDoc: How do I document an object only

javascript

jsdoc