【TypeScript】TS类型声明文件

在TypeScript中，类型声明文件（.d.ts 文件）用于描述库的类型，当你使用一个JavaScript库而不是TypeScript库时，这些文件非常有用。

例如，假设你想要在TypeScript中使用一个名为example-lib的JavaScript库。首先，你需要安装这个库：

npm install example-lib

然后，你可以创建一个.d.ts文件来声明这个库的类型：

// example-lib.d.ts
 
/**
 * ExampleLib 类的类型声明。
 */
declare class ExampleLib {
  /**
   * 初始化 ExampleLib 实例。
   * @param options 初始化选项
   */
  constructor(options: ExampleLibOptions);
 
  /**
   * 一个示例方法。
   * @param input 方法输入
   */
  exampleMethod(input: string): void;
}
 
/**
 * ExampleLib 的初始化选项接口。
 */
interface ExampleLibOptions {
  /**
   * 选项配置
   */
  config: string;
}
 
export = ExampleLib;

在你的TypeScript文件中，你可以这样使用这个库：

// your-code.ts
 
// 引入库及其类型声明
import ExampleLib from 'example-lib';
 
// 使用库的示例
const lib = new ExampleLib({ config: 'your-config' });
lib.exampleMethod('input-data');

通过这种方式，TypeScript 将能够理解example-lib库的结构，并在编译时进行类型检查。