3-2 使用 TypeScript 语言
认识 TypeScript
TypeScript 是 JavaScript 的一个超集,主要提供了类型检查系统和对 ES6 语法的支持,但不支持新的 API。 目前没有任何环境支持运行原生的 TypeScript 代码,必须通过构建把它转换成 JavaScript 代码后才能运行。
想深入学习 TypeScript,推荐《Learning TypeScript中文版》:
改造下前面用过的例子 Hello,Webpack
,用 TypeScript 重写 JavaScript。由于 TypeScript 是 JavaScript 的超集,直接把后缀 .js
改成 .ts
是可以的。 但为了体现出 TypeScript 的不同,我们重写 JavaScript 代码为如下,加入类型检查:
// show.ts
// 操作 DOM 元素,把 content 显示到网页上
// 通过 ES6 模块规范导出 show 函数
// 给 show 函数增加类型检查
export function show(content: string) {
window.document.getElementById('app').innerText = 'Hello,' + content;
}
// main.ts
// 通过 ES6 模块规范导入 show 函数
import {show} from './show';
// 执行 show 函数
show('Webpack');
TypeScript 官方提供了能把 TypeScript 转换成 JavaScript 的编译器。 你需要在当前项目根目录下新建一个用于配置编译选项的 tsconfig.json
文件,编译器默认会读取和使用这个文件,配置文件内容大致如下:
{
"compilerOptions": {
"module": "commonjs", // 编译出的代码采用的模块规范
"target": "es5", // 编译出的代码采用 ES 的哪个版本
"sourceMap": true // 输出 Source Map 方便调试
},
"exclude": [ // 不编译这些目录里的文件
"node_modules"
]
}
通过 npm install -g typescript
安装编译器到全局后,你可以通过 tsc hello.ts
命令编译出 hello.js
和 hello.js.map
文件。
减少代码冗余
TypeScript 编译其会有和在 3-1 使用ES6语言中 Babel 一样的问题:在把 ES6 语法转换成 ES5 语法时需要注入辅助函数, 为了不让同样的辅助函数重复的出现在多个文件中,可以开启 TypeScript 编译器的 importHelpers
选项,修改 tsconfig.json
文件如下:
{
"compilerOptions": {
"importHelpers": true
}
}
该选项的原理和 Babel 中介绍的 babel-plugin-transform-runtime
非常类似,会把辅助函数换成如下导入语句:
var _tslib = require('tslib');
_tslib._extend(target);
这会导致编译出的代码依赖 tslib
这个迷你库,但避免了代码冗余。
集成 Webpack
要让 Webpack 支持 TypeScript,需要解决以下2个问题:
- 通过 Loader 把 TypeScript 转换成 JavaScript。
- Webpack 在寻找模块对应的文件时需要尝试
ts
后缀。
对于问题1,社区已经出现了几个可用的 Loader,推荐速度更快的 awesome-typescript-loader。 对于问题2,根据2-4 Resolve 中的 extensions 我们需要修改默认的 resolve.extensions
配置项。
综上,相关 Webpack 配置如下:
const path = require('path');
module.exports = {
// 执行入口文件
entry: './main',
output: {
filename: 'bundle.js',
path: path.resolve(__dirname, './dist'),
},
resolve: {
// 先尝试 ts 后缀的 TypeScript 源码文件
extensions: ['.ts', '.js']
},
module: {
rules: [
{
test: /\.ts$/,
loader: 'awesome-typescript-loader'
}
]
},
devtool: 'source-map',// 输出 Source Map 方便在浏览器里调试 TypeScript 代码
};
在运行构建前需要安装上面用到的依赖:
npm i -D typescript awesome-typescript-loader
安装成功后重新执行构建,你将会在 dist
目录看到输出的 JavaScript 文件 bundle.js
,和对应的 Source Map 文件 bundle.js.map
。 在浏览器里打开 index.html
页面后,来开发工具里可以看到和调试用 TypeScript 编写的源码。
本实例提供项目完整代码