no-extend-native
禁止扩展本地对象(不扩展本机)
在 JavaScript 中,您可以扩展任何对象,包括内置或“本机”对象。有时候人们会改变这些本地对象的行为,破坏代码中其他部分的假设。
例如,在这里我们覆盖了一个内建的方法,它会影响所有的对象,甚至是其他的内建对象。
// seems harmless
Object.prototype.extra = 55;
// loop through some userIds
var users = {
"123": "Stan",
"456": "David"
};
// not what you'd expect
for (var id in users) {
console.log(id // "123", "456", "extra"
}
避免这个问题的常见建议是将for
循环内部包裹起来users.hasOwnProperty(id)
。但是,如果此规则在您的代码库中严格执行,则无需采取这一步骤。
规则细节
不允许直接修改内建对象的原型。
此规则的错误
代码示例:
/*eslint no-extend-native: "error"*/
Object.prototype.a = "a";
Object.defineProperty(Array.prototype, "times", { value: 999 }
选项
该规则接受一个exceptions
选项,该选项可用于指定允许扩展名的内建列表。
异常
示例选项的正确
代码示例{ "exceptions": ["Object"] }
:
/*eslint no-extend-native: ["error", { "exceptions": ["Object"] }]*/
Object.prototype.a = "a";
已知限制
此规则不
报告任何以下不
太明显的方法来修改内置对象的原型:
var x = Object;
x.prototype.thing = a;
eval("Array.prototype.forEach = 'muhahaha'"
with(Array) {
prototype.thing = 'thing';
};
window.Function.prototype.bind = 'tight';
何时不使用它
您可能希望在使用试图使用最新规范修补旧版 JavaScript 的 polyfills 时禁用此规则,例如那些可能Function.prototype.bind
或Array.prototype.forEach
以未来友好方式进行修补的规则。
相关规则
- no-global-assignVersion 此规则是在 ESLint 0.1.4.Resources 中引入的