← Back to rules

eslint/no-shadow-restricted-names Correctness

✅ This rule is turned on by default.

它的作用

不允许重新定义诸如 undefined、NaN、Infinity、 eval、globalThis 和 arguments 之类的全局变量。

为什么这很糟糕？

全局对象 NaN、Infinity、undefined、globalThis 的值属性，以及严格 模式下受限标识符 eval 和 arguments，都被认为是 JavaScript 中的受限名称。 将它们定义为其他含义可能会带来意想不到的后果，并让阅读代码的其他人感到困惑。 例如，下面这样的写法并不会被阻止：

var undefined = "foo";

之后，在同一作用域内使用的任何代码都不会获取全局的 undefined，而是会获取 具有完全不同含义的局部版本。

示例

以下是此规则的错误代码示例：

function NaN() {}

!function (Infinity) {};

var undefined = 5;

try {
} catch (eval) {}

const globalThis = "foo";

import NaN from "foo";

import { undefined } from "bar";

class Infinity {}

以下是此规则的正确代码示例：

var Object;

function f(a, b) {}

// 例外：如果变量从未被赋值，则 `undefined` 可以被遮蔽。
var undefined;

import { undefined as undef } from "bar";

配置

此规则接受一个具有以下属性的配置对象：

reportGlobalThis

type: boolean

default: true

如果为 true，也会报告对 globalThis 的遮蔽。

如何使用

To enable this rule using the config file or in the CLI, you can use:

Config (.oxlintrc.json)

{
  "rules": {
    "no-shadow-restricted-names": "error"
  }
}

Config (oxlint.config.ts)

import { defineConfig } from "oxlint";

export default defineConfig({
  rules: {
    "no-shadow-restricted-names": "error",
  },
});

CLI

oxlint --deny no-shadow-restricted-names

版本

此规则于 v0.0.3 中添加。

参考资料

• Rule Source
• Open rule in Oxc Playground