gitbook/玩转Vue 3全家桶/docs/445880.md
2022-09-03 22:05:03 +08:00

17 KiB
Raw Blame History

14 | TypeScriptVue 3中如何使用TypeScript

你好,我是大圣。

在上一讲中我为你介绍了Vue中的JSX以及template和JSX各自的优缺点。就像在上一讲中我提到的template牺牲灵活性换来了静态标记的收益你能看到有些时候我们需要放弃一些灵活性去换取项目的整体收益。那么在这一讲中我会给你介绍一个可以在语言层面上提高代码可维护性和调试效率的强类型语言——TypeScript。

在整体上我们的课程还是以使用JavaScript为主。对于TypeScript的内容我会在这一讲中先带着你入门。下面我会先讲一下TypeScript的入门知识 然后作为巩固我会带你在Vue 3里再实战一下TypeScript最后我会对TypeScript和JavaScript这两者做一个对比分析让你明白如何在这两者之间做一个更好的平衡。

什么是TypeScript

TypeScript是微软开发的JavaScript的超集这里说的超集意思就是TypeScript在语法上完全包含JavaScript。TypeScript的主要作用是给JavaScript赋予强类型的语言环境。现在大部分的开源项目都是用TypeScript构建的并且Vue 3本身TS的覆盖率也超过了95%。

图片

下图展示了TypeScript和JavaScript的关系TypeScript相当于在JavaScript外面包裹了一层类型系统这样可以帮助我们开发更健壮的前端应用

接下来我们看一下TypeScript带来的新语法首先TypeScript可以在JavaScript的变量之上限定数据类型。你可以打开这个TypeScript官方的演示链接在线体验一下TypeScript的这种新语法。

上面TypeScript的官方演示链接我用截图的方式放到了下面。你可以看到TypeScript和JavaScript的区别在于TypeScript的变量后面有一个冒号用来设置好变量的数据类型courseName变量的值只能是字符串price只能是数字。

在第六行代码中我们给price赋值了字符串页面右边解析出来的JavaScript代码是没有任何问题的。但是我们点击右边的Errors时就会看到一个报错信息明确告诉你string类型的变量不能赋值给数字类型。

图片

这段演示代码算是TypeScript中最简单的Demo了你的脑子里肯定会提出一个问题在TypeScript中既然变量不能随便赋值那这会带来什么好处吗

我还是给你举个例子在你去极客时间官网购买课程的时候如果官网上对每个课程的类型都定义得非常详细那么在课程列表页面你就能知道《玩转Vue 3全家桶》这个课的受众、价格、难度等类型所以你在购买之前就可以很轻松地过滤不需要的课程。用TypeScript来描述的话就是下面的代码

interface 极客时间课程 {
    课程名字:string,
    价格:number[],
    受众:string,
    讲师头像?:string|boolean,
    获取口令():string
}

let vueCourse: 极客时间课程 = {
    课程名字:'玩转Vue 3全家桶',
    价格:[59,129],
    受众: '前端小老弟',
    讲师头像:false,
    获取口令(){
        return 88
    }
}

这就是TypeScript带来的好处如果项目中的每个变量、每个接口都能在定义的时候定义好类型那么很多错误在开发阶段就可以提前被TypeScript识别。在上面的代码中我们使用interface去定义一个复杂的类型接口也即极客时间课程。

这样,一个变量想要描述一个课程,就必须要按照这个格式去定义,也就是说:课程名必须是字符串、价格必须是一个数组,并且内部全部是数字、讲师头像可以是字符串或布尔这两个类型之一、获取口令必须是一个函数,并且返回一个字符串。

只要是不符合接口规定的类型的变量,就会直接在变量下方给出红色波浪线的报错提示。鼠标移到报错的变量那里,就会有提示信息弹出,直接通知你哪里出问题了。这也是为什么现在大部分前端开源项目都使用TypeScript构建的原因因为每个函数的参数、返回值的类型和属性都清晰可见这就可以极大地提高我们代码的可维护性和开发效率

图片

TypeScript能够智能地去报错和提示也是Vue 3的代码阅读起来比较顺畅的主要原因。点击这里的Vue 3源码链接如下图所示在这个源码文件内部的interface App中定义好了Vue实例所需要的所有方法后我们可以看到熟悉的use、component、mount等方法。并且每个方法的参数类型和返回值都已经定义好了阅读和调试代码的难度也降低了很多。

图片

接下来我来跟你聊一下TypeScript中的一些进阶用法。很多时候你看不懂开源库TypeScript的原因也是出在对这些进阶用法的生疏上。

首先要讲到的进阶用法是泛型泛型就是指有些函数的参数你在定义的时候是不确定的类型而返回值类型需要根据参数来确定。在下面的代码中我们想规定test函数的返回类型和参数传递类型保持一致这个时候就没有办法用number或者string预先定义好参数args的类型为了解决这一问题泛型机制就派上了用场。

我们在函数名的后面用尖括号包裹一个类型占位符,常见的写法是,这里为了帮助你理解,我用<某种类型>替代这种写法。调用方式可以直接使用test(1), 也可以使用test (1) 。泛型让我们拥有了根据输入的类型去实现函数的能力这里你也能感受到TypeScript类型可以进行动态设置。

function test<某种类型>(args:某种类型):某种类型{
    return args
}

接下来我再给你介绍一下TypeScript中泛型的使用方法。在下面的代码中我们实现一个函数getProperty它能够动态地返回对象的属性。函数的逻辑是很好实现的那怎么使用TypeScript限制getProperty的类型呢

getProperty(vueCourse '课程名字') // 返回 ['玩转Vue3全家桶']

因为getProperty的返回值是由输入类型决定的所以一定会用到泛型。但是返回值是vueCourse的一个value值那如何定义返回值的类型呢首先我们要学习的是keyof关键字下面代码中我们使用 type 课程属性列表 = keyof 极客时间课程 就可以根据获取到的极客时间课程这个对象的属性列表使用extends来限制属性只能从极客时间的课程里获取。

function getProperty<某种类型, 某种属性 extends keyof 某种类型>(o: 某种类型, name: 某种属性): 某种类型[某种属性] {
    return o[name]
}
function getProperty<T, K extends keyof T>(o: T, name: K): T[K] {
    return o[name]
}

对于上面给出的代码,你可以打开这个链接体验一下如果传递的name不是极客时间课程类型中的属性就会有报错提示。

图片

上面只是TypeScript最简单的应用关于TypeScript的更多类型的使用文档你可以在官网文档上找到很详细的教程和介绍。而且TypeScript的类型其实是可以编程的可以根据类型去组合推导新的类型甚至可以使用extends去实现递归类型。

在Vue源码中也有一些地方用到了递归类型可以书写更复杂的类型组合这一部分你可以自己去官网学习。到这里相信你应该大致能理解TypeScript给我们带来的好处了那如何在Vue 3中使用TypeScript呢这就是我们接下来要解决的问题。

Vue 3中的TypeScript

由于TypeScript中的每个变量都需要把类型定义好因而对代码书写的要求也会提高。Vue 2中全部属性都挂载在this之上而this可以说是一个黑盒子我们完全没办法预先知道this上会有什么数据这也是为什么Vue 2对TypeScript的支持一直不太好的原因

Vue 3全面拥抱Composition API之后没有了this这个黑盒对TypeScript的支持也比Vue2要好很多。在下面的代码中首先我们需要在script 标签上加一个配置 lang=“ts”来标记当前组件使用了TypeScript然后代码内部使用defineComponent定义组件即可。

<script lang="ts">
import { defineComponent } from 'vue'
export default defineComponent({
  // 已启用类型推断
})
</script>