no-global-assign
禁止分配给本地对象或只读全局变量( no-global-assign )
"extends": "eslint:recommended"
配置文件中的属性启用此规则。
JavaScript 环境包含许多内置的全局变量,例如window
在浏览器和process
Node.js中。在几乎所有情况下,您都不想为这些全局变量赋值,因为这样做可能会导致无法访问重要的功能。例如,您可能不想在浏览器代码中执行此操作:
window = {};
虽然window
很明显的例子,但 JavaScript 环境经常提供数百个内置全局对象。很难知道你是否在分配一个全局变量。
规则细节
此规则不允许修改只读全局变量。
ESLint 有能力将全局变量配置为只读。
- 指定环境
- 指定全局
此规则的错误
代码示例:
/*eslint no-global-assign: "error"*/
Object = null
undefined = 1
/*eslint no-global-assign: "error"*/
/*eslint-env browser*/
window = {}
length = 1
top = 1
/*eslint no-global-assign: "error"*/
/*globals a:false*/
a = 1
此规则的正确
代码示例:
/*eslint no-global-assign: "error"*/
a = 1
var b = 1
b = 2
/*eslint no-global-assign: "error"*/
/*eslint-env browser*/
onload = function() {}
/*eslint no-global-assign: "error"*/
/*globals a:true*/
a = 1
选项
该规则接受一个exceptions
选项,该选项可用于指定允许重新分配的内建列表:
{
"rules": {
"no-global-assign": ["error", {"exceptions": ["Object"]}]
}
}
何时不使用它
如果您尝试覆盖其中一个本机对象。
相关规则
- no-extend-native
- no-redeclare
- no-shadow
版本
这条规则是在 ESLint 3.3.0 中引入的。