Skip to content
Biome
Docs Blog Playground

noRestrictedGlobals

Diagnostic Category: lint/style/noRestrictedGlobals

Since: v1.0.0 Sources:

This rule allows you to specify global variable names that you don’t want to use in your application.

References to the global identifiers error and event are always disallowed by this rule.

Disallowing usage of specific global variables can be useful if you want to allow a set of global variables by enabling an environment, but still want to disallow some of those.

Examples

Section titled Examples

Invalid

Section titled Invalid
console.log(event)
code-block.js:1:13 lint/style/noRestrictedGlobals ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ⚠ Do not use the global variable event.
  
  > 1 │ console.log(event)
      │             ^^^^^
    2 │ 
  
  ℹ Use a local variable instead.

Valid

Section titled Valid
function f(event) {
    console.log(event)
}

Options

Section titled Options

Use the options to specify additional globals that you want to restrict in your source code.

{
    "options": {
        "deniedGlobals": ["$", "MooTools"]
    }
}

In the example above, the rule will emit a diagnostics if tried to use $ or MooTools without creating a local variable.

Section titled Related links