new-cap
要求构造函数名以大写字母(new-cap)开头
new
JavaScript中的运算符创建特定类型对象的新实例。该类型的对象由构造函数表示。由于构造函数只是常规函数,因此唯一的定义特征是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中引入。