TypeScript 环境声明

2024 年 8 月 29 日 | 阅读 2 分钟

TypeScript 提供了安全、轻松地使用现有 JavaScript 库(如 jQuery、AngularJS、Node.js 等)的方法。环境声明允许我们安全地使用现有的流行 JavaScript 库。

环境声明告诉 TypeScript 编译器关于实际的源代码(如变量/函数)存在于其他地方。如果我们的 TypeScript 代码需要使用用纯 JavaScript 库编写的第三方库,如 jQuery/AngularJS/Node.js,我们始终可以编写环境声明。环境声明描述了本应存在的类型,并将用 TypeScript 编写。

环境声明

环境声明文件需要使用扩展名 (d.ts) 保存。带有扩展名 .d.ts 的文件必须在其每个根级定义前缀 declare 关键字。它向作者明确表示,TypeScript 不会发出任何代码。作者需要确保声明的条目将在运行时存在。

环境声明告诉编译器关于实际源代码存在于其他地方。如果这些源代码在运行时不存在,并且我们尝试使用它们,则它将中断,而不会发出警告。

环境声明文件就像 文档 文件。如果源代码发生更改,则文档也需要保持更新。如果环境声明文件未更新,它将返回编译错误。

我们无法将上述文件 转译 为 JavaScript。我们可以使用上述文件进行 类型安全IntelliSense

我们可以使用 declare 关键字声明环境变量和方法。环境声明的语法如下所示。

语法

访问环境文件的语法

示例

我们可以通过以下示例来理解环境声明。在这里,我们正在使用带有以下代码的第三方 JavaScript 库。

Addition.js

以上是一个 JS 文件,我们没有太多时间将此库重写为 TypeScript。但是,如果仍然需要使用带有类型安全的 doSum() 函数,那么我们可以通过使用 环境声明 来做到这一点。让我们创建一个环境声明文件。

CalcSum.d.ts

现在,将此环境声明文件 (CalcSum.d.ts) 包含到我们的 TypeScript 文件中。

Main.ts

使用控制台上的以下命令编译并执行 Main.ts 文件。

我们将获得以下输出。

Sum: 40