no-new-native-nonconstructor

Disallow new operators with global non-constructor functions

✅

Using the recommended config from @eslint/js in a configuration file enables this rule

It is a convention in JavaScript that global variables beginning with an uppercase letter typically represent classes that can be instantiated using the new operator, such as new Array and new Map. Confusingly, JavaScript also provides some global variables that begin with an uppercase letter that cannot be called using the new operator and will throw an error if you attempt to do so. These are typically functions that are related to data types and are easy to mistake for classes. Consider the following example:

// throws a TypeError
let foo = new Symbol("foo");

// throws a TypeError
let result = new BigInt(9007199254740991);
1
2
3
4
5

Both new Symbol and new BigInt throw a type error because they are functions and not classes. It is easy to make this mistake by assuming the uppercase letters indicate classes.

Rule Details

This rule is aimed at preventing the accidental calling of native JavaScript global functions with the new operator. These functions are:

Symbol
BigInt

Examples

Examples of incorrect code for this rule:

Open in Playground

/*eslint no-new-native-nonconstructor: "error"*/

var foo = new Symbol('foo');
var bar = new BigInt(9007199254740991);
1
2
3
4

Examples of correct code for this rule:

Open in Playground

/*eslint no-new-native-nonconstructor: "error"*/

var foo = Symbol('foo');
var bar = BigInt(9007199254740991);

// Ignores shadowed Symbol.
function baz(Symbol) {
    const qux = new Symbol("baz");
}
function quux(BigInt) {
    const corge = new BigInt(9007199254740991);
}

1
2
3
4
5
6
7
8
9
10
11
12
13

When Not To Use It

This rule should not be used in ES3/5 environments.

Handled by TypeScript

It is safe to disable this rule when using TypeScript because TypeScript's compiler enforces this check.

Version

This rule was introduced in ESLint v8.27.0.

Resources

Edit this page