Eslint
规则 | Rules

no-new-wrappers

禁止基元包装实例(无新包装)

JavaScript 中有三种基本类型包含对象:字符串,数字和布尔值。这些由构造表示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"。第二个问题来自布尔对象。每个对象都是 truthy,它的实际值是一个Boolean总是可以解决即使实际值为 false, 总是解析为 true的实例。

由于这些原因,避免使用基本包装类型new是最佳做法。

规则细节

这个规则的目的是杜绝使用StringNumber以及Booleannew操作。因此发出,它当检索到new Stringnew Numbernew Boolean警告。

这个规则的错误代码示例:

/*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;

这个规则的正确代码示例:

/*eslint no-new-wrappers: "error"*/ var text = String(someValue var num = Number(someValue var object = new MyString(

何时不使用它

如果你想允许使用原始的包装对象,那么你可以放心地禁用这个规则。

进一步阅读

  • no-array-constructor

  • no-new-object

版本

这个规则是在 ESLint 0.0.6 中引入的。

资源