【黑马程序员】5、TypeScript类型声明文件_黑马程序员前端TypeScript教程,TypeScript零基础入门到实战全套教程

【黑马程序员】5、TypeScript类型声明文件_黑马程序员前端TypeScript教程,TypeScript零基础入门到实战全套教程

课程地址:【黑马程序员前端TypeScript教程,TypeScript零基础入门到实战全套教程】 https://www.bilibili.***/video/BV14Z4y1u7pi/?share_source=copy_web&vd_source=b1cb921b73fe3808550eaf2224d1c155

目录

5、TypeScript类型声明文件

5.1 TS中的两种文件类型

5.2 类型声明文件的使用说明

5.2.1 使用已有的类型声明文件

1 内置类型声明文件

2 第三方库的类型声明文件

1. 库自带类型声明文件

2. 由 DefinitelyTyped 提供

5.2.2 创建自己的类型声明文件

1. 项目内共享类型

2 为已有JS文件提供类型声明

6 在React中使用TypeScript


5、TypeScript类型声明文件

为什么要使用类型声明文件,及其作用。

今天几乎所有的 JavaScript 应用都会引入许多第三方库来完成任务需求。

这些第三方库不管是用 TS 编写的,还是用JS编写的,最终都要编译成 JS 代码,才能发布给开发者使用。

我们知道是 TS 提供了类型,才有了代码提示和类型保护等机制。

但在项目开发中使用第三方库(JS代码)时,你会发现它们几乎都有相应的 TS 类型,这些类型是怎么来的呢?类型声明文件

类型声明文件:用来为已存在的 JS 库提供类型信息

即便第三方库最终被编译为JS代码,只要有类型声明文件,那么第三方库就有相应的类型,也会有代码提示和类型保护等机制了。

这样在 TS 项目中使用这些最终被编译为JS的库时,就像用 TS 一样,都会有代码提示、类型保护等机制了。

(这里有个axios例子。)

1. TS 的两种文件类型

2. 类型声明文件的使用说明

5.1 TS中的两种文件类型

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

  •  .ts 文件:
    • 1. 既包含类型信息又可执行代码
    • 2. 可以被编译为 .js 文件,然后,执行代码。
      • ts文件被编译为js文件后,大部分的类型信息会消失。
    • 3. 用途:编写程序代码的地方。
  • .d.ts 文件:类型声明文件
    • 1. 只包含类型信息的类型声明文件。
    • 2. 不会生成 .js 文件,仅用于提供类型信息。
    • 3. 用途:为 JS 提供类型信息。
      • 不包含具体的功能代码。

第一点对比:类型说明文件的说明:

① 没有问题,因为Props是类型。

②:错误演示, 不能有可执行代码,这里提示“不允许在环境上下文中使用语句”。

即,类型声明文件,只能提供类型,不能提供具体的代码实现。

总结:.ts 是 implementation(代码实现文件);.d.ts 是 declaration(类型声明文件)

如果要为 JS 库提供类型信息,要使用 .d.ts 文件。

5.2 类型声明文件的使用说明

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

1. 使用已有的类型声明文件

2. 创建自己的类型声明文件

学习顺序:先会用(别人的)再会写(自己的)。

5.2.1 使用已有的类型声明文件

l 使用已有的类型声明文件:1 内置类型声明文件 2 第三方库的类型声明文件。

1 内置类型声明文件

1. 内置类型声明文件:TS 为 JS 运行时可用的所有标准化内置 API (比如数组、日期等)都提供了声明文件

比如,在使用数组时,数组所有方法都会有相应的代码提示以及类型信息:

实际上这都是 TS 提供的内置类型声明文件。

可以通过 Ctrl + 鼠标左键(Mac:option + 鼠标左键)来查看内置类型声明文件内容。

比如,查看 forEach 方法的类型声明,在 VSCode 中会自动跳转到 lib.es5.d.ts 类型声明文件中。 当然,像 window、document 等 BOM、DOM API 也都有相应的类型声明(lib.dom.d.ts)。

2 第三方库的类型声明文件

2. 第三方库的类型声明文件:目前,几乎所有常用的第三方库都有相应的类型声明文件

第三方库的类型声明文件有两种存在形式:1 库自带类型声明文件 2 由 DefinitelyTyped 提供

1. 库自带类型声明文件

库自带类型声明文件

比如,axios

解释:这种情况下,正常导入该库,TS 就会自动加载库自己的类型声明文件,以提供该库的类型声明。

2. 由 DefinitelyTyped 提供

DefinitelyTyped 是一个 github 仓库,用来提供高质量 TypeScript 类型声明

几乎包含了所有常用的第三方库的类型声明文件

在types里。

可以通过 npm/yarn 来下载该仓库提供的 TS 类型声明包,这些包的名称格式为:@types/*。 比如,@types/react、@types/lodash 等。

说明:在实际项目开发时,如果你使用的第三方库没有自带的声明文件,VSCode 会给出明确的提示。比如这里,安装了lodash第三方库,但是没有安装该库的类型声明文件。

解释:当安装 @types/* 类型声明包后,TS 也会自动加载该类声明包,以提供该库的类型声明。

补充:TS 官方文档提供了一个页面,可以来查询 @types/* 库,和文件下载命令。

5.2.2 创建自己的类型声明文件

创建自己的类型声明文件:1 项目内共享类型 2 为已有 JS 文件提供类型声明

1. 项目内共享类型

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

操作步骤:

1. 创建 index.d.ts 类型声明文件。

2. 创建需要共享的类型,并使用 export 导出(TS 中的类型也可以使用es6的 import/export 实现模块化功能)。

3. 在需要使用共享类型的 .ts 文件中,通过 import 导入即可(.d.ts 后缀导入时,直接省略)

p73,3:00介绍了一个例子。

2 为已有JS文件提供类型声明

创建自己的类型声明文件:1 项目内共享类型 2 为已有 JS 文件提供类型声明。

2. 为已有 JS 文件提供类型声明:

        情况1. 在将 JS 项目迁移到 TS 项目时,为了让已有的 .js 文件有类型声明。

                且将来新的功能都用ts开发,那新的功能里会用到原来写好的js的,为了让ts中使用js内容时也有代码提示等功能,就需要为原来的js文件编写类型声明文件。

        情况2. 成为库作者,创建库给其他人使用。

为了让其他人在ts中引用自己的项目时,也有类型提示和保护机制,此时就需要为自己写的库的js文件提供类型声明文件。

注意:类型声明文件的编写与模块化方式相关,不同的模块化方式有不同的写法。但由于历史原因,JS 模块化的发展 经历过多种变化(AMD、***monJS、UMD、ESModule 等),而 TS 支持各种模块化形式的类型声明。这就导致 ,类型声明文件相关内容又多又杂。

演示:基于最新的 ESModule(import/export)来为已有 .js 文件,创建类型声明文件。

开发环境准备:使用 webpack 搭建,通过 ts-loader 处理 .ts 文件。

在webpack.config.js文件里进行配置,通过 ts-loader 处理ts文件。

项目代码演示。

说明:TS 项目中也可以使用 .js 文件。

TS项目可以使用js文件。ts文件可以使用js内容。

说明:在导入 .js 文件时,TS 会自动加载与 .js 同名的 .d.ts 文件,以提供类型声明。

declare 关键字:用于类型声明,为其他地方(比如,.js 文件)已存在的变量声明类型,而不是创建一个新的变量。

        1. 对于 type、interface 等这些明确就是 TS 类型的(只能在 TS 中使用的),可以省略 declare 关键字

        2. 对于 let、function 等具有双重含义(在 JS、TS 中都能用),应该使用 declare 关键字,明确指定此处用于类型声明

p75 8:00左右,开始讲例子。

6 在React中使用TypeScript

这个不看了,可以看看有没有在Vue中使用TS的视频。

转载请说明出处内容投诉
CSS教程_站长资源网 » 【黑马程序员】5、TypeScript类型声明文件_黑马程序员前端TypeScript教程,TypeScript零基础入门到实战全套教程

发表评论

欢迎 访客 发表评论

一个令你着迷的主题!

查看演示 官网购买