arrow-body-style

要求箭头函数体周围使用大括号

🔧

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

❄️

此规则目前处于冻结状态，不接受功能请求。

箭头函数对于函数体有两种语法形式。它们可以用块体（用花括号表示） () => { ... } 定义，或者用单个表达式 () => ... 定义，其值被隐式返回。

规则详情

此规则可以强制或禁止在箭头函数体周围使用大括号。

选项

该规则接受一个或两个选项。第一个是字符串，可以是

"always" 强制函数体周围使用大括号
"as-needed" 强制在可以省略大括号的地方不使用（默认）
"never" 强制函数体周围不使用大括号（将箭头函数限制为返回表达式的角色）

第二个是对象，用于在第一个选项为 "as-needed" 时进行更细粒度的配置。目前，唯一可用的选项是 requireReturnForObjectLiteral，一个布尔属性。默认值为 false。如果设置为 true，则它要求对象字面量使用大括号和显式返回。

"arrow-body-style": ["error", "always"]
1

always

使用 "always" 选项时，不正确 代码示例

在 Playground 中打开

/*eslint arrow-body-style: ["error", "always"]*/

const foo = () => 0;
1
2
3

使用 "always" 选项时，正确代码示例

在 Playground 中打开

/*eslint arrow-body-style: ["error", "always"]*/

const foo = () => {
    return 0;
};

const bar = (retv, name) => {
    retv[name] = true;
    return retv;
};
1
2
3
4
5
6
7
8
9
10

as-needed

使用默认 "as-needed" 选项时，不正确 代码示例

在 Playground 中打开

/*eslint arrow-body-style: ["error", "as-needed"]*/

const foo = () => {
    return 0;
};

const bar = () => {
    return {
       bar: {
            foo: 1,
            bar: 2,
        }
    };
};
1
2
3
4
5
6
7
8
9
10
11
12
13
14

使用默认 "as-needed" 选项时，正确代码示例

在 Playground 中打开

/*eslint arrow-body-style: ["error", "as-needed"]*/

const foo1 = () => 0;

const foo2 = (retv, name) => {
    retv[name] = true;
    return retv;
};

const foo3 = () => ({
    bar: {
        foo: 1,
        bar: 2,
    }
});

const foo4 = () => { bar(); };
const foo5 = () => {};
const foo6 = () => { /* do nothing */ };

const foo7 = () => {
    // do nothing.
};

const foo8 = () => ({ bar: 0 });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

requireReturnForObjectLiteral

此选项仅在与 "as-needed" 选项结合使用时适用。

使用 { "requireReturnForObjectLiteral": true } 选项时，不正确 代码示例

在 Playground 中打开

/*eslint arrow-body-style: ["error", "as-needed", { "requireReturnForObjectLiteral": true }]*/

const foo = () => ({});

const bar = () => ({ bar: 0 });
1
2
3
4
5

使用 { "requireReturnForObjectLiteral": true } 选项时，正确代码示例

在 Playground 中打开

/*eslint arrow-body-style: ["error", "as-needed", { "requireReturnForObjectLiteral": true }]*/

const foo = () => {};

const bar = () => { return { bar: 0 }; };
1
2
3
4
5

never

使用 "never" 选项时，不正确 代码示例

在 Playground 中打开

/*eslint arrow-body-style: ["error", "never"]*/

const foo = () => {
    return 0;
};

const bar = (retv, name) => {
    retv[name] = true;
    return retv;
};
1
2
3
4
5
6
7
8
9
10

使用 "never" 选项时，正确代码示例

在 Playground 中打开

/*eslint arrow-body-style: ["error", "never"]*/

const foo = () => 0;

const bar = () => ({ foo: 0 });
1
2
3
4
5

版本

此规则在 ESLint v1.8.0 中引入。

资源

编辑此页