ESLint’s “no-undef” rule is calling my use of Underscore an undefined variable

The official documentation should give you an idea on how to fix this.

Any reference to an undeclared variable causes a warning, unless the variable is explicitly mentioned in a /*global ...*/ comment, or specified in the globals key in the configuration file.

The easiest fix would be to add

/* global _ */

at the top of your file.

Or better, explicitly specify that the variable is read-only, to disallow overwriting the variable:

/* global _:readonly */

But since you’ll have to do that for each new js file, it can get annoying. If you are using underscore often, I’d suggest to add globals to your .eslintrc file, for example:

{
    "globals": {
        "_": "readonly"
    }
}

And save this as .eslintrc in your project root, or optionally in your user home directory. Although some say the latter not recommended, it can sometimes be convenient, but you have to remember that you have it there 🙂


Explanation of the above rule: "_": "readonly" (used to be "_": false, now deprecated) means that a variable named _ tells eslint that this variable is defined globally and it will not emit any no-undef errors for this variable. As @sebastian pointed out, "readonly" (or false – deprecated) means that the variable can’t be overwritten, so the code _ = 'something else' would yield an error no-global-assign. If you were to instead use "_": "writable" (or "_": true – deprecated), this means that the value can be re-assigned and the previously mentioned error will not occur.

But keep in mind that this will only happen if you assign directly to the global variable as I have shown in the example. You can still shadow it and eslint won’t say anything. For example, these snippets wouldn’t yield the no-global-assign:

const _ = 'haha I broke your _' 

or as function argument name, e.g.

function (_) {
  console.log(_, 'might not be the _ you were looking for') 
}

Leave a Comment