Prevents use of multiple asterisks at the beginning of lines.
Note that if you wish to prevent multiple asterisks at the very beginning of
the JSDoc block, you should use no-bad-blocks (as that is not proper jsdoc
and that rule is for catching blocks which only seem like jsdoc).
Removes multiple asterisks on middle or end lines.
A single options object has the following properties.
Set to true if you wish to allow asterisks after a space (as with Markdown):
/**
* *bold* text
*/Defaults to false.
Prevent the likes of this:
/**
*
*
**/Defaults to true.
Prevent the likes of this:
/**
*
**
*/Defaults to true.
| Context | everywhere |
| Tags | (Any) |
| Recommended | true |
| Settings | |
| Options | allowWhitespace, preventAtEnd, preventAtMiddleLines |
The following patterns are considered problems:
/**
*
**
*/
// Message: Should be no multiple asterisks on middle lines.
/**
*
**
*/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"preventAtMiddleLines":true}]
// Message: Should be no multiple asterisks on middle lines.
/**
*
**
*/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"preventAtEnd":false}]
// Message: Should be no multiple asterisks on middle lines.
/**
* With a description
* @tag {SomeType} and a tag with details
**
*/
// Message: Should be no multiple asterisks on middle lines.
/**
**
*
*/
// Message: Should be no multiple asterisks on middle lines.
/**
* Desc.
*
**/
// Message: Should be no multiple asterisks on end lines.
/**
* Desc.
*
**/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"preventAtEnd":true}]
// Message: Should be no multiple asterisks on end lines.
/**
* Desc.
*
abc * **/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"preventAtEnd":true}]
// Message: Should be no multiple asterisks on end lines.
/**
* Desc.
*
**/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"preventAtMiddleLines":false}]
// Message: Should be no multiple asterisks on end lines.
/** Desc. **/
// Message: Should be no multiple asterisks on end lines.
/** @someTag name desc. **/
// Message: Should be no multiple asterisks on end lines.
/** abc * */
// Message: Should be no multiple asterisks on end lines.
/**
* Preserve user's whitespace when fixing (though one may also
* use an align rule)
*
* */
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"preventAtEnd":true}]
// Message: Should be no multiple asterisks on end lines.
/**
* The method does 2 things:
* * Thing 1
* * Thing 2
*/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"allowWhitespace":false}]
// Message: Should be no multiple asterisks on middle lines.
/**
* This muti-line comment contains some
* *non-standard bold* syntax
*/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"allowWhitespace":false}]
// Message: Should be no multiple asterisks on middle lines.
/** Desc. **/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"allowWhitespace":true}]
// Message: Should be no multiple asterisks on end lines.The following patterns are not considered problems:
/**
*
* Desc. ***
*/
/**
* Desc. ***
*
*/
/**
* Desc.
*
* sth */
/**
**
*
*/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"preventAtMiddleLines":false}]
/**
*
*
**/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"preventAtEnd":false}]
/**
* With a desc.
* and ***
*/
/**
* and ***
* With a desc.
*/
/**
* With a desc.
* With a desc.
* Desc. */
/**
* With a description
* @tag {SomeType} and a tag with details
*
*/
/** abc */
function foo() {
//
}
/** foo */
function foo(): void {
//
}
/** @aTag abc */
function foo() {
//
}
/**
* **Bold**
*/
/**
* Preserve user's bold statement when fixing.
*
* **Bold example:** Hi there.
*/
/**
* The method does 2 things:
* * Thing 1
* * Thing 2
*/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"allowWhitespace":true}]
/**
* This muti-line comment contains some
* *non-standard bold* syntax
*/
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"allowWhitespace":true}]
/** abc */
function foo() {
//
}
// "jsdoc/no-multi-asterisks": ["error"|"warn", {"allowWhitespace":true}]