no-unused-expressions

禁止未使用表达式

一个对程序状态没有影响的未使用表达式表明存在逻辑错误。

例如，n + 1; 不是语法错误，但可能是程序员在输入时将赋值语句 n += 1; 误写成了表达式。有时，此类未使用表达式可能会在生产环境中被某些构建工具消除，这可能会破坏应用程序逻辑。

规则详情

此规则旨在消除对程序状态没有影响的未使用表达式。

此规则不适用于函数调用或使用 new 运算符的构造函数调用，因为它们可能会对程序状态产生副作用。

var i = 0;
function increment() { i += 1; }
increment(); // return value is unused, but i changed as a side effect

var nThings = 0;
function Thing() { nThings += 1; }
new Thing(); // constructed object is unused, but nThings changed as a side effect
1
2
3
4
5
6
7

此规则不适用于指令（指令以字面量字符串表达式的形式出现，例如脚本、模块或函数开头的 "use strict";）。

序列表达式（使用逗号的表达式，例如 a = 1, b = 2）始终被视为未使用，除非其返回值被赋值或用于条件评估，或者使用序列表达式的值进行函数调用。

选项

此规则在其默认状态下不需要任何参数。如果您想启用以下一个或多个选项，您可以传递一个对象，并将选项设置为如下所示：

将 allowShortCircuit 设置为 true 将允许您在表达式中使用短路求值（默认值：false）。
将 allowTernary 设置为 true 将允许您在表达式中使用三元运算符，类似于短路求值（默认值：false）。
将 allowTaggedTemplates 设置为 true 将允许您在表达式中使用标记模板字面量（默认值：false）。
将 enforceForJSX 设置为 true 将标记未使用的 JSX 元素表达式（默认值：false）。

这些选项仅在所有代码路径都直接更改状态（例如，赋值语句）或可能产生副作用（例如，函数调用）时才允许未使用表达式。

对于默认的 { "allowShortCircuit": false, "allowTernary": false } 选项，错误代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: "error"*/

0

if(0) 0

{0}

f(0), {}

a && b()

a, b()

c = a, b;

a() && function namedFunctionInExpressionContext () {f();}

(function anIncompleteIIFE () {});

injectGlobal`body{ color: red; }`

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

对于默认的 { "allowShortCircuit": false, "allowTernary": false } 选项，正确代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: "error"*/

{} // In this context, this is a block statement, not an object literal

{ myLabel: foo() } // In this context, this is a block statement with a label and expression, not an object literal

function namedFunctionDeclaration () {}

(function aGenuineIIFE () {}());

f()

a = 0

new C

delete a.b

void a
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

请注意，一个或多个字符串表达式语句（有或没有分号）仅在它们不在脚本、模块或函数的开头（单独且不受其他语句干扰）时才会被视为未使用。否则，它们将被视为“指令序言”的一部分，指令序言是 JavaScript 引擎可能使用的部分。这包括“严格模式”指令。

关于指令，此规则的正确代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: "error"*/

"use strict";
"use asm"
"use stricter";
"use babel"
"any other strings like this in the directive prologue";
"this is still the directive prologue";

function foo() {
    "bar";
}

class Foo {
    someMethod() {
        "use strict";
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

关于指令，此规则的错误代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: "error"*/

doSomething();
"use strict"; // this isn't in a directive prologue, because there is a non-directive statement before it

function foo() {
    "bar" + 1;
}

class Foo {
    static {
        "use strict"; // class static blocks do not have directive prologues
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

allowShortCircuit

对于 { "allowShortCircuit": true } 选项，错误代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "allowShortCircuit": true }]*/

a || b
1
2
3

对于 { "allowShortCircuit": true } 选项，正确代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "allowShortCircuit": true }]*/

a && b()
a() || (b = c)
1
2
3
4

allowTernary

对于 { "allowTernary": true } 选项，错误代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "allowTernary": true }]*/

a ? b : 0
a ? b : c()
1
2
3
4

对于 { "allowTernary": true } 选项，正确代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "allowTernary": true }]*/

a ? b() : c()
a ? (b = c) : d()
1
2
3
4

allowShortCircuit 和 allowTernary

对于 { "allowShortCircuit": true, "allowTernary": true } 选项，正确代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "allowShortCircuit": true, "allowTernary": true }]*/

a ? b() || (c = d) : e()
1
2
3

allowTaggedTemplates

对于 { "allowTaggedTemplates": true } 选项，错误代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "allowTaggedTemplates": true }]*/

`some untagged template string`;
1
2
3

对于 { "allowTaggedTemplates": true } 选项，正确代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "allowTaggedTemplates": true }]*/

tag`some tagged template string`;
1
2
3

enforceForJSX

JSX 最常用于 React 生态系统，在该生态系统中，它被编译为 React.createElement 表达式。虽然没有副作用，但 no-unused-expression 规则不会自动标记这些调用。如果您正在使用 React 或任何其他无副作用的 JSX 预处理程序，可以启用此选项来标记这些表达式。

对于 { "enforceForJSX": true } 选项，错误代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "enforceForJSX": true }]*/

<MyComponent />;

<></>;
1
2
3
4
5

对于 { "enforceForJSX": true } 选项，正确代码示例

在代码游乐场中打开

/*eslint no-unused-expressions: ["error", { "enforceForJSX": true }]*/

var myComponentPartial = <MyComponent />;

var myFragment = <></>;
1
2
3
4
5

版本

此规则在 ESLint v0.1.0 中引入。

资源

编辑此页面