Понимает ли PHPStorm @constructs или @constructor для JavaScript?

Я немного запутался в том, какой JSDoc описывает функцию конструктора для класса, и понимает ли PHPStorm.

Когда я исследую, какой JSDoc использовать, я постоянно сталкиваюсь с двумя версиями. Есть @constructs и @constructor.

  • Эти два тега означают одно и то же?
  • Какой тег следует использовать в моем JSDoc?
  • Есть ли преимущество в PHPStorm для завершения кода или использования Intellisense?

Вот несколько ссылок.

https://code.google.com/p/jsdoc-toolkit/wiki/TagConstructor

https://code.google.com/p/jsdoc-toolkit/wiki/TagConstructs

Теперь я понимаю, что @constructs нужно использовать с @lends, но почему?


person Reactgular    schedule 28.07.2013    source источник


Ответы (1)


если вам нужно пометить функцию как конструктор, @constructor — правильный выбор. @constructs применяется только к одолженной функции и может использоваться только с тегом @lends (который может появляться только в литералах объекта). Дополнительную информацию о теге @lends см. на этой вики-странице. Обратите внимание, что PHPStorm поддерживает оба тега для указания типа/навигации.

person lena    schedule 06.08.2013