Top "Jsdoc" questions

JSDoc is a markup language for adding inline API documentation to JavaScript source code.

How to describe "object" arguments in jsdoc?

// My function does X and Y. // @params {object} parameters An object containing the parameters // @params {function} callback The callback function …

javascript jsdoc
How to specify an array of objects as a parameter or return value in JSDoc?

In JSDoc, the best documentation I can find shows to use the following if you have an array of a …

javascript documentation jsdoc
JSDoc: Return object structure

How can I tell JSDoc about the structure of an object that is returned. I have found the @return {{field1: …

javascript documentation-generation jsdoc code-documentation jsdoc3
Is there a way to generate JSDoc comments in Visual Studio Code

I am currently developing a NodeJS project and found out that there is no built in functionality to create JSDoc …

visual-studio-code jsdoc
Best way to document anonymous objects and functions with jsdoc

Edit: This is technically a 2 part question. I've chosen the best answer that covers the question in general and linked …

javascript documentation tags jsdoc
How to indicate param is optional using inline JSDoc?

According to the JSDoc wiki for @param you can indicate a @param is optional using /** @param {String} [name] */ function getPerson(…

javascript google-closure-compiler jsdoc
How to return void in JsDoc?

Is there a specified way to declare a method or a function to return void in JsDoc? Currently I am …

javascript ide jsdoc
How do I JSDoc A Nested Object's Methods?

I've been trying to use JSDoc3 to generate documentation on a file, but I'm having some difficulty. The file (which …

javascript requirejs jsdoc jsdoc3
How to document the properties of the object in the JSDoc 3 tag: @this

The @param tag allow the documentation of properties, e.g. /** * @param {Object} userInfo Information about the user. * @param {String} userInfo.…

this jsdoc
How to specify resolution and rejection type of the promise in JSDoc?

I have some code that returns a promise object, e.g. using Q library for NodeJS. var Q = require('q'); /** * @…

javascript node.js documentation jsdoc promise