no-obj-calls

Disallow calling global object properties as functions

ECMAScript provides several global objects that are intended to be used as-is. Some of these objects look as if they could be constructors due to their capitalization (such as Math, JSON, and Temporal) but will throw an error if you try to execute them as functions.

The ECMAScript 5 specification makes it clear that both Math and JSON cannot be invoked:

The Math object does not have a [[Call]] internal property; it is not possible to invoke the Math object as a function.

The ECMAScript 2015 specification makes it clear that Reflect cannot be invoked:

The Reflect object also does not have a [[Call]] internal method; it is not possible to invoke the Reflect object as a function.

The ECMAScript 2017 specification makes it clear that Atomics cannot be invoked:

The Atomics object does not have a [[Call]] internal method; it is not possible to invoke the Atomics object as a function.

The ECMAScript Internationalization API Specification makes it clear that Intl cannot be invoked:

The Intl object does not have a [[Call]] internal method; it is not possible to invoke the Intl object as a function.

The Temporal proposal specification makes it clear that Temporal cannot be invoked:

The Temporal object does not have a [[Call]] internal method; it cannot be invoked as a function.

Rule Details

This rule disallows calling the Math, JSON, Reflect, Atomics, Intl, and Temporal objects as functions.

This rule also disallows using these objects as constructors with the new operator.

Examples of incorrect code for this rule:

/*eslint no-obj-calls: "error"*/

const math = Math();

const newMath = new Math();

const json = JSON();

const newJSON = new JSON();

const reflect = Reflect();

const newReflect = new Reflect();

const atomics = Atomics();

const newAtomics = new Atomics();

const intl = Intl();

const newIntl = new Intl();

const temporal = Temporal();

const newTemporal = new Temporal();
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

Examples of correct code for this rule:

/*eslint no-obj-calls: "error"*/

function area(r) {
    return Math.PI * r * r;
}

const object = JSON.parse("{}");

const value = Reflect.get({ x: 1, y: 2 }, "x");

const first = Atomics.load(foo, 0);

const segmenterFr = new Intl.Segmenter("fr", { granularity: "word" });

const instant = Temporal.Now.instant();
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

Options

This rule has no options.

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 v0.0.9.

Further Reading

Annotated ES5
es5.github.io

Resources

• Rule source
• Tests source