TypeScript躬行记——命名空间

Posted strick

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了TypeScript躬行记——命名空间相关的知识,希望对你有一定的参考价值。

  TypeScript中的命名空间可将那些具有内在联系的接口、类或对象等代码组织在一起,既能隔离作用域,也能避免命名冲突,并且使得代码结构清晰,更易追踪。在命名空间内部,所有实体部分默认都是私有的,需要由export关键字导出之后,才能在外部访问,如下所示。

namespace Util {
  export function log(msg) {
    console.log(msg);
  }
}
Util.log("strick");

  TypeScript会将上面的命名空间编译成两部分:Util变量和即时函数,如下代码所示,这是一种常见的模块化封装。

var Util;
(function(Util) {
  function log(msg) {
    console.log(msg);
  }
  Util.log = log;
})(Util || (Util = {}));
Util.log("strick");

  注意,由于TypeScript 1.5为了与ES6的术语保持一致,已将内部模块改为命名空间,外部模块简称为模块,因此原先用于内部模块的module关键字和现在的namespace关键字在功能上是一样的。但是为了避免被ES6、CommonJS、UMD等模块概念中的相似名称所迷惑,官方推荐使用namespace。

一、分离

  当命名空间膨胀的过大时,为了便于维护,有必要将其分离到各个文件中。例如将命名空间分到三个文件中,第一个util.ts文件的代码如下。

namespace Util {
  export function log(msg) {
    console.log(msg);
  }
}

  第二个validator.ts文件的代码如下。

namespace Validator {
  export function isAcceptable(str) {
    return str.length > 1;
  }
}

  第三个default.ts文件的代码如下所示,其中三斜线指令用来通知编译器在编译时需要引入的外部文件,并且它必须声明在文件顶部。

/// <reference path="util.ts" />
/// <reference path="validator.ts" />
let str = "abc";
if(Validator.isAcceptable(str)) {
  Util.log("success");
}

  当需要处理多个包含命名空间的文件时,有两种方式可确保编译后的代码按正确顺序加载。第一种是在输入编译命令时添加--outFile参数,如下所示,其后会跟一个输出的脚本文件以及一个或多个要编译的文件。

tsc --outFile default.js default.ts

  第二种是将编译后的脚本通过html的<script>元素在页面中按正确的顺序引入,如下所示。

<script src="util.js"></script>
<script src="validator.js"></script>
<script src="default.js"></script>

 

二、别名

  命名空间支持嵌套,即在内部声明另一个命名空间,如下所示。

namespace Shape {
  export namespace Polygon {
    export class Triangle { }
    export class Square { }
  }
}

  当引用这类命名空间时,可以通过import关键字为其取一个短的别名,如下代码所示。注意,不要与加载模块的import语法相混淆,此处import的右侧必须包含命名空间。

import P = Shape.Polygon;
import Triangle = Shape.Polygon.Triangle;
let sq = new P.Square();
let triangle = new Triangle();

  通过编译后的代码可以发现,由于import是var的语法糖(如下代码所示),因此改变P或Triangle变量的值不会影响命名空间的引用。

var P = Shape.Polygon;
var Triangle = Shape.Polygon.Triangle;
var sq = new P.Square();
var triangle = new Triangle();

 

以上是关于TypeScript躬行记——命名空间的主要内容,如果未能解决你的问题,请参考以下文章

TypeScript躬行记——类

ES6躬行记——代码模块化

React躬行记(16)——React源码分析

ES6躬行记(17)——Map

Vue躬行记——数据绑定

React躬行记——表单