版本

no-new-wrappers

禁用将 new 运算符与 StringNumberBoolean 对象一起使用

JavaScript 中有三种原始类型具有包装对象:string、number 和 boolean。这些分别由构造函数 StringNumberBoolean 表示。每当读取这些原始值之一时,就会使用原始包装类型,为它们提供类似对象的功能,例如方法。在幕后,会创建一个关联包装类型的对象,然后销毁它,这就是为什么您可以在原始值上调用方法,例如

var text = "Hello world".substring(2);

在此示例的幕后,构造了一个 String 对象。substring() 方法存在于 String.prototype 上,因此字符串实例可以访问它。

也可以手动创建一个新的包装器实例

var stringObject = new String("Hello world");
var numberObject = new Number(33);
var booleanObject = new Boolean(false);

虽然可能,但没有任何好的理由使用这些原始包装器作为构造函数。它们往往比其他任何东西都更容易让其他开发人员感到困惑,因为它们看起来应该像原始类型一样工作,但事实并非如此。例如

var stringObject = new String("Hello world");
console.log(typeof stringObject);       // "object"

var text = "Hello world";
console.log(typeof text);               // "string"

var booleanObject = new Boolean(false);
if (booleanObject) {    // all objects are truthy!
    console.log("This executes");
}

第一个问题是原始包装器对象实际上是对象。这意味着 typeof 将返回 "object" 而不是 "string""number""boolean"。第二个问题来自布尔对象。每个对象都是真值,这意味着 Boolean 的实例始终解析为 true,即使它的实际值为 false

由于这些原因,避免将原始包装器类型与 new 一起使用被认为是最佳实践。

规则详情

此规则旨在消除将 StringNumberBooleannew 运算符一起使用的情况。因此,每当它看到 new Stringnew Numbernew Boolean 时,它都会发出警告。

此规则的错误代码示例

在 Playground 中打开
/*eslint no-new-wrappers: "error"*/

var stringObject = new String("Hello world");
var numberObject = new Number(33);
var booleanObject = new Boolean(false);

var stringObject = new String;
var numberObject = new Number;
var booleanObject = new Boolean;

此规则的正确代码示例

在 Playground 中打开
/*eslint no-new-wrappers: "error"*/

var text = String(someValue);
var num = Number(someValue);

var object = new MyString();

何时不使用

如果您想允许使用原始包装器对象,那么您可以安全地禁用此规则。

版本

此规则在 ESLint v0.0.6 中引入。

延伸阅读

资源

更改语言