no-extend-native

Disallow extending native types

在 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"
}
1
2
3
4
5
6
7
8
9
10
11
12
13

为了避免这个问题，一个常见的建议是用 users.hasOwnProperty(id) 来包裹 for 循环的内部。然而，如果这一规则在你的代码库中被严格执行，你就不需要采取这一步骤。

规则细节

不允许直接修改内置对象的原型。

使用此规则的错误示例：

Open in Playground

/*eslint no-extend-native: "error"*/

Object.prototype.a = "a";
Object.defineProperty(Array.prototype, "times", { value: 999 });
1
2
3
4

选项

这条规则接受一个 exceptions 选项，可以用来指定一个允许扩展的内置程序列表。

exceptions

使用示例的 { "exceptions": ["Object"] } 选项的正确示例：

Open in Playground

/*eslint no-extend-native: ["error", { "exceptions": ["Object"] }]*/

Object.prototype.a = "a";
1
2
3

已知限制

这条规则不报告任何以下不太明显的修改内置对象原型的方法。

var x = Object;
x.prototype.thing = a;

eval("Array.prototype.forEach = 'muhahaha'");

with(Array) {
    prototype.thing = 'thing';
};

window.Function.prototype.bind = 'tight';
1
2
3
4
5
6
7
8
9
10

何时不用

在使用 polyfills 时，你可能想禁用这个规则，因为它试图用最新的规范来修补旧版本的 JavaScript，比如那些可能以对未来友好的方式修补 Function.prototype.bind 或 Array.prototype.forEach。

Version

This rule was introduced in ESLint v0.1.4.

Resources

编辑此页