JSDoc @async 标签
目录
Syntax
@async
Overview
The @async tag indicates that a function is asynchronous, meaning that it
was declared using the syntax async function foo() {}. Do not use this tag for other types of
asynchronous functions, such as functions that provide a callback. This tag is available in JSDoc
3.5.0 and later.
In general, you do not need to use this tag, because JSDoc automatically detects asynchronous functions and identifies them in the generated documentation. However, if you are writing a virtual comment for an asynchronous function that does not appear in your code, you can use this tag to tell JSDoc that the function is asynchronous.
Example
The following example shows a virtual comment that uses the @async tag:
/**
* Download data from the specified URL.
*
* @async
* @function downloadData
* @param {string} url - The URL to download from.
* @return {Promise<string>} The data from the URL.
*/