目录

简介

文件类型

类型声明文件使用


简介

我们发现今天所有的JS应用都会引入许多第三方库来完成任务需求。这些第三方库无论是否是TS编写的最终都会编译成JS代码给开发者使用。我们知道TS提供了类型才有了代码提示和类型保护机制,但我们引入的第三方库都会有相应的TS类型。这些类型就是 “类型声明文件为已存在的JS库提供类型信息

文件类型

TS中有两种文件类型:.ts文件.d.ts文件

.ts文件:既包含类型信息又可执行代码,可以被编译为 .js 文件,然后执行代码。是编写程序代码的文件。

.d.ts文件:只包含类型信息的类型声明文件,不会生成 .js 文件,仅用于提供类型信息。是为JS提供类型信息的文件。

类型声明文件使用

在使用TS开发项目时,类型声明文件的使用包括以下两种方式:

使用已有的类型声明文件

内置类型声明文件:TS为JS运行时可用的所有标准化内置API都提供了声明文件。例如在使用数组时,数组所有方法都会有相应的代码提示以及类型信息:

第三方库的类型声明文件:目前几乎所有常用的第三方库都有相应的类型声明文件。第三方库的类型声明文件有以下两种存在形式:

库自带类型声明文件:例如npm 下载的 axios ,正常导入该库,TS就会自动加载库自己的类型声明文件,以提供该库的类型声明。

由DefinitelyTyped提供:

DefinitelyTyped是一个github仓库,用来提供高质量的TS类型声明,可以通过 npm/yarm 来下载该仓库提供的TS类型声明包,这些包的名称格式为:@types/*。比如 @type/react、@type/lodash等。注意:在实际项目开发中,如果你使用的第三方库没有自带的声明文件,VScode会给出明确的提示。当安装 @type/* 类型声明包后,TS也会自动加载该类声明包,以提供该库的类型声明。

创建自己的类型声明文件

项目内共享类型:如果多个 .ts文件中都用到同一个类型,此时可以创建 .d.ts文件提供该类型,实现类型共享。

为已有的JS文件提供类型声明:这种方式有两种情况,一种是在将 JS 项目迁移到 TS 项目时,为了让已有的 .js文件有类型声明;另一种是成为库作者,创建库给其他人使用。

在TS项目中也可以使用.js文件,在导入.js文件时TS会自动加载与.js同名的.d.ts文件,以提供类型声明。declare关键字:用于类型声明,为.js文件已存在的变量声明类型,而不是创建一个新的变量。而对于type、interface等这些明确就是TS类型,可以省略declare关键字。

更多推荐