js 注释规范的问题,@returns 里面如何写类型？

[hoythan]

我现在的写法，类似于 ts

/**
* 你好世界
* @returns { Promise<Boolean> } - 描述
*/
const hello = () => {
	...
	return !!(any...)
}

不知道 js 有没有什么规范能够约定 Promise 返回的参数类型?

例如

/**
* @returns { Promise< Boolean | String > } - 描述
*/

[hoythan]

另外 vscode 如何才能实现鼠标经过函数显示它的注释信息？没有找到可用的插件求推荐

[lovedebug]

印象中 VS 有 doc 插件可以用，自己也可以引入外部的 doc 库用作代码注释和格式化

[Pastsong]

http://usejsdoc.org/

[TomVista]

我觉得你写的就是 jsdoc,和 ts 没什么关系....

另外你要的插件 vs 原生带

[hoythan]

@TomVista
@Pastsong


规范只有约束了 类型，没有约束 promise 返回的有哪些类型，因为 异步比较多，都是 promise 没有实际意义

http://usejsdoc.org/tags-returns.html

[Pastsong]

@hoythan 写 TypeScript 的类型就行，VSCode 甚至会帮你做类型检查（无须插件）

[azh7138m]

jsdoc 的格式就行，ts （ vscode ）支持这种注释

[TomVista]

@Pastsong @azh7138m @hoythan 突发奇想

```JavaScript
function test1(){
/**
* @param {string} p
* @param {int} a
* @returns {Promise}
*/
function Ts(p,a){
return new Promise();
}
return Ts;
}

test1()().catch
test1()().then
```

[azh7138m]

@TomVista 搞这玩意是干啥
https://github.com/Microsoft/TypeScript/wiki/JSDoc-support-in-JavaScript

[TomVista]

@azh7138m 蛇皮操作：dog