JSDo c во внешнем файле, возможно? Как? - PullRequest
Новая
       75

JSDo c во внешнем файле, возможно? Как?

0 голосов
/ 13 июля 2020

Я думаю, что это выглядит запутанным и трудным для чтения, когда JSDo c смешивается с обычным (JS) кодом. Можно ли добавить документацию во внешний файл и ссылаться на функции там (и чтобы Visual Studio «предварительный просмотр» типов параметров и возвращаемых значений работал правильно с помощью JSDo c)?

Что мне делать нужно сделать, чтобы это (или что-то подобное) работало?

Я думаю примерно так (3 файла).

myfile. html

...
<body>
    ...
    <script src="./JSDock.js"></script>
    <script src="./script.js"></script>
</body>

JSDo c. js

/**
 * @function test
 * @param {string} myText
 * @return int
 * What more should be here?
 */

скрипт. js

function test(myText) {
    return 5;
}
...