Вы знаете, существует ли своего рода <код/> тег в JSDoc? Я должен добавить части кода в моей документации как это: / ** * Эта функция делает что-то видит пример ниже: * * var x = нечто ("...
Править: Это - технически 2 вопроса о части. Я выбрал лучший ответ, который касается вопроса в целом и связанный с ответом, который обрабатывает конкретный вопрос. К чему лучший способ...
В моем проекте модели базы данных динамически загружаются и экспортируются из папки моделей. Я хочу указать в JSdoc, что любое свойство module.exports является типом Sequelize ....
Предположим, что у меня есть класс как это: функционируйте myClass (q) {this.someFunction = функция (e) {console.log ("Нажимают событие");}; jQuery (q) .click (this.someFunction);} там способ указать...
У меня есть реактивный проект, и я использую Jest для написания модульных и интеграционных тестов. Я хочу использовать jsdoc для документирования этих файлов. Но не знаете как? не нашел ничего на странице jsdoc. Может кто-нибудь ...
В машинописном тексте я могу задокументировать словарь / карту, в которой есть определенные заданные записи, но все же это словарь / карта (как вы можете добавлять или удалять записи), как этот тип Foo = {bar: number; му: номер; ...
При работе над проектом javascript / typcript в VSCode я хочу написать многострочный код в комментарии. Зная, что VSCode поддерживает синтаксис уценки в комментариях, я продолжаю и пишу: / ** * `` `ts * {...
Давайте рассмотрим следующий код, функцию, которая возвращает объект с двумя функциями: / ** * Создать что-то * @returns {object} Something * / function createSomething () {return {/ ** ...
Я использую синтаксис перегрузки JSDoc, как предложено в других вопросах и в Интернете, не уверен, правильно ли он у меня, но здесь идет речь: / ** * @param {string} param * @returns {'string result'} * // * * * @ ...
У меня есть файл кода JavasScript для чтения файла в браузере. Я добавил проверку TypseScript в файл. Теперь он дает сообщение об ошибке. [ts] Свойство 'FilesReader' не существует для типа '...
У меня есть функция, которая принимает один аргумент объекта. Важное значение имеет одно конкретное свойство этого объекта, а все остальные потенциальные свойства будут игнорироваться. Как я могу документировать дополнительные ...
Давайте скажем, у вас есть что-то вроде следующего: var someFunc = function () {// здесь что-то делаем с аргументами
} Как бы вы правильно задокументировали, что эта функция может принимать любое количество ...
По теме: Правильный способ документирования функций с открытыми аргументами в JSDoc У меня есть функция, которая принимает несколько массивов путем доступа к переменной аргументов: / ** * @param options Объект, содержащий. ..
Мне нужно выбрать генератор документации (аналогичный jdoc в java или rdoc в ruby) для моего проекта javascript, который (построен с помощью jquery, подчеркивания и основы) Кандидаты: jsdoc toolkit
pdoc
...
Я знаю, что есть разные варианты JSDoc. И кажется, что каждая реализация парсера JSDoc распознает свой собственный набор тегов. Например, рассмотрим различия в тегах между http:/...
Учитывая этот код: function asyncFoo () {вернуть новое Promise (function (execute, reject) {doAsyncStuff (function (err, data) {if (err) reject (new Error (err))); иначе выполнить (new Bar (data) ...
Я пытался создать набор инструментов с использованием сценария приложений Google. Проблема в том, что, насколько я могу судить, допускается только один уровень организации. Вы можете создать библиотеку под названием «Секундомер»…
Существует множество отличных возможностей для создания документации API для других языков, но мне еще предстоит найти решение для моего JavaScript API, которое я хочу разместить на GitHub Pages. Кажется, что я могу ...
Я использую базовый «класс» jQuery $.widget(), который предоставляет метод option(). Поскольку этого метода нет в моем коде, у меня нет места для документирования аргумента. Пробовал ставить jsDoc на поля в...
Тег @param позволяет документировать свойства, например. /***@param {Object} userInfo Информация о пользователе. *@param {String} userInfo.name Имя пользователя. *@param {String}...
Как документировать возвращаемое значение (и параметры) массива в JSDoc, когда элементы массива могут быть одним из следующих: Тип (например, String, Array).
Объектный литерал.
Я пытаюсь документировать вызовы router.get с помощью JSDocs. Я не могу заставить документацию правильно отображаться на странице, если я пытаюсь добавить ее к самому вызову маршрутизатора. /** * Проверка здоровья * @...
Я использую IDE, я хочу автозаполнение некоторой функции, но функция не определена в коде, тогда у меня есть предупреждение. например у меня есть объект var client = getRemoteClien (); // здесь ...
У меня есть некоторый код, написанный на CoffeeScript, и я хочу оптимизировать сгенерированный JavaScript с помощью компилятора Google Closure, поэтому эти файлы необходимо документировать с помощью JSDoc. У меня вопрос, как я могу ...
В настоящее время я рефакторинг некоторого кода Javascript, который у нас есть, и среди прочего я изменил его, чтобы сделать использование шаблона раскрывающегося модуля. Код выглядит намного аккуратнее, и он работает нормально, но я могу'...
У меня есть 2 типа модулей: Основной файл Require.js: require.config({ baseUrl: "/another/path", paths: { "some": "some/v1.0" }, waitSeconds: 15, локаль: "fr-fr"
...
Есть ли где-нибудь список допустимых типов тегов param для jsdoc? Например, @param {type} myParam Некоторое описание параметра Я знаю, что такие вещи, как число и строка действительны, но что если я ...
Учитывая функцию Javascript, которая принимает функции обратного вызова в качестве параметров: var myFunction = function (onSuccess, onFailure) {...} Как мне документировать тип и аргументы возвращаемого значения в onSuccess?
Я пытаюсь задокументировать генератор функций, но безуспешно, это пример :function genericObjectGenerator (tagname ){ var SpecificObject = function (){}; специфическийОбъект.getClassName =...