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

Пользователь

от vicenta_kertzmann , в категории: JavaScript , 7 месяцев назад

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

Facebook Vk Ok Twitter LinkedIn Telegram Whatsapp

1 ответ

Пользователь

от caterina , 7 месяцев назад

@vicenta_kertzmann 

Описание объекта в JSDoc можно сделать с помощью аннотации @typedef.


Пример:

 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']
};


В примере мы создали тип Person, описав его поля и их типы. Затем мы можем использовать тип Person для указания типа переменной person.