环境声明

正如我们在为什么使用 TypeScript 所说：

TypeScript 的设计目标之一是让你从现有的 JavaScript 库中安全、轻松的使用 TypeScript，你可以通过 TypeScript 声明文件来做到这一点。

环境声明允许你安全的使用现有的 JavaScript 库，并且能让你的 JavaScript，CoffeeScript 或者其他需要编译成 JavaScript 的语言逐步迁移至 TypeScript。

学习为第三方 JavaScript 库编写环境声明，是一种为 TypeScript 写注解比较好的实践方式。

声明文件

你可以通过 declare 关键字，来告诉 TypeScript，你正在试图表述一个其他地方已经存在的代码（如：写在 JavaScript、CoffeeScript 或者是像浏览器和 Node.js 运行环境里的代码）：

  1. foo = 123; // Error: 'foo' is not defined

和：

  1. declare var foo: any;
  2. foo = 123; // allow

你可以选择把这些声明放入 .ts 或者 .d.ts 里。在你实际的项目里，我们强烈建议你应该把声明放入 .d.ts 里（可以从一个命名为 globals.d.ts 或者 vendor.d.ts 文件开始）。

如果一个文件有扩展名 .d.ts，这意味着每个顶级的声明都必须以 declare 关键字作为前缀。这有利于向作者说明，在这里 TypeScript 将不会把它编译成任何代码，同时他需要确保这些在编译时存在。

TIP

  • 环境声明就好像你与编译器之间的一个约定，如果这些没有在编译时存在，但是你却使用了它们，则事情将会在没有警告的情况下中断。
  • 环境声明就好像是一个文档。如果源文件更新了，你应该同步更进。所以，当你使用源文件在运行时的新行为时，如果没有人更新环境声明，编译器将会报错。

变量

举个例子，当你想告诉 TypeScript 编辑器关于 process 变量时，你可以这么做：

  1. declare let process: any;

TIP

你并不需要为 process 做这些，因为这已经存在于社区维护的 node.d.ts

这允许你使用 process，并能成功通过 TypeScript 的编译：

  1. process.exit();

我们推荐尽可能的使用接口，例如：

  1. interface Process {
  2.   exit(code?: number): void;
  3. }
  5. declare let process: Process;

因为这允许其他人扩充这些全局变量，并且会告诉 TypeScript 有关于这些的修改。例如：考虑到以下情况，我们添加一个 exitWithLogging 函数至 process：

  1. interface Process {
  2.   exitWithLogging(code?: number): void;
  3. }
  5. process.exitWithLogging = function() {
  6.   console.log('exiting');
  7.   process.exit.apply(process, arguments);
  8. };

接下来，让我们更详细的了解接口。

原文: https://jkchao.github.io/typescript-book-chinese/typings/ambient.html