非常教程

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 中引入的。

资源

  • Rule source
  • Documentation source

规则 | Rules相关

1.accessor-pairs
2.array-bracket-newline
3.array-bracket-spacing
4.array-callback-return
5.array-element-newline
6.arrow-body-style
7.arrow-parens
8.arrow-spacing
9.block-scoped-var
10.block-spacing
11.brace-style
12.callback-return
13.camelcase
14.capitalized-comments
15.class-methods-use-this
16.comma-dangle
17.comma-spacing
18.comma-style
19.complexity
20.computed-property-spacing
21.consistent-return
22.consistent-this
23.constructor-super
24.curly
25.default-case
26.dot-location
27.dot-notation
28.eol-last
29.eqeqeq
30.for-direction
31.func-call-spacing
32.func-name-matching
33.func-names
34.func-style
35.function-paren-newline
36.generator-star
37.generator-star-spacing
38.getter-return
39.global-require
40.global-strict
41.guard-for-in
42.handle-callback-err
43.id-blacklist
44.id-length
45.id-match
46.implicit-arrow-linebreak
47.indent
48.indent-legacy
49.init-declarations
50.jsx-quotes
51.key-spacing
52.keyword-spacing
53.line-comment-position
54.linebreak-style
55.lines-around-comment
56.lines-around-directive
57.lines-between-class-members
58.max-depth
59.max-len
60.max-lines
61.max-nested-callbacks
62.max-params
63.max-statements
64.max-statements-per-line
65.multiline-comment-style
66.multiline-ternary
67.new-cap
68.new-parens
69.newline-after-var
70.newline-before-return
71.newline-per-chained-call
72.no-alert
73.no-array-constructor
74.no-arrow-condition
75.no-await-in-loop
76.no-bitwise
77.no-buffer-constructor
78.no-caller
79.no-case-declarations
80.no-catch-shadow
81.no-class-assign
82.no-comma-dangle
83.no-compare-neg-zero
84.no-cond-assign
85.no-confusing-arrow
86.no-console
87.no-const-assign
88.no-constant-condition
89.no-continue
90.no-control-regex
91.no-debugger
92.no-delete-var
93.no-div-regex
94.no-dupe-args
95.no-dupe-class-members
96.no-dupe-keys
97.no-duplicate-case
98.no-duplicate-imports
99.no-else-return
100.no-empty
Eslint

ESLint 是一个代码规范和错误检查工具,有以下几个特性。所有东西都是可以插拔的。你可以调用任意的 rule api 或者 formatter api 去打包或者定义 rule or formatter。任意的 rule 都是独立的。没有特定的 coding style,你可以自己配置。

主页 https://eslint.org/
源码 https://github.com/eslint/eslint
发布版本 4.12.0

Eslint目录

1.指南 | Guide
2.规则 | Rules