unicorn/prefer-global-this Style

💡 A suggestion is available for this rule.

强制使用 globalThis 代替特定环境的全局对象别名（window、self 或 global）。

使用标准的 globalThis 可以使你的代码在浏览器、Web Workers、Node.js，以及未来的 JavaScript 运行时之间保持可移植性。

可移植性 – window 只在浏览器主线程中定义，self 用于 Web Workers，而 global 是 Node 特有的。选择错误的别名会导致代码在原始环境之外执行时发生运行时崩溃。

清晰性 – globalThis 清楚地表明你指的是全局对象本身，而不是某个特定平台。

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

// 仅限浏览器
window.alert("Hi");

// 仅限 Node
if (typeof global.Buffer !== "undefined") {
}

// 仅限 Web Worker
self.postMessage("done");

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

globalThis.alert("Hi");

if (typeof globalThis.Buffer !== "undefined") {
}

globalThis.postMessage("done");

如何使用

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

Config (.oxlintrc.json)Config (oxlint.config.ts)CLI

json

{
  "rules": {
    "unicorn/prefer-global-this": "error"
  }
}

import { defineConfig } from "oxlint";

export default defineConfig({
  rules: {
    "unicorn/prefer-global-this": "error",
  },
});

bash

oxlint --deny unicorn/prefer-global-this

此规则于 v0.16.12 中添加。