Задать вопрос
@TedMarsh

Почему JSDoc не видит локальные комментарии?

В коде ниже генератор документации jsdoc не видит локальные комментарии к функциям и переменным.
document.addEventListener("DOMContentLoaded", function () {
	/**
   * Конвертирует Rem в Пиксели
   * @param   {Number} rem Сколько rem сконвертировать в пиксели
   * @returns {Number} Кол-во сконвертированных пикселей
   */
  function convertRemToPixels(rem) {
    return rem * parseFloat(getComputedStyle(document.documentElement).fontSize);
  }
});


То есть при компиляции чистое окно:
613c95db13a3a757460792.png

Когда же обёртывающей функции нет, JSDoc видит и можешь прочесть эти комментарии:
/**
	 * Конвертирует Rem в Пиксели
	 * @param   {Number} rem Сколько rem сконвертировать в пиксели
	 * @returns {Number} Кол-во сконвертированных пикселей
	 */
	function convertRemToPixels(rem) {
	  return rem * parseFloat(getComputedStyle(document.documentElement).fontSize);
	}

	console.log(convertRemToPixels(2))

613c96d68822b505219536.png

jsdoc.json:
{
  "source": {
    "include": "./src/js/main.js",
    "excludePattern": "(node_modules/|docs|dist)"
  },
  "plugins": ["plugins/markdown"],
  "templates": {
    "cleverLinks": true,
    "monospaceLinks": true
  },
  "opts": {
    "recurse": true,
    "destination": "./docs/",
    "readme": "./readme/readme.md"
  }
}


Как исправить такое поведение JSDoc?
  • Вопрос задан
  • 85 просмотров
Подписаться 1 Простой Комментировать
Пригласить эксперта
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Похожие вопросы