TypeScript 接口是否应该在 *.d.ts 文件中定义

Question

TypeScript 新手问题。在我们的项目中，我们使用了一些外部 JavaScript 库，我们需要在其中添加 *.d.ts 文件。我了解这个用例以及我们需要这样做的原因。

但是，对于我们自己定义的接口，我的一位开发人员建议我们在 *.d.ts 文件中定义它们，这样我们就可以访问接口类型，而无需将其导入需要使用的模块中它。

例如，我们想为“错误优先回调”函数创建一个接口，以便我们可以在许多领域重用它。

所以不是这个...

export function helloWorldEventually(callback: (err: Error, result: any) => void) {
  callback(null, 'Hello World');
}

我们可以像这样为错误优先回调定义一个接口...

export interface ErrorFirstCallback {
  (err: Error, result: any): void;
}

然后像这样使用它......

export function helloWorldEventually(callback: ErrorFirstCallback) {
  callback(null, 'Hello World');
}

一开始我只是在ErrorFirstCallback.ts中定义了ErrorFirstCallback接口，为了引用而导入。

另一位开发人员建议我们将其放入 *.d.ts 文件中，然后我们无需导入它即可引用它。

我们定义的接口何时应该在 *.d.ts 文件和 *.ts 文件中定义。

谢谢！

Answer 1

声明文件描述了外部 JavaScript 库的形状。例如使用带有$ 的jQuery 将导致没有声明文件的TypeScript 错误，因为$ 或JQuery 未定义。因此，声明文件创建了一个接口，因此编译器知道“如果此变量是 JQuery 类型，则它必须具有函数 x,y,z”

为您的项目创建接口时，您应该将它们放在您喜欢的位置：在一个大的接口文件中，在每个接口的单独文件中，或者在它可能属于的文件中，但在声明文件中很不方便。

我个人喜欢为每个模块/类/接口设置单独的文件。但这只是口味问题。

考虑创建声明文件的唯一目的是让其他开发人员可以在他们的项目中使用您的最终 JavaScript 文件（不是 TypeScript！）。

Answer 2

你在使用typings吗？这似乎是管理第三方类型的社区方式。这样您就不必管理定义其他开发人员的 API。

作为参考，Node 环境 d.ts 似乎只是在整个 API 中定义了 (err, res) 回调 (https://github.com/typed-typings/env-node/blob/master/6/node.d.ts)

Answer 3

另一位开发人员建议我们将 [接口] 放在 *.d.ts 文件中，然后我们不需要导入它来引用它。

使用.d.ts 与.ts 文件与在本地/模块或全局/脚本范围内提供类型声明无关。

你可以export接口ErrorFirstCallback，所以其他人将不得不import它。或者您不使用export/import 使文件成为全局脚本。然后，ErrorFirstCallback 可以在没有导入的情况下使用。在这种情况下，如果文件具有 .ts 或 .d.ts 扩展名，则无关紧要。

我们定义的接口何时应该在 *.d.ts 文件和 *.ts 文件中定义。

重要的是，.d.ts 文件 are only seen as compiler input 而不是发送到您的 dist/build 文件夹。

作为一个好的经验法则，如果您想将类型作为 npm 包或公共类型化 API 的一部分提供，那么您可以将类型放入 .ts 中，以便通过构建步骤让您的生活更轻松（它将发出作为编译器输出）。

您可以将.d.ts 文件用于项目内部使用的类型。