JavaScript 如果要替名称加上命名空间,不外乎就是利用对象或是模块来达成。但在 TypeScript 中,有 namespace 关键字可以让我们快速地添加命名空间来用。
namespace 关键字的用法很简单,如下:
namespace 命名空间的名称(可以用句号连接多个名称) {
程序叙述区块
}
若要将 namespace 程序区块中的名称暴露出来,与模块一样,是在 var、let、const、function、class、interface、enum、type 关键字前加上 export 关键字。当然,namespace 程序区块中也还可以再使用 namespace 关键字来创建程序叙述区块,且 namespace 关键字前也是可以加上 export 关键字来将其暴露的。
例如:
namespace org.magiclen {
export namespace A {
export function f() {
console.log("A");
}
}
export namespace B {
export function f() {
console.log("B");
}
}
export namespace AB {
export function f() {
A.f();
B.f();
}
}
}
org.magiclen.A.f();
org.magiclen.B.f();
org.magiclen.AB.f();
以上程序的输出结果如下:
B
A
B
扩充命名空间
我们可以创建出相同名称的 namespace 程序叙述区块,替已存在的命名空间扩充原本不存在的名称。
例如:
namespace org.magiclen {
export namespace A {
export function f() {
console.log("A");
}
}
export namespace A {
export function f2() {
console.log("A");
}
}
export namespace B {
export function f() {
console.log("B");
}
}
export namespace AB {
export function f() {
A.f();
B.f();
}
}
}
namespace org.magiclen.A {
export function ff() {
console.log("AA");
}
}
namespace org.magiclen {
export function f() {
console.log("Hello!");
}
}
org.magiclen.A.f();
org.magiclen.B.f();
org.magiclen.AB.f();
org.magiclen.A.ff();
org.magiclen.f();
命名空间除了可以拿来扩充同名的命名空间之外,也可以拿来扩充同名的函数、类别、界面、枚举和类型别名下的名称。有点诡异,但十分方便。例如:
type T = number | string;
namespace T {
export const n = 1;
}
console.log(T.n);
function f() {
}
namespace f {
export const s = "2";
}
console.log(f.s);
命名空间的网页应用
实际编译以下 TypeScript 程序:
namespace A {
export function f() {
console.log("A");
}
}
会得到这样的 JavaScript 程序:
var A;
(function (A) {
function f() {
console.log('A');
}
A.f = f;
})(A || (A = {}));
A 命名空间实际上在 JavaScript 中会是一个变量 A。也就是说,利用这样的性质,我们可以很容易地在网页浏览器上透过命名空间产生的变量,来访问这个变量下的名称。
举例来说,现在有以下两个文件:
namespace A {
export function f() {
console.log("A");
}
}
namespace B {
export function f() {
console.log("B");
}
}
以上两个文件虽然都不是 TypeScript 模块(因为最外层并没有使用 export 关键字),但是它们的 f 函数在网页中并不会有冲突,可以透过全域变量 A 和 B 来调用它们。如下:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<script src="a.js"></script>
<script src="b.js"></script>
</head>
<body>
<script>
A.f();
B.f();
</script>
</body>
</html>
总结
至此我们已经把 TypeScript 能够声明的名称类型(变量、常数、函数、类别、界面、枚举、类型别名、模块、命名空间)都学全了。只是有些名称可以当作类型,有些名称可以当作值,有些名称又可以当作命名空间来用,实在很混乱。在此用以下表格做个归纳:
| 名称类型 | 命名空间 | 类型 | 值 | 例子 |
|---|---|---|---|---|
var |
否 | 否 | 是 |
var name = "MagicLen";
console.log(name);
|
let |
否 | 否 | 是 |
let name = "MagicLen";
console.log(name);
|
const |
否 | 否 | 是 |
const name = "MagicLen";
console.log(name);
|
function |
否 | 否 | 是 |
function f() {}
console.log(f);
|
class |
否 | 是 | 是 |
class C {}
console.log(C);
let o: C = new C();
|
interface |
否 | 是 | 否 |
interface I {}
class C implements I {}
let o: I = new C();
|
enum |
否 | 是 | 是 |
enum E { // it can not be a const enum
V
}
console.log(E);
let o: E = E.V;
|
type |
否 | 是 | 否 |
type I = {};
let o: I;
|
import |
是 | 否 | 是 |
import * as fs from "node:fs";
console.log(fs);
|
namespace |
是 | 否 | 是 |
namespace NS {
export function f() {}
}
NS.f();
|
在下一个章节中,我们要来学习 TypeScript 的装饰器(Decorator)。
下一章:装饰器(Decorator)。
