跳转到内容

jsdoc/require-returns-description 冗长

其用途

要求 @returns 标签具有描述值。如果返回值为voidundefined,或者为Promise<void>Promise<undefined>,则不会报告错误。

为什么这么糟糕?

一个 @returns 标签应该具有描述值。

示例

此规则对于不正确的代码示例

javascript
/** @returns */
function quux(foo) {}

此规则对于正确的代码示例

javascript
/** @returns Foo. */
function quux(foo) {}

参考

在 MIT 许可下发布。