no-unused-expressions

禁用未使用的表达式

未使用的表达式如果对程序状态没有影响，则表示逻辑错误。

例如，n + 1; 不是语法错误，但它可能是程序员打算使用赋值语句 n += 1; 的输入错误。有时，这种未使用的表达式可能会被生产环境中的一些构建工具消除，这可能会破坏应用程序逻辑。

规则详情

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

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

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

let 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 }]*/

const myComponentPartial = <MyComponent />;

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

版本

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

资源

• 规则来源
• 测试来源