Skip to content

jsdoc/require-yields Correctness

What it does

Requires that yields are documented. Will also report if multiple @yields tags are present.

Why is this bad?

The rule is intended to prevent the omission of @yields tags when they are necessary.

Examples

Examples of incorrect code for this rule:

javascript
function* quux(foo) {
  yield foo;
}

/**
 * @yields {undefined}
 * @yields {void}
 */
function* quux(foo) {}

Examples of correct code for this rule:

javascript
/** * @yields Foo */
function* quux(foo) {
  yield foo;
}

References

Released under the MIT License.