Как правильнее описать объект в 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']
};

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

/**
 * @typedef {Object} Car
 * @property {string} brand - Марка автомобиля.
 * @property {string} model - Модель автомобиля.
 * @property {number} year - Год выпуска автомобиля.
 * @property {boolean} isAutomatic - Является ли автомобиль автоматической коробкой передач.
 */

/**
 * @type {Car}
 */
var myCar = {
  brand: 'Toyota',
  model: 'Camry',
  year: 2020,
  isAutomatic: true
};