giá trị như thế nào vào tài liệu giải quyết của JavaScript hứa hẹn

Question

Với mã này:

function asyncFoo() { 
    return new Promise(function (fulfill, reject) { 
    doAsyncStuff(function(err, data) { 
     if(err) reject(new Error(err)); 
     else fulfill(new Bar(data)); 
    }); 
    }); 
} 

Làm thế nào tôi có thể ghi nhận rằng asyncFoo sẽ trả về một Promise đó, khi hoàn thành sẽ mang lại một thể hiện của Bar, và khi bị từ chối sẽ mang lại một thể hiện của Error?

/** 
* @return << Here, what do I have to write? >> 
*/ 
function asyncFoo() { ... } 

Answer 1

Có vẻ như bạn nên làm như sau, dựa trên some other source code's comments.

/** 
* @return {Promise.<Bar>} 
*/ 

How JavaScript Promises are documented.

Similar question with a similar answer. Lưu ý việc thiếu một dấu chấm trong câu trả lời đó.

Answer 2

Tôi thích để xác định rằng nó là một chức năng async với @async và xác định sự trở lại hoàn thành với @returns và lỗi với @throws

/** 
* @async 
* @returns {Bar} 
* @throws {Error} 
*/ 
function asyncFoo() { ... }