声明文件

声明文件 (.d.ts)

什么时候需要？

当使用没有内置类型的 JS 库时：

npm install lodash            # JS 库，无类型
npm install @types/lodash      # 社区维护的类型

自定义声明

// global.d.ts
declare const API_URL: string;

// 模块声明
declare module 'some-js-lib' {
  export function doSomething(x: string): number;
}

// CSS Modules
declare module '*.module.css' {
  const classes: Record<string, string>;
  export default classes;
}

// 图片
declare module '*.png' {
  const src: string;
  export default src;
}

DefinitelyTyped (@types/*) 有 8000+ 个库的类型定义。