Есть ли способ, чтобы комментарии JSDOC были видны в файлах HTML? ⇐ Javascript

[Anonymous]

Я не уверен, как получить фрагмент кода для этого вопроса, так как я не знаю, как указать имя файла файла JavaScript, но здесь идет. Комментарии JSDOC включены, чтобы указать параметры для функций, переменных и классов. Это было наиболее полезно для разработки Scripts.js, гарантируя, что у меня есть правильная набор в JavaScript. Однако, когда я использую файл scripts.js в HTML -файле, эти подсказки типа JSDOC не видны. Например, в коде Visual Studio вызов нижнего колонтитула (1); не дает мне следующую проблему:

Код: Выделить всё

Argument of type 'number' is not assignable to parameter of type 'string'.
< /code>
Я добавил // @ts-check < /code> в файл html и импортный нижний колонтитул, но все же не удачи. /> 
// @ts-check
"use strict";

/**
* @param {string} [email] - Email address. (optional)
*/
function footer(email = "")
{
// main function

{
let html = "";

html += ``;
html += ``;
html += `[url=mailto:${email}]${email}[/url]`;
html += ``;

document.body.insertAdjacentHTML("beforeend", html);
}
}< /code>






// @ts-check
import
{
footer
} from "";

JSDoc Test




JSDoc Test

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Maecenas porttitor congue massa. Fusce posuere, magna sed
pulvinar ultricies, purus lectus malesuada libero, sit amet
commodo magna eros quis urna.


footer("name@someplace.com");
footer(1); // no error here but ts-check should complain because the param is not a string

Подробнее здесь: https://stackoverflow.com/questions/797 ... html-files