Eslint参考手册
规则 | Rules
no-return-assign
JavaScript 的一个有趣的,有时令人困惑的方面是,任务几乎都可以发生。因此,当真正的意图进行比较时,错误的等号可能最终导致分配。使用return
陈述时尤其如此。例如:
function doSomething() {
return foo = bar + 2;
}
这里很难说出return
陈述的意图。函数有可能返回结果bar + 2
,但为什么要赋值foo
?也有可能意图是使用比较运算符,比如==
这个代码是一个错误。
由于含糊不清,在return
报表中不使用赋值被认为是最佳做法。
规则细节
这条规则旨在消除return
陈述中的任务。因此,无论何时发现作业的一部分,它都会发出警告return
。
选项
该规则采用一个选项,一个字符串,它必须包含以下值之一:
-
except-parens
(默认):除非用圆括号括起来,否则不允许赋值。
-
always
:禁止所有分配。
except-parens
这是默认选项。它不允许分配,除非它们被括在圆括号中。
默认"except-parens"选项不正确的代码示例:
/*eslint no-return-assign: "error"*/
function doSomething() {
return foo = bar + 2;
}
function doSomething() {
return foo += 2;
}
"except-parens"
默认选项的正确代码示例:
/*eslint no-return-assign: "error"*/
function doSomething() {
return foo == bar + 2;
}
function doSomething() {
return foo === bar + 2;
}
function doSomething() {
return (foo = bar + 2);
}
always
选项不允许return
语句中的所有分配。所有的作业都被视为问题。
"always"
选项的错误代码示例:
/*eslint no-return-assign: ["error", "always"]*/
function doSomething() {
return foo = bar + 2;
}
function doSomething() {
return foo += 2;
}
function doSomething() {
return (foo = bar + 2);
}
"always"
选项的正确代码示例:
/*eslint no-return-assign: ["error", "always"]*/
function doSomething() {
return foo == bar + 2;
}
function doSomething() {
return foo === bar + 2;
}
何时不使用它
如果您想允许在return
声明中使用赋值运算符,则可以安全地禁用此规则。
版本
规则在 ESLint 0.0.9 中引入。
资源
- Rule source
- Documentation source
规则 | Rules相关

ESLint 是一个代码规范和错误检查工具,有以下几个特性。所有东西都是可以插拔的。你可以调用任意的 rule api 或者 formatter api 去打包或者定义 rule or formatter。任意的 rule 都是独立的。没有特定的 coding style,你可以自己配置。
主页 | https://eslint.org/ |
源码 | https://github.com/eslint/eslint |
发布版本 | 4.12.0 |