如何使用TypeScript和Webpack编写网页应用

TypeScript所做的，是在JavaScript的基础上加入了类型，TypeScript编译器将TypeScript编译成JavaScript，可以在浏览器或者nodejs平台上运行。最新版本的TypeScript语法根ES6标准已经十分接近，而且因为是JS的超集，TS代码中夹杂普通JS代码也是可以的。所以，如果你也考虑开始使用Bable＋ES6，不妨也看一下TypeScript。

TypeScript项目和tsconfig.json

首先安装TypeScript编译器

npm i -g typescript

进入项目目录，新建一个hello.ts

function sayHello(name: string) {
    return 'Hello, ' + name;
}

let myName = 'Cheng Wang';

console.log(sayHello(myName));

然后执行

tsc hello.ts

编译器会生成 hello.js

function sayHello(name) {
    return 'Hello, ' + name;
}
var myName = 'Cheng Wang';
console.log(sayHello(myName));

为了方便编译器和编辑器识别TypeScript项目，TypeScript约定了tsconfig.json文件来存储项目配置，如果运行tsc时不指定输入文件，编译器则会查找项目目录中的这个文件，如果找不到则会依次向父级目录查找。比如这样：

{
    "compilerOptions": {
        "outFile": "dist/app.js",
        "sourceMap": true
    },
    "files": [
        "src/app.ts"
    ]
}

直接运行tsc，会自动把src/app.ts编译到dist/app.js。

关于这个配置文件的更多选项，可以看官方文档。

使用模块

TypeScript中，模块的使用方法与ES6一致。

src/modules/utilities.ts：

function getUrlParam(key: string) {

  const REG_PATTERN = new RegExp('(^|&)' + key + '=([^&]*)(&|$)', 'i');
  let result: string[] = location.search.substr(1).match(REG_PATTERN);

  if (result !== null) {
    return decodeURIComponent(result[2]);
  } else {
    return null;
  }

}

export { getUrlParam }

src/app.ts：

import { getUrlParam } from './modules/utilities';

let deviceType: string = getUrlParam('deviceType');

console.log(deviceType);

编译后的app.js（TypeScript编译器在输出单个文件时，只能使用AMD或System模块规范）：

define("modules/utilities", ["require", "exports"], function (require, exports) {
    "use strict";
    function getUrlParam(key) {
        var REG_PATTERN = new RegExp('(^|&)' + key + '=([^&]*)(&|$)', 'i');
        var result = location.search.substr(1).match(REG_PATTERN);
        if (result !== null) {
            return decodeURIComponent(result[2]);
        }
        else {
            return null;
        }
    }
    exports.getUrlParam = getUrlParam;
});
define("app", ["require", "exports", "modules/utilities"], function (require, exports, utilities_1) {
    "use strict";
    var deviceType = utilities_1.getUrlParam('deviceType');
    console.log(deviceType);
});

使用NPM库

我们开发JS程序的时候，要用到NPM上的第三方的库，比如jQuery、Lodash等，但是绝大多数库都是用JS写的，没有类型提示，我们也不能在在代码中将这些库作为模块引入。

比如我们需要在项目中使用Lodash：

npm i --save lodash

然后在代码中引入：

import * as _ from 'lodash';

console.log(_.camelCase('helloworld'))

运行 tsc 则报错：

src/app.ts(1,20): error TS2307: Cannot find module 'lodash'.

如果想在TypeScript代码中直接使用npm上的JS库，需要借助Typings这个工具。

Typings也是一个包管理器，它管理的是JS代码“定义文件”，用Typings安装相应的定义文件后，编辑器和编译器就可以去node_modules目录中找到相应的JS库，并编译到最终的JS代码中。

先安装Typings工具：

npm i -g typings

然后安装Lodash的定义文件：

typings install --save lodash

Typings会去NPM、Bower上寻找库的作者加的定义文件，但是有的库如jQuery并没有官方的定义文件，则需要从社区维护的DefinitelyTyped目录下安装：

typings install --save --ambient jquery

然后再tsconfig.json中的files配置中加入一条：

"files": [
    "src/app.ts"，
    "typings/main.d.ts"
]

此时编译就不会提示找不到模块了。

安装好定义文件之后，如果使用Visual Studio Code等对TypeScript支持较好的编辑器，则会提供更加强大的代码提示功能。

使用Webpack构建

TypeScript编译器支持很多模块组织规范，如ES6、commonJS、AMD等，但是如果想要将多个ts文件打包成一个文件，TypeScript只支持AMD和System，对于浏览器应用来说，还需要引入第三方的模块加载器。如果使用Webpack配合TypeScript的loader，则可以方便地构建浏览器可以运行的JS代码。

首先安装Webpack和ts-loader：

npm i webpack -g

npm i ts-loader --save-dev

然后配置项目目录中的webpack.config.js:

module.exports = {

  entry: './src/app.ts',
  
  output: {
    filename: 'app.js',
    path: './dist'
  },
  
  resolve: {
    extensions: ['', '.webpack.js', '.web.js', '.ts', '.js']
  },
  
  module: {
    loaders: [
      { test: /\.ts$/, loader: 'ts-loader' }
    ]
  }
  
}

然后就可以通过运行webpack来构建了，构建生成的代码自带了webpack的模块加载器，可以直接在浏览器中运行。