如何使用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的模块加载器,可以直接在浏览器中运行。

    原文作者:王成
    原文地址: https://segmentfault.com/a/1190000005118886
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞