# 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
此规则不适用于指令(以字面字符串表达式的形式,例如脚本、模块或函数开头的 "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; }`
默认 { "allowShortCircuit": false, "allowTernary": false }
选项的正确代码示例:
/*eslint no-unused-expressions: "error"*/
{} // In this context, this is a block statement, not an object literal
{myLabel: someVar} // 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
请注意,一个或多个字符串表达式语句(带或不带分号)只有在它们不在脚本、模块或函数的开头(单独且不受其他语句中断)时才会被视为未使用。否则,它们将被视为 "directive prologue" 的一部分,这是 JavaScript 引擎可能使用的部分。这包括 "strict mode" 指令。
此规则关于指令的正确代码示例:
/*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";
}
}
此规则与指令有关的错误代码示例:
/*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
}
}
# allowShortCircuit
{ "allowShortCircuit": true }
选项的错误代码示例:
/*eslint no-unused-expressions: ["error", { "allowShortCircuit": true }]*/
a || b
{ "allowShortCircuit": true }
选项的正确代码示例:
/*eslint no-unused-expressions: ["error", { "allowShortCircuit": true }]*/
a && b()
a() || (b = c)
# allowTernary
{ "allowTernary": true }
选项的错误代码示例:
/*eslint no-unused-expressions: ["error", { "allowTernary": true }]*/
a ? b : 0
a ? b : c()
{ "allowTernary": true }
选项的正确代码示例:
/*eslint no-unused-expressions: ["error", { "allowTernary": true }]*/
a ? b() : c()
a ? (b = c) : d()
# allowShortCircuit 和 allowTernary
{ "allowShortCircuit": true, "allowTernary": true }
选项的正确代码示例:
/*eslint no-unused-expressions: ["error", { "allowShortCircuit": true, "allowTernary": true }]*/
a ? b() || (c = d) : e()
# allowTaggedTemplates
{ "allowTaggedTemplates": true }
选项的错误代码示例:
/*eslint no-unused-expressions: ["error", { "allowTaggedTemplates": true }]*/
`some untagged template string`;
{ "allowTaggedTemplates": true }
选项的正确代码示例:
/*eslint no-unused-expressions: ["error", { "allowTaggedTemplates": true }]*/
tag`some tagged template string`;
# enforceForJSX
JSX 最常用于 React 生态系统,它被编译为 React.createElement
表达式。虽然没有副作用,但这些调用不会被 no-unused-expression
规则自动标记。如果您使用 React 或任何其他无副作用的 JSX pragma,则可以启用此选项来标记这些表达式。
{ "enforceForJSX": true }
选项的错误代码示例:
/*eslint no-unused-expressions: ["error", { "enforceForJSX": true }]*/
<MyComponent />;
<></>;
{ "enforceForJSX": true }
选项的正确代码示例:
/*eslint no-unused-expressions: ["error", { "enforceForJSX": true }]*/
var myComponentPartial = <MyComponent />;
var myFragment = <></>;