# rest-spread-spacing

在 rest 和 spread 运算符及其表达式之间强制执行间距

一些该规则报告的问题可以通过 --fix 命令行选项自动修复

ES2015 引入了 rest 和 spread 运算符，它们将可迭代的结构扩展到其各个部分。它们的一些用法示例如下：

let numArr = [1, 2, 3];
function add(a, b, c) {
    return a + b + c;
}
add(...numArr); // -> 6

let arr1 = [1, 2, 3];
let arr2 = [4, 5, 6];
arr1.push(...arr2); // -> [1, 2, 3, 4, 5, 6]

let [a, b, ...arr] = [1, 2, 3, 4, 5];
a; // -> 1
b // -> 2
arr; // ->  [3, 4, 5]

function numArgs(...args) {
  return args.length;
}
numArgs(a, b, c); // -> 3

除了上述之外，目前还有一个提议是在规范中添加 object rest 和 spread 属性。它们可以按如下方式使用：


let { x, y, ...z } = { x: 1, y: 2, a: 3, b: 4 };
x; // -> 1
y; // -> 2
z; // -> { a: 3, b: 4 }

let n = { x, y, ...z };
n; // -> { x: 1, y: 2, a: 3, b: 4 }

与其他运算符一样，rest 或 spread 运算符与它所操作的表达式之间允许有空格，这可能导致代码库中的间距不一致。

# 规则详情

这条规则的目的是在 rest 和 spread 运算符及其表达式之间强制执行一致的间距。该规则还支持 ES2018 中的 object rest 和 spread 属性：

{
    "parserOptions": {
        "ecmaVersion": 2018
    }
}

请阅读用户指南中关于 配置解析器选项 的部分以了解更多信息。

# 选项

此规则采用一个选项：值为 "never" 或 "always" 的字符串。默认值为 "never"。

# "never"

使用默认 "never" 选项时，展开运算符及其表达式之间不允许有空格。

rest-spread-spacing: ["error"]

或

rest-spread-spacing: ["error", "never"]

"never" 此规则的错误代码示例：

/*eslint rest-spread-spacing: ["error", "never"]*/

fn(... args)
[... arr, 4, 5, 6]
let [a, b, ... arr] = [1, 2, 3, 4, 5];
function fn(... args) { console.log(args); }
let { x, y, ... z } = { x: 1, y: 2, a: 3, b: 4 };
let n = { x, y, ... z };

此规则的正确代码示例（带有 "never"）：

/*eslint rest-spread-spacing: ["error", "never"]*/

fn(...args)
[...arr, 4, 5, 6]
let [a, b, ...arr] = [1, 2, 3, 4, 5];
function fn(...args) { console.log(args); }
let { x, y, ...z } = { x: 1, y: 2, a: 3, b: 4 };
let n = { x, y, ...z };

# "always"

使用 "always" 选项时，扩展运算符及其表达式之间需要空格。

rest-spread-spacing: ["error", "always"]

"always" 此规则的错误代码示例：

/*eslint rest-spread-spacing:["error", "always"]*/

fn(...args)
[...arr, 4, 5, 6]
let [a, b, ...arr] = [1, 2, 3, 4, 5];
function fn(...args) { console.log(args); }
let { x, y, ...z } = { x: 1, y: 2, a: 3, b: 4 };
let n = { x, y, ...z };

此规则的正确代码示例（带有 "always"）：

/*eslint rest-spread-spacing: ["error", "always"]*/

fn(... args)
[... arr, 4, 5, 6]
let [a, b, ... arr] = [1, 2, 3, 4, 5];
function fn(... args) { console.log(args); }
let { x, y, ... z } = { x: 1, y: 2, a: 3, b: 4 };
let n = { x, y, ... z };

# 何时不使用

如果您不关心在展开运算符及其表达式之间强制保持一致的间距，则可以安全地禁用此规则。

← quotes semi →