no-else-return

禁止 if 语句中的 return 语句之后的 else 块

如果 if 块包含 return 语句，则 else 块变得不必要。它的内容可以放在块之外。

¥If an if block contains a return statement, the else block becomes unnecessary. Its contents can be placed outside of the block.

function foo() {
    if (x) {
        return y;
    } else {
        return z;
    }
}
1
2
3
4
5
6
7

规则详情

¥Rule Details

此规则旨在高亮包含 return 语句的 if 之后的不必要的代码块。因此，当遇到 else 跟在一系列 if 后面（所有这些都包含 return 语句）时，它会触发警告。

¥This rule is aimed at highlighting an unnecessary block of code following an if containing a return statement. As such, it will warn when it encounters an else following a chain of ifs, all of them containing a return statement.

选项

¥Options

此规则有一个对象选项：

¥This rule has an object option:

• allowElseIf: true（默认）在返回后允许 else if 块

  ¥allowElseIf: true (default) allows else if blocks after a return

• 返回后 allowElseIf: false 不允许 else if 块

  ¥allowElseIf: false disallows else if blocks after a return

allowElseIf：true

此规则的错误代码示例：

¥Examples of incorrect code for this rule:

/*eslint no-else-return: "error"*/

function foo1() {
    if (x) {
        return y;
    } else {
        return z;
    }
}

function foo2() {
    if (x) {
        return y;
    } else if (z) {
        return w;
    } else {
        return t;
    }
}

function foo3() {
    if (x) {
        return y;
    } else {
        var t = "foo";
    }

    return t;
}

function foo4() {
    if (error) {
        return 'It failed';
    } else {
        if (loading) {
            return "It's still loading";
        }
    }
}

// Two warnings for nested occurrences
function foo5() {
    if (x) {
        if (y) {
            return y;
        } else {
            return x;
        }
    } else {
        return z;
    }
}
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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

此规则的正确代码示例：

¥Examples of correct code for this rule:

/*eslint no-else-return: "error"*/

function foo1() {
    if (x) {
        return y;
    }

    return z;
}

function foo2() {
    if (x) {
        return y;
    } else if (z) {
        var t = "foo";
    } else {
        return w;
    }
}

function foo3() {
    if (x) {
        if (z) {
            return y;
        }
    } else {
        return z;
    }
}

function foo4() {
    if (error) {
        return 'It failed';
    } else if (loading) {
        return "It's still loading";
    }
}
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
26
27
28
29
30
31
32
33
34
35
36
37

allowElseIf：false

此规则的错误代码示例：

¥Examples of incorrect code for this rule:

/*eslint no-else-return: ["error", {allowElseIf: false}]*/

function foo() {
    if (error) {
        return 'It failed';
    } else if (loading) {
        return "It's still loading";
    }
}
1
2
3
4
5
6
7
8
9

此规则的正确代码示例：

¥Examples of correct code for this rule:

/*eslint no-else-return: ["error", {allowElseIf: false}]*/

function foo() {
    if (error) {
        return 'It failed';
    }

    if (loading) {
        return "It's still loading";
    }
}
1
2
3
4
5
6
7
8
9
10
11

版本

此规则是在 ESLint v0.0.9 中引入。

资源

• 规则源码
• 测试源码