Eslint参考手册
规则 | Rules
array-bracket-spacing
在--fix
命令行上的选项可以自动修复一些被这条规则反映的问题。
许多样式指南需要或不允许阵列括号和其他标记之间的空格。此规则适用于数组文字和解构赋值(ECMAScript 6)。
/*eslint-env es6*/
var arr = [ 'foo', 'bar' ];
var [ x, y ] = z;
var arr = ['foo', 'bar'];
var [x,y] = z;
规则细节
该规则在数组括号内强制实现一致的间距。
选项
这条规则有字符串选项:
-
"never"
(默认)不允许数组括号内的空格
-
"always"
在数组括号内需要一个或多个空格或换行符
该规则有一个"never
对象选项,用于选项的例外情况"
:
-
"singleValue": true
需要包含单个元素的数组文字,括号内的一个或多个空格或换行符
-
"objectsInArrays": true
需要数组文本的括号和它们的对象文本元素的支架之间的一个或多个空格或换行符[ {
或} ]
-
"arraysInArrays": true
需要数组文本的括号和它们的数组文本元素的括号之间的一个或多个空格或换行符[ [or] ]
此规则有一个对象选项,用于"always"
选项的例外情况:
-
"singleValue": false
不允许包含单个元素的数组文字的括号内的空格
-
"objectsInArrays": false
不允许数组文字的括号和其对象文字元素[{
or}]
-
"arraysInArrays": false
不允许数组文本的括号和它们的数组文本元素的括号之间的空间[[
or]]
规则具有内置的例外情况:
-
"never"
(以及"always"
选项的例外)允许在数组括号内换行,因为这是一种常见模式
-
"always"
在空数组文字中不需要空格或换行符[]
never
"never"
规则的默认错误代码示例:
/*eslint array-bracket-spacing: ["error", "never"]*/
/*eslint-env es6*/
var arr = [ 'foo', 'bar' ];
var arr = ['foo', 'bar' ];
var arr = [ ['foo'], 'bar'];
var arr = [[ 'foo' ], 'bar'];
var arr = [ 'foo',
'bar'
];
var [ x, y ] = z;
var [ x,y ] = z;
var [ x, ...y ] = z;
var [ ,,x, ] = z;
具有默认"never"
选项的此规则的正确代码示例:
/*eslint array-bracket-spacing: ["error", "never"]*/
/*eslint-env es6*/
var arr = [];
var arr = ['foo', 'bar', 'baz'];
var arr = [['foo'], 'bar', 'baz'];
var arr = [
'foo',
'bar',
'baz'
];
var arr = ['foo',
'bar'
];
var arr = [
'foo',
'bar'];
var [x, y] = z;
var [x,y] = z;
var [x, ...y] = z;
var [,,x,] = z;
always
"always"
规则的错误代码示例包含以下选项:
/*eslint array-bracket-spacing: ["error", "always"]*/
/*eslint-env es6*/
var arr = ['foo', 'bar'];
var arr = ['foo', 'bar' ];
var arr = [ ['foo'], 'bar' ];
var arr = ['foo',
'bar'
];
var arr = [
'foo',
'bar'];
var [x, y] = z;
var [x,y] = z;
var [x, ...y] = z;
var [,,x,] = z;
"always"
规则的正确代码示例包含以下"always"
选项:
/*eslint array-bracket-spacing: ["error", "always"]*/
/*eslint-env es6*/
var arr = [];
var arr = [ 'foo', 'bar', 'baz' ];
var arr = [ [ 'foo' ], 'bar', 'baz' ];
var arr = [ 'foo',
'bar'
];
var arr = [
'foo',
'bar' ];
var arr = [
'foo',
'bar',
'baz'
];
var [ x, y ] = z;
var [ x,y ] = z;
var [ x, ...y ] = z;
var [ ,,x, ] = z;
singleValue
"always", { "singleValue": false
规则的错误代码示例如下:
/*eslint array-bracket-spacing: ["error", "always", { "singleValue": false }]*/
var foo = [ 'foo' ];
var foo = [ 'foo'];
var foo = ['foo' ];
var foo = [ 1 ];
var foo = [ 1];
var foo = [1 ];
var foo = [ [ 1, 2 ] ];
var foo = [ { 'foo': 'bar' } ];
"always", { "singleValue": false }
规则的正确代码示例包含以下选项:
/*eslint array-bracket-spacing: ["error", "always", { "singleValue": false }]*/
var foo = ['foo'];
var foo = [1];
var foo = [[ 1, 1 ]];
var foo = [{ 'foo': 'bar' }];
objectsInArrays
"always", { "objectsInArrays": false }
规则的错误代码示例如下:
/*eslint array-bracket-spacing: ["error", "always", { "objectsInArrays": false }]*/
var arr = [ { 'foo': 'bar' } ];
var arr = [ {
'foo': 'bar'
} ]
"always", { "objectsInArrays": false }
规则的正确代码示例包含以下选项:
/*eslint array-bracket-spacing: ["error", "always", { "objectsInArrays": false }]*/
var arr = [{ 'foo': 'bar' }];
var arr = [{
'foo': 'bar'
}];
arraysInArrays
"always", { "arraysInArrays": false }
规则的代码错误代码示例如下:
/*eslint array-bracket-spacing: ["error", "always", { "arraysInArrays": false }]*/
var arr = [ [ 1, 2 ], 2, 3, 4 ];
var arr = [ [ 1, 2 ], 2, [ 3, 4 ] ];
"always", { "arraysInArrays": false }
规则的正确代码示例包含以下选项:
/*eslint array-bracket-spacing: ["error", "always", { "arraysInArrays": false }]*/
var arr = [[ 1, 2 ], 2, 3, 4 ];
var arr = [[ 1, 2 ], 2, [ 3, 4 ]];
何时不使用它
如果您不关心数组括号之间的间距的一致性,则可以关闭此规则。
相关规则
- space-in-parens
- object-curly-spacing
- computed-property-spacing
版本
该规则在ESLint 0.24.0中引入。
资源
- Rule source
- Documentation source
规则 | Rules相关
ESLint 是一个代码规范和错误检查工具,有以下几个特性。所有东西都是可以插拔的。你可以调用任意的 rule api 或者 formatter api 去打包或者定义 rule or formatter。任意的 rule 都是独立的。没有特定的 coding style,你可以自己配置。
主页 | https://eslint.org/ |
源码 | https://github.com/eslint/eslint |
发布版本 | 4.12.0 |