TS 声明文件:为 JavaScript 库添加类型
学习编写 .d.ts 声明文件,为第三方 JS 库或全局变量提供类型定义。 · 难度:入门 · +15XP
声明文件的作用
声明文件(.d.ts)是 TypeScript 中描述 JavaScript 模块或全局变量的类型结构的文件。它们不需要实现,只包含类型声明,让 TypeScript 编译器理解非 TS 代码的类型信息。
声明文件类型
| 类型 | 说明 |
|---|---|
| 全局声明 | 为全局变量(如 window 上的属性)添加类型 |
| 模块声明 | 为 npm 包或自定义模块添加类型 |
| 增强声明 | 扩展现有模块的类型 |
代码示例
// 全局声明示例
declare var myGlobalLib: {
version: string;
doSomething(): void;
};
// 模块声明示例
declare module 'my-custom-lib' {
export function greet(name: string): string;
export const version: string;
}
练习提示:为一个简单的数学工具库编写声明文件,包括 add、subtract 函数。