JS.BASE.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 their capitalization (such as Math and JSON) but will throw an error if you try to execute them as functions.

The ECMAScript 5 specification (https://es5.github.io/#x15.8) 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 (https://www.ecma-international.org/ecma-262/6.0/index.html#sec-reflect-object) 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.

And the ECMAScript 2017 specification (https://www.ecma-international.org/ecma-262/8.0/index.html#sec-atomics-object) 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.

Rule Details

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

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

Examples of incorrect code for this rule:

Copy
/*eslint no-obj-calls: "error"*/
/*eslint-env es2017*/

var math = Math();

var newMath = new Math();

var json = JSON();

var newJSON = new JSON();

var reflect = Reflect();

var newReflect = new Reflect();

var atomics = Atomics();

var newAtomics = new Atomics();

Examples of correct code for this rule:

Copy
/*eslint no-obj-calls: "error"*/
/*eslint-env es2017*/

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

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

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

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

The content on this page is adapted from the ESLint User Guide. Copyright © OpenJS Foundation and other contributors, www.openjsf.org. All rights reserved. https://eslint.org/docs/rules/