Как правильнее описать объект в jsdoc?

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

/**
 * @typedef {Object} Person
 * @property {string} name - Имя человека.
 * @property {number} age - Возраст человека.
 * @property {string} [address] - Адрес человека (опциональное поле).
 * @property {Array} hobbies - Массив с хобби человека.
 */

/**
 * @type {Person}
 */
var person = {
  name: 'John',
  age: 30,
  hobbies: ['reading', 'coding']
};