TypeScript/Angular2调用原生JS的桥接文件的编写

许多开发者在使用Angular2或者TypeScript开发的时候不可避免地要用到许多原生的JavaScript函数变量等,但是如何使用TypeScript调用已经封装好的JavaScript是许多开发者心中的疑惑。


如何使用TypeScript调用JavaScript呢?


流行的第三方JavaScript库

使用Angular2开发的童鞋可能会注意到,Angular2需要引用进来的许多的库文件中总会有.d.ts后缀名的文件,这个文件就是一个TypeScript调用JavaScript的桥接文件,TypeScript需要通过这个文件来识别JavaScript中的内容。
对于许多流行的第三方JavaScript库,GitHub上已经有一个开源项目编译好了他们的.d.ts桥接文件,直接下载下来便可以直接使用了。
项目地址是:https://github.com/DefinitelyTyped/DefinitelyTyped


快速生成桥接文件

但是有些JavaScript是我们开发人员自己编写的,该如何调用呢?TypeScript有一个快速生成.d.ts桥接文件的方法。

  1. 将你要生成桥接文件的.js文件修改后缀名为.ts。因为TypeScript是JavaScript的超集,所以JavaScript代码完全可以在TypeScript的文件中执行(就像C++的文件能够跑C语言一样)。

  2. 首先确保你的电脑上已经安装了TypeScript,打开“终端”(Windows下是命令行),cd到你刚刚修改后缀名的文件所在的文件夹,运行命令:
    tsc --declaration 刚刚修改后缀名的文件名(包括后缀名)。
    例如:

    tsc --declaration myJavaScript.ts
    

之后便可以看到TypeScript自动生成的.d.ts的桥接文件了。
如果在生成过程中报错,建议将要生成的文件中的JavaScript代码中实现部分全部删掉,只保留接口即可,反正生成的.d.ts文件就是一个变量和函数等的桥接文件。


手动编写桥接文件

如果通过TypeScript自动生成的.d.ts桥接文件不合适怎么办?(很正常,我从来没生成正常过,因为我的JavaScript代码是封装到一个单例里面的,TypeScript不认识单例...)
这个时候就需要我们自己手动来编写.d.ts的桥接文件了。
TypeScript官方也给出了如何编写桥接文件:https://www.tslang.cn/docs/handbook/declaration-files/introduction.html

注:.d.ts文件放在TypeScript调用JavaScript中国年是桥接文件,放在单纯的TypeScript中便是TypeScript的声明文件)

TypeScript官方给的文档很不好理解(至少我看了半天的时间才搞明白)
下面我重点说一下应该如何编写.d.ts桥接文件(只适用于TypeScript和JavaScript桥接)。

桥接文件中分为模块,接口,类,函数,变量等。所有的最外层都需要关键字declare来声明。

模块 的桥接

模块在TypeScript可以为JavaScript中的单例,匿名函数,全局的对象,全局的库等包含多个属性多个接口方法的东西,具体在何种情况应该声明为模块还主要是看个人的喜好。模块中可以声明任何东西。
单纯的模块:

declare module myModule { ... }

模块的嵌套,在一个模块中声明另一个模块可以使用以下两种方式:

declare module aModule, bModule { ... }

等于

declare module aModule {
    module bModule {
        ...
    }
    ...
}
类 的桥接

所有声明在桥接文件中的类的名称需要和JavaScript中对应的类的名称保持一致。
单纯的类的声明:

declare class myClass { ... }

类的继承:

declare class mySubClass extends myClass { ... }

如何调用:

let tempClass = new mySubClass();

模块中的类:

declare module myModule {
    class myModuleClass { ... }
}
接口 的桥接

TypeScript单独的提供了一个接口的声明,接口类似于类,不过类是要new出来的,而接口是可以直接调用的,类似于全局的函数。
单纯的接口:

declare interface myInterface { ... }

模块中的接口:

declare module myModule {
    class myModuleClass { ... }

    interface myModuleInterface { ... }
}
变量 的桥接

全局变量
全局变量需要声明变量类型,变量的名称需要和JavaScript中对应的变量的名称一致。

declare var myVariable: string;

模块中的变量:

declare module myModule {
    var myModuleVariable: string;

    class myModuleClass { ... }

    interface myModuleInterface { ... }
}

类中的变量属性,变量属性的名称需要和JavaScript中对应的类的变量属性的名称一致。

declare class myClass {
    name: string;
    id  : number;
}

接口中的变量:

declare interface myInterface {
     myInterfaceVariable: string;
}
函数 的桥接

单纯的函数的声明,函数的名称需要和JavaScript中对应的函数的名称一致,参数数量也应该一致,参数名称可以不一样:

declare function myfunction(param: string): void;

模块中的方法,方法的名称需要和JavaScript中对应的模块的方法的名称一致,参数数量也应该一致,参数名称可以不一样:

declare module myModule {
    var myModuleVariable: string;

    class myModuleClass { ... }

    interface myModuleInterface { ... }

    function myModuleFunction(param: string): void;
}

接口中的方法:

declare interface myInterface {
     myInterfaceVariable: string;

     myInterfaceFunction(param: string): void;
}

回调函数的桥接注意:
因为TypeScript中this的作用域同JavaScript中this的作用域不同,TypeScript中默认对函数声明了this的作用域。
所以我们在调用回调函数的时候必须使用=>来调用回调函数:

callbackFunction((data) => {
    // 回调函数的内容
})
桥接文件的举例

这是我之前写过的一个自己的单例模式的JavaScript文件的桥接文件,仅作参考

JavaScript代码
tempJS.js:

function inherit(subClass, superClass) {
    function F() {};
    F.prototype = superClass.prototype;
    subClass.prototype = new F();
    subClass.prototype.constructor = subClass.constructor;
}

function User() {
    this.userID   = Number;
    this.userName = String;
    this.userICON = String;
    this.isFriend = Boolean;
}

function Member() {
    User.call(this);
    this.remarkName = String;
}
inherit(Member, User);

var TempModule = (function () {
    var instantiated;
    function init() {
        return { 
            userInfo:User;
            test: function (callback) { ... },
            login: function (loginName, password) { ... }
        };
    }
    return {
        shareTemp: function () {
            if (!instantiated) {
                instantiated = init();
            }
            return instantiated;
        }
    };
})();

对应的桥接文件
tempJS.d.ts:

declare class User {
    userID   : number;
    userName : string;
    userICON : string;
    isFriend : boolean;
}

declare class Member extends User {
    remarkName : string;
}

declare module TempModule {
    interface shareTemp {
        userInfo: User;

        test(callback:Function): void;
        login(loginName: string, password: string): void;
    }
}

调用的文件:

let tempUser = new User();
tempUser.userID = 1;
tempUser.userName = "Shmily";
TempModule.shareTemp.userInfo = tempUser;
TempModule.shareTemp.test((data) => {
    // 回调函数内容
});
TempModule.shareTemp.login(tempUser.userName, "1234");
如何调用呢?

老式的方法是在需要用到的地方写:

/// <reference path="你的.d.ts的文件路径" />

但是这样很麻烦。不过在Angular2项目中我们有了一个简单的方法,在项目中的tsconfig.json文件中这样写:

{  
    "compilerOptions": {
        "target": "es5",
        "module": "commonjs",
        "moduleResolution": "node",
        "sourceMap": true,
        "emitDecoratorMetadata": true,
        "experimentalDecorators": true,
        "lib": [ "es2015", "dom" ],
        "noImplicitAny": true,
        "suppressImplicitAnyIndexErrors": true,
        "types": ["./library/ArrowIM/ArrowIM.d.ts"]
}}

只需要在types中添加你想要引用的.d.ts文件,Angular2会在加载项目的时候自动去加载,这样就再也不用写那么多的///了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,657评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,662评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,143评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,732评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,837评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,036评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,126评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,868评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,315评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,641评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,773评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,470评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,126评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,859评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,095评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,584评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,676评论 2 351

推荐阅读更多精彩内容