4

Простой пример:

 /**
   * Тут описание метода
   *
   * @param {number} id 
   * @return {this}
   */
  myMethod(id) {
    // ...do something

    return this;
  },

Варианты документации:

 /**
   *
   ...

   * @return {this}
   */

Так:

 /**
   *
   ...

   * @return {Object} this
   */

Или так:

 /**
   *
   ...

   * @return {Object} this - VueComponent
   */

Как правильно? Или как документируете вы?

1
  • А зачем? Как правило на практике редко используются компоненты, к методам которых можно/нужно обратиться извне (и один хрен среда связь с ней потеряет). Разбивка на супермелкие компоненты помогает, но это предел. Мы потихоньку переходим на react/typescript, во вью сложно за порядком следить, когда проект разрастается. 16 мар 2020 в 13:19

1 ответ 1

1

Я не видел, чтобы была возможность в @returns указать, что возвращаться будет this метода, только тип и короткое описание. Если нужно сообщить, что функция вернёт свой this, то можно текстом указать это в описании функции.

А вообще обычно достаточно указать только тип и не более. Если к примеру Вы пишите Vector2 или Complex, Quaternion, то такие вещи разумный программист создаёт Неизменяемыми. В таком случае все операции над экземплярами этих классов всегда отдают новый объект.

Это сделано из соображения безопасности: в любой момент ссылка на объект может быть скопирована, затем в одном месте цепочка расчётов продолжается, а в другом необходимо просто хранить промежуточное значение. Сделали объект модифицируемым - одна чать программы любезно и незаметно побьёт данные в другой части. А ты бегай потом с дебаггером и соображай.

2
  • Спасибо. Хороший ответ. Да, на момент написания вопроса не совсем знал что делает @return. В проекте сейчас пишем @return {Object} this - VueComponent. Поставил +1.
    – doox911
    12 окт 2020 в 5:32
  • Всегда рад помочь! 13 окт 2020 в 6:32

Ваш ответ

Нажимая на кнопку «Отправить ответ», вы соглашаетесь с нашими пользовательским соглашением, политикой конфиденциальности и политикой о куки

Всё ещё ищете ответ? Посмотрите другие вопросы с метками или задайте свой вопрос.