Поддержка JSDoc в IntelliJ IDEA
Есть ли документация, для которой JSDoc подмножество, надмножество или сочетание двух поддерживаемых IntelliJ? Мотивация использования JSDoc в два раза:
- Для разработчиков: поэтому IntelliJ может обеспечить лучшее завершение кода, проверку кода, проверку ошибок и т.д.
- Для эффективности выполнения: с помощью Closure компилятор.
Для # 1, приведенного выше, для меня важно использовать разметку JSDoc, поддерживаемую IntelliJ, и до сих пор выяснение этого процесса в основном было процессом проб и ошибок.
Ответы
Ответ 1
Основываясь на том, какая небольшая информация доступна в документации WebStorm, похоже, что IntelliJ IDEA поддерживает весь набор JSDoc. Единственная другая заметка в документации - просмотр встроенной документации, которая указывает только на Страница JSDoc SourceForge.
Ответ 2
Это была небольшая пробная версия и ошибка, но я, наконец, смог получить достойные результаты. У меня были особенно проблемы с получением наследования для Backbone аналогичного OO для правильной работы. То, что я закончил, было так:
/**
* @class App.Views.ProductView
* @extends App.Views.TemplateView
**/
App.Views.ProductView = App.Views.TemplateView.extend(
/** @lends App.Views.ProductView **/
{
/**
* @param {string} str
* @return string[]
**/
method: function (str) {
return [str, str];
}
};
Вам обязательно нужно много помогать вручную, когда задействовано наследование.
Насколько я могу судить, были несоответствия: вы должны указать имя @class, иначе оно запутается. @name, похоже, работает не очень хорошо. Остальное прилично, некоторые из тегов не используются (@event и т.д.).