new-cap

newJavaScript中的运算符创建特定类型对象的新实例。该类型的对象由构造函数表示。由于构造函数只是常规函数，因此唯一的定义特征是new作为调用的一部分使用。原生JavaScript函数以大写字母开头，以区分将用作构造函数的那些函数与不用的函数。许多样式指南建议遵循此模式，以便更轻松地确定哪些函数将用作构造函数。

var friend = new Person();

规则细节

此规则要求构造函数名以大写字母开头。某些内置标识符可免除此规则。这些标识符是：

• Array

• Boolean

• Date

• Error

• Function

• Number

• Object

• RegExp

• String

• Symbol

此规则的正确代码示例：

/*eslint new-cap: "error"*/

function foo(arg) {
    return Boolean(arg);
}

选项

该规则有一个对象选项：

• "newIsCap": true（默认）要求new使用大写启动函数调用所有操作符。

• "newIsCap": false允许new使用小写启动或大写启动功能调用运算符。

• "capIsNew": true（默认）要求所有大写启动的函数与new操作符一起调用。

• "capIsNew": false允许在没有new操作符的情况下调用大写启动的函数。

• "newIsCapExceptions"允许new操作员调用指定的小写启动函数名称。

• "newIsCapExceptionPattern"允许与new操作符一起调用与指定的正则表达式模式相匹配的任何小写启动的函数名称。

• "capIsNewExceptions"允许在没有new操作员的情况下调用指定的大写启动函数名称。

• "capIsNewExceptionPattern"允许任何匹配指定正则表达式模式的大写启动函数名称在没有new操作符的情况下被调用。

• "properties": true （默认）启用对对象属性的检查

• "properties": false 禁用对象属性的检查

newIsCap

此规则的默认代码错误代码示例{ "newIsCap": true }：

/*eslint new-cap: ["error", { "newIsCap": true }]*/

var friend = new person();

具有默认选项的此规则的正确代码示例{ "newIsCap": true }：

/*eslint new-cap: ["error", { "newIsCap": true }]*/

var friend = new Person();

此规则的正确代码示例包含以下{ "newIsCap": false }选项：

/*eslint new-cap: ["error", { "newIsCap": false }]*/

var friend = new person();

capIsNew

此规则的默认代码错误代码示例{ "capIsNew": true }：

/*eslint new-cap: ["error", { "capIsNew": true }]*/

var colleague = Person();

具有默认选项的此规则的正确代码示例{ "capIsNew": true }：

/*eslint new-cap: ["error", { "capIsNew": true }]*/

var colleague = new Person();

此规则的正确代码示例包含以下{ "capIsNew": false }选项：

/*eslint new-cap: ["error", { "capIsNew": false }]*/

var colleague = Person();

newIsCapExceptions

此规则的附加正确代码示例包含以下{ "newIsCapExceptions": ["events"] }选项：

/*eslint new-cap: ["error", { "newIsCapExceptions": ["events"] }]*/

var events = require('events');

var emitter = new events();

newIsCapExceptionPattern

此规则的附加正确代码示例包含以下{ "newIsCapExceptionPattern": "^person\.." }选项：

/*eslint new-cap: ["error", { "newIsCapExceptionPattern": "^person\.." }]*/

var friend = new person.acquaintance();
var bestFriend = new person.friend();

capIsNewExceptions

此规则的附加正确代码示例包含以下{ "capIsNewExceptions": ["Person"] }选项：

/*eslint new-cap: ["error", { "capIsNewExceptions": ["Person"] }]*/

function foo(arg) {
    return Person(arg);
}

capIsNewExceptionPattern

此规则的附加正确代码示例包含以下{ "capIsNewExceptionPattern": "^Person\.." }选项：

/*eslint new-cap: ["error", { "capIsNewExceptionPattern": "^Person\.." }]*/

var friend = person.Acquaintance();
var bestFriend = person.Friend();

属性

此规则的默认代码错误代码示例{ "properties": true }：

/*eslint new-cap: ["error", { "properties": true }]*/

var friend = new person.acquaintance();

具有默认选项的此规则的正确代码示例{ "properties": true }：

/*eslint new-cap: ["error", { "properties": true }]*/

var friend = new person.Acquaintance();

此规则的正确代码示例包含以下{ "properties": false }选项：

/*eslint new-cap: ["error", { "properties": false }]*/

var friend = new person.acquaintance();

何时不使用它

如果您的约定不需要构造函数的大写字母，或者不需要大写的函数只能用作构造函数，请关闭此规则。

版本

该规则在ESLint 0.0.3-0中引入。

资源

• 规则来源

• 文档来源