环境声明

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

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

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

    和：

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

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

    TIP

    • 环境声明就好像是一个文档。如果源文件更新了，你应该同步更进。所以，当你使用源文件在运行时的新行为时，如果没有人更新环境声明，编译器将会报错。

    变量

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

    TIP

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

    1. process.exit();

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

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

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

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