Поддержка CoffeeScript JSDoc в PhpStorm/WebStorm

Question

Есть ли способ использовать JSDoc для комментирования исходного кода, написанного на CoffeeScript при работе в PhpStorm/WebStorm? При работе в среде IDE очень полезно иметь возможность использовать JSDoc для правильного завершения кода для функций.

Я нашел этот последний вопрос: How to document CoffeeScript source code with JSDoc? Однако ответы и комментарии не ясны о том, поддерживается ли он или что такое правильный синтаксис.

Answer 1

К сожалению, на данный момент это не поддерживается. Pleasze стесняйтесь подать запрос на эту функцию, чтобы youtrack

Answer 2

в CoffeeScript есть способ использовать основные JavaScript, включив в код между «`»

 
coffee code 
` common javascript code ` 
coffee code 

есть может быть возможность использовать это, чтобы положить ваш jsCode здесь

 
coffee code 
` 
/** @constructor*/ 
` 
coffee code 

я еще не пробовал это решение ...

Answer 3

Вот обновленный ответ для тех, кто приходит через эту нить в го будущее. WebStorm 2017.3 (текущая версия на момент написания этой статьи) поддерживает JavaScript javaadocs.

Базовый синтаксис таков:

###* 
* Here is a simple description for foo 
* @param {Bar} bar - Some parameter to foo 
* @returns {Object} The thing that foo returns 
### 
foo = (bar) -> 

WebStorm даст вам документацию при нажатии Ctrl + Q.