@stylistic/js/

array-element-newline

多くのスタイルガイドでは、配列要素間の改行が必要または禁止されています。

ルールの詳細

このルールは、配列要素間の改行を強制します。

オプション

このルールには、文字列オプションがあります

• "always" (デフォルト) は、配列要素間の改行を必須とします
• "never" は、配列要素間の改行を禁止します
• "consistent" は、配列要素間の改行の使用法を一貫させることを必須とします

または、オブジェクトオプションがあります (いずれかのプロパティが満たされている場合、改行が必要です。そうでない場合は、改行は禁止されます)

• "multiline": <boolean> 要素内に改行がある場合、改行を必須とします。false の場合、この条件は無効になります。
• "minItems": <number> 要素数が指定された整数以上の場合、改行を必須とします。0 の場合、この条件はオプション "always" と同じように動作します。null (デフォルト) の場合、この条件は無効になります。

または、配列式と配列パターンに対して異なる設定を指定できます

{
    "array-element-newline": ["error", {
        "ArrayExpression": "consistent",
        "ArrayPattern": { "minItems": 3 },
    }]
}

• "ArrayExpression" 配列式の設定 (指定しない場合、このルールは配列式に適用されません)
• "ArrayPattern" 分割代入の配列パターンの設定 (指定しない場合、このルールは配列パターンに適用されません)

always

デフォルトの "always" オプションでこのルールに違反するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", "always"]*/

var c = [1,
 
2];
var d = [1,
 
2,
 
3];
var e = [1,
 
2,
 
3
];
var f = [
  1,
 
2,
 
3
];
var g = [
    function foo() {
        dosomething();
    },
 
function bar() {
        dosomething();
    }
];

誤り

デフォルトの "always" オプションでこのルールに準拠するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", "always"]*/

var a = [];
var b = [1];
var c = [1,
    2];
var d = [1,
    2,
    3];
var d = [
  1,
  2,
  3
];
var e = [
    function foo() {
        dosomething();
    },
    function bar() {
        dosomething();
    }
];

正しい

never

"never" オプションでこのルールに違反するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", "never"]*/

var c = [
    1,

        2
];
var d = [
    1,

        2,

        3
];
var e = [
    function foo() {
        dosomething();
    },

        function bar() {
        dosomething();
    }
];

誤り

"never" オプションでこのルールに準拠するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", "never"]*/

var a = [];
var b = [1];
var c = [1, 2];
var d = [1, 2, 3];
var e = [
    1, 2, 3];
var f = [
  1, 2, 3
];
var g = [
    function foo() {
        dosomething();
    }, function bar() {
        dosomething();
    }
];

正しい

consistent

"consistent" オプションでこのルールに違反するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", "consistent"]*/

var a = [
    1,
 
2,
    3
];
var b = [
    function foo() {
        dosomething();
    },
 
function bar() {
        dosomething();
    },
    function baz() {
        dosomething();
    }
];

誤り

"consistent" オプションでこのルールに準拠するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", "consistent"]*/

var a = [];
var b = [1];
var c = [1, 2];
var d = [1, 2, 3];
var e = [
    1,
    2
];
var f = [
    1,
    2,
    3
];
var g = [
    function foo() {
        dosomething();
    }, function bar() {
        dosomething();
    }, function baz() {
        dosomething();
    }
];
var h = [
    function foo() {
        dosomething();
    },
    function bar() {
        dosomething();
    },
    function baz() {
        dosomething();
    }
];

正しい

multiline

{ "multiline": true } オプションでこのルールに違反するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", { "multiline": true }]*/

var d = [1,

        2, 3];
var e = [
    function foo() {
        dosomething();
    },
 
function bar() {
        dosomething();
    }
];

誤り

{ "multiline": true } オプションでこのルールに準拠するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", { "multiline": true }]*/

var a = [];
var b = [1];
var c = [1, 2];
var d = [1, 2, 3];
var e = [
    function foo() {
        dosomething();
    },
    function bar() {
        dosomething();
    }
];

正しい

minItems

{ "minItems": 3 } オプションでこのルールに違反するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", { "minItems": 3 }]*/

var c = [1,

        2];
var d = [1,
 
2,
 
3];
var e = [
    function foo() {
        dosomething();
    },

        function bar() {
        dosomething();
    }
];

誤り

{ "minItems": 3 } オプションでこのルールに準拠するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", { "minItems": 3 }]*/

var a = [];
var b = [1];
var c = [1, 2];
var d = [1,
    2,
    3];
var e = [
    function foo() {
        dosomething();
    }, function bar() {
        dosomething();
    }
];

正しい

multiline and minItems

{ "multiline": true, "minItems": 3 } オプションでこのルールに違反するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", { "multiline": true, "minItems": 3 }]*/

var c = [1,

2];
var d = [1,
 
2,
 
3];
var e = [
    function foo() {
        dosomething();
    },
 
function bar() {
        dosomething();
    }
];

誤り

{ "multiline": true, "minItems": 3 } オプションでこのルールに準拠するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", { "multiline": true, "minItems": 3 }]*/

var a = [];
var b = [1];
var c = [1, 2];
var d = [1,
    2,
    3];
var e = [
    function foo() {
        dosomething();
    },
    function bar() {
        dosomething();
    }
];

正しい

ArrayExpression and ArrayPattern

{ "ArrayExpression": "always", "ArrayPattern": "never" } オプションでこのルールに違反するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", { "ArrayExpression": "always", "ArrayPattern": "never" }]*/

var a = [1,
 
2];
var b = [1,
 
2,
 
3];
var c = [
    function foo() {
        dosomething();
    },
 
function bar() {
        dosomething();
    }
];

var [d,

        e] = arr;
var [f,

        g,

        h] = arr;
var [i = function foo() {
  dosomething()
},

j = function bar() {
  dosomething()
}] = arr

誤り

{ "ArrayExpression": "always", "ArrayPattern": "never" } オプションでこのルールに準拠するコードの例

/*eslint @stylistic/js/array-element-newline: ["error", { "ArrayExpression": "always", "ArrayPattern": "never" }]*/

var a = [1,
    2];
var b = [1,
    2,
    3];
var c = [
    function foo() {
        dosomething();
    },
    function bar() {
        dosomething();
    }
];

var [d, e] = arr
var [f, g, h] = arr
var [i = function foo() {
    dosomething()
}, j = function bar() {
    dosomething()
}] = arr

正しい

使用しない場合

配列要素間の改行を強制したくない場合は、このルールを有効にしないでください。

互換性

• **JSCS:** validateNewlineAfterArrayElements