『TypeScript』如何对 JS 进行类型检查

August 31,2019
0
TypeScript、JavaScript

JavaScript 是一门动态类型语言,我们在编写代码时,一不注意漏掉一个问题可能会导致生产环境出现大问题,例如忽略某个函数的参数或返回值类型。在越大的工程中,越健壮的代码显得尤为重要,那么如何借助 VSCode 和 TS 写出更加健壮且易读的代码呢?

使用 VSCode 和 WebStorm 等

VSCode 和 WebStorm 属于现代编程工具,它们对 JS 的类型提供了更好的支持,比如类型检查和类型推导,在编写代码阶段就可以避免很多不必要的错误。

JSDoc

JSDoc 其实就是类似于 JavaDoc 的一种注释性文档,借助开发工具可以对 JS 的变量进行类型检查,而且也可以生成 HTML 文档方便阅读。

/**
 * add
 * @param {String} x
 * @param {String} y
 * @returns {String}
 */
function add(x, y) {
  return x + y
}

@param 可以指定参数的类型,@returns 则可以指定函数的返回值类型。如果使用 VSCode 等工具,在调用时会进行类型检查,如果参数类型不匹配的话,则会出现错误提示。

JSDoc 支持很多 @ 关键词,可以参考文档。它甚至可以支持自定义类型,但是写法比较繁琐,如果用在大型项目中的话,维护这些注释的话,得不偿失。

TypeScript 声明文件

TS 声明文件有几种生成方式:

  • tsconfig.json 中配置 declaration
  • 安装已有声明文件,例如 yarn add -D @types/lodash
  • 手动编写声明文件,TS 有提供一些模板

商业转载请联系站长获得授权,非商业转载请注明本文出处及文章链接,您可以自由地在任何媒体以任何形式复制和分发作品,也可以修改和创作,但是分发衍生作品时必须采用相同的许可协议。
本文采用 CC BY-NC-SA 4.0 - 非商业性使用 - 相同方式共享 4.0 国际进行许可。