no-prototype-builtins

禁止直接在对象上调用某些 Object.prototype 方法

在 ECMAScript 5.1 中，添加了 Object.create，它允许创建具有指定 [[Prototype]] 的对象。Object.create(null) 是一个常用模式，用于创建将用作 Map 的对象。当假设对象将具有来自 Object.prototype 的属性时，这可能会导致错误。此规则阻止直接从对象调用某些 Object.prototype 方法。

此外，对象可以拥有隐藏 Object.prototype 上内置属性的属性，这可能导致意外行为或拒绝服务安全漏洞。例如，对于 Web 服务器来说，从客户端解析 JSON 输入并直接在结果对象上调用 hasOwnProperty 是不安全的，因为恶意客户端可以发送类似 {"hasOwnProperty": 1} 的 JSON 值并导致服务器崩溃。

为了避免此类细微的错误，最好始终从 Object.prototype 调用这些方法。例如，foo.hasOwnProperty("bar") 应替换为 Object.prototype.hasOwnProperty.call(foo, "bar")。

规则详情

此规则禁止直接在对象实例上调用某些 Object.prototype 方法。

此规则的错误代码示例

/*eslint no-prototype-builtins: "error"*/

var hasBarProperty = foo.hasOwnProperty("bar");

var isPrototypeOfBar = foo.isPrototypeOf(bar);

var barIsEnumerable = foo.propertyIsEnumerable("bar");
1
2
3
4
5
6
7

此规则的正确代码示例

/*eslint no-prototype-builtins: "error"*/

var hasBarProperty = Object.prototype.hasOwnProperty.call(foo, "bar");

var isPrototypeOfBar = Object.prototype.isPrototypeOf.call(foo, bar);

var barIsEnumerable = {}.propertyIsEnumerable.call(foo, "bar");
1
2
3
4
5
6
7

何时不使用它

如果您的代码仅接触具有硬编码键的对象，并且您永远不会使用隐藏 Object.prototype 方法或不继承自 Object.prototype 的对象，则您可能希望关闭此规则。

版本

此规则在 ESLint v2.11.0 中引入。

资源

• 规则源代码
• 测试源代码