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

Ваш ответ

By clicking “Отправить ответ”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

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