纯TypeScript开发Web前端（二）如何引入JS库

背景

总所周知，TS需要编译成JS才能在浏览器上跑，TS也能够调用JS的方法。但是，有一个现成的第三方JS类库摆在面前，让它如何能在TS中使用，很多刚入坑的朋友往往不得其门而入。下面我就讲讲我的办法吧。

1、直接翻译

看了上面4个字，大家可能不会不约而同地眉头一皱，立刻开喷：“喔靠，馊主意！”。我承认，这的确是个笨办法，但是我的确这么做过。笨办法也是办法，重剑无锋，大巧不工。
对于一些JS库只有不到200-300行代码，直接翻译成TS又何妨呢？自己用TS重写，跟找typings（很多不一定能找到）或者自己写*.d.ts的时间其实差不了多少。自己动手，也能加深对库的理解，夯实自己。

2、页面引入 + 全局定义

如果对第一条不满意，不用着急，咱还有别的办法。第二招，其实也很简单粗暴。所谓“页面引入”就是最常规的用<script>标签把js直接在html页面引入，然后“全局定义”，就是声明一个变量跟JS的全局变量名或者方法名一样。
下面用大家非常熟悉的jQuery举例吧。

页面里直接用<script>标签引入jquery.js

<html>
  <head>
    <script type="text/javascript" src="js/jquery.min.js"></script>
  </head>
  <body>
......

TS中声明全局变量$，然后就可以直接开撸

declare var $;
class App {
  init(){
    $("#msg").html("jquery引用成功!");
  }
}

简单粗暴的副作用就是不够优雅，声明的全局变量$的类型只能是any，这意味着还是弱类型变量，因此IDE中没有任何的方法和属性还有类型的提示。因而，完全失去了写TS的乐趣。下面重点说说怎样做到优雅。

3、类型定义文件（.d.ts）

相信阁下如果看本文之前百度过，肯定看过这种方法。说明，这是主流。所以，我也准备重点详细地介绍一下。

首先，什么是类型定义文件？

应该有点类似于C++后缀名为.h的头文件，用于声明JS主文件的函数接口和变量类型的定义，并且把这些定义暴露给TS使用。有了.d.ts的定义之后，TS就能感知到JS库相关的代码提示了。

接着，如何得到.d.ts文件？
1.可以先去DefinitelyTyped找找碰碰运气，一般很流行的库也许会有。
2.用npm的typings查找获取的，其实跟上面没什么两样。
3.网上还能还有一些工具，据说根据js库能够反向生成.d.ts。我试了都不靠谱，如果是C#生成.d.ts的成功率我是敢打包票，但是对JS我就只能呵呵了。
4.最后，“拿来主义”都不行的情况下，只有自己动手丰衣足食了。

自己做.d.ts之前，先分析一下js库的代码，看看自己需要什么接口就定义什么。那些自己用不着的大可放过。
例如，我早前做的marked.js，节选一些代码：

marked.options =
marked.setOptions = function(opt) {
  merge(marked.defaults, opt);
  return marked;
};

marked.getDefaults = function () {
  return {
    baseUrl: null,
    breaks: false,
    gfm: true,
    headerIds: true,
    headerPrefix: '',
    highlight: null,
    langPrefix: 'language-',
    mangle: true,
    pedantic: false,
    renderer: new Renderer(),
    sanitize: false,
    sanitizer: null,
    silent: false,
    smartLists: false,
    smartypants: false,
    tables: true,
    xhtml: false
  };
};

marked.defaults = marked.getDefaults();

/**
 * Expose
 */
marked.Parser = Parser;
marked.parser = Parser.parse;

marked.Renderer = Renderer;
marked.TextRenderer = TextRenderer;

marked.Lexer = Lexer;
marked.lexer = Lexer.lex;

marked.InlineLexer = InlineLexer;
marked.inlineLexer = InlineLexer.output;

marked.Slugger = Slugger;

marked.parse = marked;

这一段，很直观地看出它有什么接口可以暴露出来了。其实，我只需要一个parse的方法足矣。那么，我的marked.d.ts就会这么写。

interface MDOption {
    baseUrl?: string;
    breaks?: boolean;
    gfm?: boolean;
    headerIds?: boolean;
    headerPrefix?: string;
    highlight?: any;
    langPrefix?: string;
    mangle?: boolean;
    pedantic?: boolean;
    sanitize?: boolean;
    sanitizer?: any;
    silent?: boolean;
    smartLists?: boolean;
    smartypants?: boolean;
    tables?: boolean;
    xhtml?: boolean;
}

interface MarkDown {
    parse(src: string, opt?: MDOption, callback?: Function);
}

declare module "marked" {
    export = marked;
}
declare var marked: MarkDown;

方法定义只有MarkDown.parse一个，外加一个MDOption的结构定义。这样，我在TS调用就能用得很舒服了！至于，最后几行的declare为什么那么写？那是TS语法的套路，我这里就不多做解释，能用就行。好奇宝宝们可以进入传送门深入理解一下。

最后说一下，.d.ts怎么使用。直接上代码：

///<reference path="../typings/marked.d.ts" />
import * as marked from "marked";
var md_html = marked.parse("### Hello TypeScript");

1.引用路径
2.引入模块
3.使用方法
很简单的三行代码

至于，主体库mark.js怎么引入页面，方法很多，八仙过海各显神通。我用的是require.js。

require.config({
    paths: {
        'jquery': '//g.alicdn.com/sj/lib/jquery/dist/jquery.min',
        'marked': '/js/lib/marked.min'
    }
});

OK，讲完，收工。