迹忆客 专注技术分享

当我们尝试访问 global 对象上不存在的属性时，会出现错误“Element implicitly has an 'any' type because type 'typeof globalThis' has no index signature”。 要解决此错误，需要扩展全局对象并为必要的属性指定类型。

下面代码是一个发生该错误的示例。

// Error: Element implicitly has an 'any'
// type because type 'typeof globalThis'
// has no index signature.ts(7017)
global.hello = 'world';

我们试图访问 global 对象上不存在的属性，因此会看到报错。

为了解决这个问题，我们必须为我们打算在 global 对象上访问的属性和方法添加类型。

在 src 目录中，创建一个包含以下 index.d.ts 文件的 types 目录：

src/types/index.d.ts

/* eslint-disable no-var */

declare global {
  var example: string;
  function sum(a: number, b: number): number;
}

export {};

我们添加了一个 example 属性，该属性具有字符串类型和 sum 方法。

注意 ，这在不同的用例中会有所不同，因此请确保调整属性名称和类型。

确保使用 var 关键字为你打算在其他文件中设置和使用的属性添加类型。

我们需要在全局对象上添加要访问的所有属性的名称和类型。

例如，如果不知道特定属性的类型并想关闭类型检查，需要将其设置为 any。

现在，我可以设置和访问 global 对象上的指定属性，而不会出现任何错误。

global.example = 'hello world';

global.sum = function (a: number, b: number) {
  return a + b;
};

console.log(global.example); // "hello world"

console.log(global.sum(15, 25)); // 40

注意，如果您使用的是 ts-node，那么终端可能仍会出现错误。

问题在于 ts-node 无法识别本地声明文件。

要解决这个问题，请在 ts-node 命令中使用 --files 标志，因此应该运行 ts-node --files ./src/index.ts 而不是 ts-node ./src/index.ts。

将 nodemon 与 ts-node 一起使用，下面是我的 nodemon.json 文件的内容

{
  "watch": ["src"],
  "ext": ".ts,.js",
  "ignore": [],
  "exec": "ts-node --files ./src/index.ts"
}

跟上 --files 选项后（仅在使用 ts-node 时才需要），重新启动服务器，应该会一切顺利。

注意 ，这使得 sum 函数和 example 属性可以直接访问，也可以在 global 对象上访问。

global.example = 'hello world';

global.sum = function (a: number, b: number) {
  return a + b;
};

console.log(global.example); // "hello world"
console.log(global.sum(15, 25)); // 40

console.log(example); // "hello world"
console.log(sum(5, 15)); // 20

如果您的 IDE 中仍然出现错误，请尝试将 types 目录的路径添加到 tsconfig.json 文件中。

{
  "compilerOptions": {
    // ... rest
    "typeRoots": ["./node_modules/@types", "./src/types"]
  }
}

我们在 index.d.ts 文件中使用 export {} 将其标记为外部模块。 模块是包含至少 1 个导入或导出语句的文件。 我们必须这样做才能扩大 global 的范围。

注意 ，我们必须根据用例更改 index.d.ts 文件的内容。

你应该在全局对象上添加打算访问的所有属性的名称（和类型）。

src/types/index.d.ts

declare global {
  var example: any; // 禁用属性的类型检查
  function sum(a: number, b: number): number;
}

export {};

提供的文件只是添加了一个类型为 any 的 example 属性和一个 sum 方法，这很可能不是我们需要的。

TypeScript 在查找常规 .ts 文件的相同位置查找 .d.ts 文件，这取决于 tsconfig.json 文件中的 include 和 exclude 设置。

TypeScript 会将你在 global 对象上声明的类型与原始类型合并，因此你将能够从两个声明中访问属性和方法。