no-inline-comments

Запрещает встроенные комментарии после кода

Некоторые руководства по стилю запрещают комментарии в той же строке, что и код. Код может быть сложно читать, если комментарии сразу следуют за ним в той же строке. С другой стороны, иногда быстрее и нагляднее размещать комментарии сразу после кода.

Подробности правила

Это правило запрещает комментарии в той же строке, что и код.

Примеры неправильного кода для этого правила:

/*eslint no-inline-comments: "error"*/

const a = 1; // declaring a to 1

function getRandomNumber(){
    return 4; // chosen by fair dice roll.
              // guaranteed to be random.
}

/* A block comment before code */ const b = 2;

const c = 3; /* A block comment after code */

Примеры правильного кода для этого правила:

/*eslint no-inline-comments: "error"*/

// This is a comment above a line of code
const foo = 5;

const bar = 5;
//This is a comment below a line of code

Исключение для JSX

Комментарии внутри фигурных скобок в JSX могут находиться в той же строке, что и скобки, но только если в этой строке нет другого кода и скобки не охватывают реальное выражение.

Примеры неправильного кода для этого правила:

/*eslint no-inline-comments: "error"*/

const foo = <div>{ /* On the same line with other code */ }<h1>Some heading</h1></div>;

const bar = (
    <div>{   // These braces are not just for the comment, so it can't be on the same line
        baz
    }</div>
);

Примеры правильного кода для этого правила:

/*eslint no-inline-comments: "error"*/

const foo = (
    <div>{/* These braces are just for this comment and there is nothing else on this line */}<h1>Some heading</h1></div>
)

const bar = (
    <div>{
        // There is nothing else on this line
        baz
    }</div>
);

const quux = (
    <div>{/*
        Multiline
        comment
      */}<h1>Some heading</h1></div>
)

Параметры

ignorePattern

Чтобы это правило игнорировало определённые комментарии, задайте для параметра ignorePattern строковый шаблон, который будет передан конструктору RegExp.

Примеры правильного кода для параметра ignorePattern:

/*eslint no-inline-comments: ["error", { "ignorePattern": "webpackChunkName:\\s.+" }]*/

import(/* webpackChunkName: "my-chunk-name" */ './locale/en');

Примеры неправильного кода для параметра ignorePattern:

/*eslint no-inline-comments: ["error", { "ignorePattern": "something" }] */

const foo = 4; // other thing

Версия

Это правило появилось в ESLint v0.10.0.

Ресурсы

• Исходный код правила
• Исходный код тестов