@return
@returns [{type}] [description]
The @returns
tag documents the value that a function returns.
If you are documenting a generator function, use the @yields
tag instead of this tag.
/** * Returns the sum of a and b * @param {number} a * @param {number} b * @returns {number} */ function sum(a, b) { return a + b; }
/** * Returns the sum of a and b * @param {number} a * @param {number} b * @returns {number} Sum of a and b */ function sum(a, b) { return a + b; }
/** * Returns the sum of a and b * @param {number} a * @param {number} b * @param {boolean} retArr If set to true, the function will return an array * @returns {(number|Array)} Sum of a and b or an array that contains a, b and the sum of a and b. */ function sum(a, b, retArr) { if (retArr) { return [a, b, a + b]; } return a + b; }
/** * Returns the sum of a and b * @param {number} a * @param {number} b * @returns {Promise} Promise object represents the sum of a and b */ function sumAsync(a, b) { return new Promise(function(resolve, reject) { resolve(a + b); }); }
© 2011–2017 the contributors to the JSDoc 3 documentation project
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://usejsdoc.org/tags-returns.html