How to document resolved values of JavaScript promises

Question

Given this code :

function asyncFoo() {
  return new Promise(function (fulfill, reject) {
    doAsyncStuff(function(err, data) {
      if(err) reject(new Er         


        

Answer 1

Looks like you should do the following, based on some other source code's comments.

/**
 * @return {Promise.}
 */

How JavaScript Promises are documented.

Similar question with a similar answer. Note the lack of a dot in that answer.