美文网首页
JS 项目中类型系统的分级

JS 项目中类型系统的分级

作者: CondorHero | 来源:发表于2021-04-15 16:29 被阅读0次
JS 项目中类型系统的分级.png

前言: 经过入职以来的不断的努力,上周四我老大决定让项目迁移到 TS 了,可惜这周他家里有事没来,不过也是好事,我正好先学习着。

我们这个项目前期是外包写的(开发外包,维护正式员工,有没有感觉智商被侮辱),所以迁移项目成本有点大,一度让我有点想放弃的想法,但是周末看到一个震撼的新闻:

Carlos Rodrigues 用恐怖的战斗力,几天就把 Vue2 从 Flow 重构为 TS ,连尤大都被震惊了。我呢,也是受到了点鼓舞,人生就是生死看淡,不服就干。


正文开始:

我们知道 JS 是弱类型语言,TS 是强类型语言,在纯 JS 项目中肯定是不分类型系统等级的,因为它弱类型,分类型等级意义不大,之所以会有类型系统主要是因为,由 JS 到 TS 项目需要过渡给开发者过渡,所以出来了——类型系统的分级概念,不过说到底这个分级还是针对 TS 项目而言的,脱离 TS 项目空谈类型分级没有任何的意义

那怎么分呢?按类型的严格性分为五级,分别为:

  • 在 JS 文件中采用类型推论
  • 类型推论的基础上,采用 JSDoc
  • 通过 // @ts-check 注释来强制进行 TS 检查
  • 在 TS 文件里编码
  • 在 TS 中编码同时开启 strict 配置,使用最高级的规则检查

Note: 以下代码示例都是在 TS 项目中演示的,但是有的是在 TS 文件中,有的在 JS 文件中,如果你不想自己搭环境可以用官网的在线编辑器 Playground

一、类型推论级

这个最简单了:

// JS 文件中

let hi = "你好";

鼠标悬停在变量上,显示如下:

类型推论级

hi 变量自动推断为 string 类型。

二、JSDoc

JSDoc 用的是注释语法,说白了就是用注释来约束代码,如果你之前就有良好的代码注释习惯,就特别的容易看懂这个。

// JS 文件中
/** @type {number} */
var x;

x = 0; // OK

鼠标悬停在变量 x 上,会显示:

JSDoc 还支持好多参数 JSDoc Reference,这是学习注释的一个非常好机会,不要错过哟。

三、启用 TS 注释检查

JS 文件中的,类型推论和 JSDoc 其实并没啥大用,你还是想咋写就咋写的状态,没有任何的错误来提示你你不能这样干或那样干。

单纯来讲,类型推论和 JSDoc 是类型系统最低的两个等级,接下来我们往高等级进发——当类型不对,要有报错。

这时候我们在 JS 文件的顶层及第一行添加代码:

// @ts-check

这时候类型检查启动,报错出现。

启用 TS 类型检查之后,如果你发现某行报错不符合你的要求,或者你想忽略某行的报错,只需要在这行前面添加 // @ts-ignore// @ts-expect-error 注释,例如:

一般我们项目有很多的 JS 文件,一个一个的添加类型检查也太麻烦了,那么如何给所有的 JS 文件添加类型检查呢,很简单直接打开 jsconfig.json 文件,然后添加配置:

{
    "allowJs": true,
    "checkJs": true
}

这时候你又发现,某个文件报错太多,没时间或压根就不想去修复,那如何关闭这个文件的类型检查呢,也很简单,在 JS 文件第一行添加注释。

// @ts-nocheck

这样,这个文件的类型检查就没了。

四、TS 文件默认类型检查

没有开启 strict 的类型检查,为了和第五点对比在下面讲。

五、TS 文件开启最严格的类型检查

在 TS 文件中,类型检查还可具体分为:

  • 宽泛型
  • 严格型

到底采取哪种检查方式,这取决你 tsconfig.json 文件里的 strict 字段为真还是假,默认情况下 strict 是为 false 的。strict 为 true 还是 false 到底有什么影响呢?

目前来讲有下面几个影响:

  1. alwaysStrict

alwaysStrict 表示是否开启 JS/ES 的 strict,注意⚠️不是 TS 的 strict 哟

  1. strictNullChecks

strictNullChecks 表示 null 和 undefined 是否为单独的类型,默认情况 null 和 undefined 是任何类型的子类型。即:let age = 20;age = null;age = undefined; 不会报错。

  1. strictBindCallApply

strictBindCallApply 用来限制 call、bind 和 apply 绑定的函数的参数,简单来讲就是如果你关闭strictBindCallApply 的话,call、bind 和 apply 绑定的函数的参数即使进行了类型声明,也会自动转为 any 类型,失去了意义。

例如:

// 关闭 strictBindCallApply 参数 x 的类型声明没有意义,被强制指定为 any 
function fn(x: string) {
  return parseInt(x);
}

// Note: 没有报错
const n = fn.call(undefined, false);
  1. strictFunctionTypes

strictFunctionTypes 校验函数参数的正确性,感觉这个就不应该暴露出来给用户进行可配置,应该成为 TS 语法的一部分。

看,官网的例子,strictFunctionTypes 会检查当声明的参数类型和定义的参数类型的类型是否全部兼容。

function fn(x: string) {
  console.log("Hello, " + x.toLowerCase());
}

type StringOrNumberFunc = (ns: string | number) => void;

// Unsafe assignment
let func: StringOrNumberFunc = fn;
// Unsafe call - will crash
func(10);
  1. strictPropertyInitialization

strictPropertyInitialization 表示当类的属性被声明为除 undefined/unknow/any 类型之外的任意类型,例如 number ,而且没有在 constructor 里面初始化,就会报错提示。

  1. noImplicitAny

noImplicitAny 表示不许出现隐式的 any 类型。如果你没有明确声明变量的类型,而且 TS 也不能自动推断出来,TS 就会把这个变量的类型声明为 any,注意一旦出现 any 就没了类型检查,TS 也就失去了意义,所以 noImplicitAny 一定要启用,强制我们自己进行类型声明

例如,下面代码就不会报错:

let age;
age.lalalala()
  1. noImplicitThis

noImplicitThis 表示当 this 被隐式指定为 any 类型时报错。

例如:

function fun() {
    console.log(this)
}
fun()

注意⚠️:目前 TS4.2 版本 strict 版本就包含这七个,随着 TS 的升级还可能新增或删除。

相关文章

  • JS 项目中类型系统的分级

    前言: 经过入职以来的不断的努力,上周四我老大决定让项目迁移到 TS 了,可惜这周他家里有事没来,不过也是好事,我...

  • 「JS」类型系统

    标准类型原始类型(值类型)Undefined undefinedNull nullBoolean trueStri...

  • vue2.0项目配置flow类型检查

    在vue2.0的项目中加入flow类型检查。当前项目是用js写的,当项目越来越大,由于js弱类型的特性,相比ts(...

  • 关于类型声明文件 - 01理解

    配置项 allowJs 是否编译 .js 文件. 如果你的项目中有自定义的 .js 文件, 并且在 .ts 文件内...

  • 2018-12-24

    1,基于Vue.js、 iview实现的项目管理系统vue-projectManage: 基于Vue.js实现的项...

  • js浮点数运算财务系统精确计算

    [toc] 背景 项目中用到浮点数,Int 等 js中 Number类型比较多, 加上牵涉到财务软件, 前台js运...

  • MUI更新升级APP步骤

    集成更新功能到项目中的步骤: 拷贝update.js(更新工具类)、omsabout.js(系统帮助类)和upda...

  • 对一个数组filter、some、map、forEach的操作分

    js语言中,数组对象(即Array类型)是一种非常常用的类型,ECMAScript数组的每一项可以保存任何类型的数...

  • 媒体查询

    使用JS判断设备类型(判断设备使用iOS还是Android系统)的示例,代码如下:

  • vue cli - 2 升级到 3的问题汇总

    基于已有项目从cli 2项目升级到cli 3项目中,需要修改的几项 多页面 更改vue.config.js配置, ...

网友评论

      本文标题:JS 项目中类型系统的分级

      本文链接:https://www.haomeiwen.com/subject/sjgxlltx.html