在 TypeScript 中使用导入类型的环境声明

发布于03月26日

我的TypeScript项目中有一个声明文件，如下所示:

// myapp.d.ts
declare namespace MyApp {
  interface MyThing {
    prop1: string
    prop2: number
  }
}

这非常有效，我可以在项目中的任何地方使用这个名称空间，而无需导入它.

我现在需要从第三方模块导入一个类型，并在我的环境声明中使用它:

// myapp.d.ts
import {SomeType} from 'module'

declare namespace MyApp {
  interface MyThing {
    prop1: string
    prop2: number
    prop3: SomeType
  }
}

编译器现在抱怨它找不到名称空间"MyApp"，可能是因为导入阻止了它成为环境.

在使用第三方类型的同时，是否有一些简单的方法来保持声明的环境友好度？

推荐答案

是的，有办法.在TypeScript 2.9中使用import() a type变得更容易，但在早期版本的TypeScript中也可以使用import() a type.

下面的文件是script.脚本中声明的内容将添加到脚本中.这就是为什么不用导入就可以使用MyApp.MyThing.

// myapp.d.ts
declare namespace MyApp {
  interface MyThing {
    prop1: string;
    prop2: number;
  }
}

脚本的局限性在于它们不能导入任何内容；当添加import时，脚本将变为module.我觉得至少可以说这很奇怪，但事实就是这样.重要的是，module中定义的内容被限定在该模块的范围内，而不是添加到全局范围内.

然而，模块can也将声明添加到全局范围中，方法是将它们放在global中:

// myapp.d.ts
import {SomeType} from 'module';

declare global {
  namespace MyApp {
    interface MyThing {
      prop1: string;
      prop2: number;
      prop3: SomeType;
    }
  }
}

这个文件是module，但它在全局范围中添加了一个MyApp.MyThing的声明，因此您仍然可以在其他TypeScript代码中使用MyApp.MyThing，而无需导入它.

请注意，使用.d.ts扩展与无需导入即可访问接口无关.上述两个文件可能都是.ts个文件，但它们的行为仍然完全相同.