@stylistic/

line-comment-position

行コメントは、コードの上または横に配置できます。このルールは、チームが一貫したスタイルを維持するのに役立ちます。

// above comment
var foo = "bar";  // beside comment

ルールの詳細

このルールは、行コメントの一貫した位置を強制します。ブロックコメントはこのルールの影響を受けません。デフォルトでは、このルールは、次の単語で始まるコメントを無視します: eslint, jshint, jslint, istanbul, global, exported, jscs, falls through。

オプション

このルールは、文字列またはオブジェクトのいずれかの引数を1つ取ります。文字列の設定は、positionプロパティ（下記参照）と同じです。オブジェクトオプションには、次のプロパティがあります。

position

positionオプションには、2つの設定があります。

• above (デフォルト) は、コードの上の行にのみ、行コメントを強制します。
• beside は、コード行の末尾にのみ、行コメントを強制します。

position: above

{ "position": "above" } オプションに対する正しいコードの例

/*eslint @stylistic/line-comment-position: ["error", { "position": "above" }]*/
// valid comment
1 + 1;

正しい

{ "position": "above" } オプションに対する誤ったコードの例

/*eslint @stylistic/line-comment-position: ["error", { "position": "above" }]*/
1 + 1; 
// invalid comment

誤り

position: beside

{ "position": "beside" } オプションに対する正しいコードの例

/*eslint @stylistic/line-comment-position: ["error", { "position": "beside" }]*/
1 + 1; // valid comment

正しい

{ "position": "beside" } オプションに対する誤ったコードの例

/*eslint @stylistic/line-comment-position: ["error", { "position": "beside" }]*/
// invalid comment
1 + 1;

誤り

ignorePattern

デフォルトでは、このルールは、次の単語で始まるコメントを無視します: eslint, jshint, jslint, istanbul, global, exported, jscs, falls through。代替の正規表現を指定できます。

ignorePattern オプションに対する正しいコードの例

/*eslint @stylistic/line-comment-position: ["error", { "ignorePattern": "pragma" }]*/
1 + 1; // pragma valid comment

正しい

ignorePattern オプションに対する誤ったコードの例

/*eslint @stylistic/line-comment-position: ["error", { "ignorePattern": "pragma" }]*/
1 + 1; 
// invalid comment

誤り

applyDefaultIgnorePatterns

ignorePattern が指定されている場合でも、デフォルトの無視パターンが適用されます。デフォルトのパターンを省略する場合は、このオプションを false に設定します。

{ "applyDefaultIgnorePatterns": false } オプションに対する正しいコードの例

/*eslint @stylistic/line-comment-position: ["error", { "ignorePattern": "pragma", "applyDefaultIgnorePatterns": false }]*/
1 + 1; // pragma valid comment

正しい

{ "applyDefaultIgnorePatterns": false } オプションに対する誤ったコードの例

/*eslint @stylistic/line-comment-position: ["error", { "ignorePattern": "pragma", "applyDefaultIgnorePatterns": false }]*/
1 + 1; 
// falls through

誤り

非推奨: オブジェクトプロパティ applyDefaultPatterns は非推奨です。代わりにプロパティ applyDefaultIgnorePatterns を使用してください。

使用しない場合

さまざまな行コメントスタイルを持つことを気にしない場合は、このルールをオフにできます。

互換性

JSCS: validateCommentPosition