How can I detect name collision of local classes with global ones in JS or TS using ESLint?

Question

In JavaScript, you can define a class with a name like Node or Attr. I think it might lead a confusion, as there is also a global constructor function with the same names. I believe linting is ESLint's job, but I couldn't figure out how to configure it to detect it. Neither no-shadow nor no-redeclare seems not working for this kind of redeclaration or shadowing. typescript-eslint couldn't detect it either.

Is there a way to prevent shadowing of global classes?

Edit: no-shadow with { builtinGlobals: true } doesn't do a trick. It works only for names like Object or undefined.

Answer 1

As I mentioned in the comments, this can be achieved by using the no-shadow rule. By default, the rule does not check the built-in types (e.g. window, Node or Attr), but it can be configured to do so by setting the option builtinGlobals to true, like this:

no-shadow: ["error", { "builtinGlobals": true }]

This now tells ESLint to check if any variables shadows any name that is available in the global scope - but you have to configure which ones are actually available, since ESLint does not know that by itself. You can do that by setting the correct environments through the env configuration:

"env": { 
    "browser": true
}

I configured a small example in the ESLint Playground Demo to showcase this.